文档中心 > ListParts
ListParts

最近更新时间:2021-12-24

使用ListParts接口列出所有正在进行的分片上传任务。

正在进行的分片上传任务是指那些已经启动,却没有放弃或完成的分片上传任务。

在一次响应中,此操作最多返回1000(默认值)个分片上传任务。用户可以使用max-uploads参数来限定最大值。

如果用户空间中正在进行的分片上传任务数大于此操作设定的最大值,响应中将会将IsTruncated元素设为true。用户可以使用key-marker和upload-id-marker参数来列出未列出的任务。


请求

请求语法

GET /?uploads HTTP/1.1

Host: examplebucket.region.unicloudsrv.com

Date: Date

Authorization: authorization string

请求参数

参数

描述

delimiter

分隔符,用于对一组参数进行分割的字符。

encoding-type

指明请求响应使用的编码方式。

max-uploads

限定要列出正在进行任务的最大值([1,1000])。响应中将会在响应体中返回其值。

upload-id-marker

与key-marker一起使用,指定列举指定空间中正在进行分片上传任务的起始位置。如果key-marker没有指定,此参数将被忽略。否则将只会列出upload ID比设定的大的任务。

key-marker

与upload-id-marker一起使用,指定列举指定空间中正在进行分片上传任务的起始位置。如果upload-id-marker没有指定,则只会列出key按照词典顺序比给定的key-marker大的任务。


响应

响应元素

参数

描述

ListMultipartUploadsResult

响应内容的容器。

Bucket

启动分片上传任务的用户空间名称。

KeyMarker

列表开始位置的Key。

UploadIdMarker

列表开始位置的upload ID。

NextKeyMarker

在一个连续列表请求中,如果列表是被截断的,应该通过设定key-marker值来返回下次列表开始位置。

NextUploadIdMarker

在一个连续列表请求中,如果列表是被截断的,应该通过设定upload-id-marker值来返回下次列表开始位置。

Encoding-Type

响应中对对象名称的编码方式。

MaxUploads

响应中列表应包含的最大条目数。

IsTruncated

是否被截断。如果对象列表记录数超过了设定的最大值,那么将会被截断。

Key

分片上传任务上传对象的key。

UploadID

分片上传任务的ID。

Initiator

包含分片上传任务发起人信息的容器。

ID

用户ID。

DisplayName

发起人或拥有者的名称。

Owner

用户空间拥有者信息。

StorageClass

存储方式,包括:STANDARD。

Initiated

分片上传任务启动时的时间和日期。

ListMultipartUploadsResult.Prefix

对象key中指定的前缀。

Delimiter

分隔符,用于分割参数。分割后便于确定公共前缀。

CommonPrefixes

当用户指定分隔符后,会返回他们的公共前缀。实际上,公共前缀包括的值类似于文件目录中的同一个目录下的子目录。

CommonPrefixes.Prefix

如果设定了Prefix参数,则此参数的值将为Prefix后开始到第一个分隔符止,否则从头开始到第一个分隔符止。


示例

请求示例

GET /?uploads&max-uploads=3 HTTP/1.1

Host: examplebucket.region.lecloudapis.com

Date: Mon, 1 Nov 2010 20:34:56 GMT

Authorization: authorization string

返回示例

HTTP/1.1 200 OK

x-amz-id-2: Uuag1LuByRx9e6j5Onimru9pO4ZVKnJ2Qz7/C1NPcfTWAtRPfTaOFg==

x-amz-request-id: 656c76696e6727732072657175657374

Date: Mon, 1 Nov 2010 20:34:56 GMT

Content-Length: 1330

Connection: keep-alive


< ?xml version="1.0" encoding="UTF-8"? >

< ListMultipartUploadsResult xmlns="http://region.unicloudsrv.com/doc/2006-03-01/" >

  < Bucket >bucket< /Bucket >

  < KeyMarker >< /KeyMarker >

  < UploadIdMarker >< /UploadIdMarker >

  < NextKeyMarker >my-movie.m2ts< /NextKeyMarker >

  < NextUploadIdMarker >YW55IGlkZWEgd2h5IGVsdmluZydzIHVwbG9hZCBmYWlsZWQ< /NextUploadIdMarker >

  < MaxUploads >3< /MaxUploads >

  < IsTruncated >true< /IsTruncated >

  < Upload >

    < Key >my-divisor< /Key >

    < UploadId >XMgbGlrZSBlbHZpbmcncyBub3QgaGF2aW5nIG11Y2ggbHVjaw< /UploadId >

    < Initiator >

      < ID >arn:aws:iam::111122223333:user/user1-11111a31-17b5-4fb7-9df5-b111111f13de< /ID >

      < DisplayName >user1-11111a31-17b5-4fb7-9df5-b111111f13de< /DisplayName >

    < /Initiator >

    < Owner >

      < ID >75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a< /ID >

      < DisplayName >OwnerDisplayName< /DisplayName >

    < /Owner >

    < StorageClass >STANDARD< /StorageClass >

    < Initiated >2010-11-10T20:48:33.000Z< /Initiated >  

  < /Upload >

  < Upload >

    < Key >my-movie.m2ts< /Key >

    < UploadId >VXBsb2FkIElEIGZvciBlbHZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZA< /UploadId >

    < Initiator >

      < ID >b1d16700c70b0b05597d7acd6a3f92be< /ID >

      < DisplayName >InitiatorDisplayName< /DisplayName >

    < /Initiator >

    < Owner >

      < ID >b1d16700c70b0b05597d7acd6a3f92be< /ID >

      < DisplayName >OwnerDisplayName< /DisplayName >

    < /Owner >

    < StorageClass >STANDARD< /StorageClass >

    < Initiated >2010-11-10T20:48:33.000Z< /Initiated >

  < /Upload >

  < Upload >

    < Key >my-movie.m2ts< /Key >

    < UploadId >YW55IGlkZWEgd2h5IGVsdmluZydzIHVwbG9hZCBmYWlsZWQ< /UploadId >

    < Initiator >

      < ID >arn:aws:iam::444455556666:user/user1-22222a31-17b5-4fb7-9df5-b222222f13de< /ID >

      < DisplayName >user1-22222a31-17b5-4fb7-9df5-b222222f13de< /DisplayName >

    < /Initiator >

    < Owner >

      < ID >b1d16700c70b0b05597d7acd6a3f92be< /ID >

      < DisplayName >OwnerDisplayName< /DisplayName >

    < /Owner >

    < StorageClass >STANDARD< /StorageClass >

    < Initiated >2010-11-10T20:49:33.000Z< /Initiated >

  < /Upload >

< /ListMultipartUploadsResult >