文档简介：
List Part
该操作用于列出一次分片上传过程中已经上传完成的所有片段。
该操作必须包含一个通过Initial Multipart Upload操作获取的上传ID。该请求最多返回1000个上传片段信息，默认返回的片段数是1000。用户可以通过指定max-parts参数来指定一次请求返回的片段数。如果用户的分片上传过程超过1000个片段，响应中的IsTruncated字段的值则被设置成true，并且指定一个NextPartNumberMarker元素。用户可以在下一个连续的List Part请求中加入part-number-marker参数，并把它的值设置成上一个请求返回的NextPartNumberMarker值。
请求语法
|
GET /ObjectName?uploadId=UploadId HTTP/1.1 Host: BucketName.oos-cn.ctyunapi.cn Date: Date Authorization: Signature |
请求参数
此次Get请求通过使用下表中的参数来返回一个uploadId中的parts集合。
|
名称 |
描述 |
是否必须 |
|
uploadId |
该ID用来标识一个分片上传过程。 类型：String 默认值：None |
是 |
|
max-parts |
设置响应体中返回的片段的最大数目。 类型：String 默认值：1000 |
否 |
|
part-number-marker |
指定此次列表的起始片段的分片号，只有比该片段的分片号更高的片段才会被列举出来。 类型：String 默认值：None |
否 |
返回元素
|
名称 |
描述 |
|
ListPartsResult |
包含整个响应的容器。 类型：容器 子节点：Bucket, Key, UploadId, Initiator, Owner, StorageClass,PartNumberMarker, NextPartNumberMarker, MaxParts,IsTruncated, Part 父节点：无 |
|
Bucket |
分片上传对应的bucket名称。 类型：String 父节点：ListPartsResult |
|
Key |
新创建的对象的Key。 类型：String 父节点：ListPartsResult |
|
UploadId |
分片上传ID。 类型：String 父节点：ListPartsResult |
|
Initiator |
指定执行此次分片上传过程的用户账户。 子节点：ID，DisplayName 类型：容器 父节点：ListPartsResult |
|
ID |
OOS账户的ID号。 类型：String 父节点：Initiator |
|
DisplayName |
OOS账户的账户名。 类型：String 父节点：Initiator |
|
Owner |
用来标识对象的所属账户。 子节点：ID，DisplayName 类型：容器 父节点：ListPartsResult |
|
StorageClass |
对象的存储类型（STANDARD或REDUCED_REDUNDANCY）。 类型：String 父节点：ListPartsResult |
|
PartNumberMarker |
列表起始位置的片段的分片号。 类型：Integer 父节点：ListPartsResult |
|
NextPartNumberMarker |
当此次请求没有将所有片段列举完时，此元素指定列表中的最后一个片段的分片号。此分片号用于作为下一次连续列表请求的part-number-marker参数的值。 类型：Integer 父节点：ListPartsResult |
|
MaxParts |
响应中片段的最大数目。 类型：Integer 父节点：ListPartsResult |
|
IsTruncated |
标识此次分片上传过程中的所有片段是否全部被列出，如果为true则表示没有全部列出。如果分片上传过程的片段数超过了MaxParts元素指定的最大数，则会导致一次列表请求无法将所有片段数列出。 类型：Boolean 父节点：ListPartsResult |
|
Part |
与某个片段对应的容器，响应中可能包含0个或多个Part元素。 子节点：PartNumber, LastModified, ETag, Size 类型：String 父节点：ListPartsResult |
|
PartNumber |
标识片段的分片号。 类型：Integer 父节点：Part |
|
LastModified |
片段上传完成的日期。 类型：Date 父节点：Part |
|
ETag |
片段上传完成时返回的ETag值。 类型：String 父节点：Part |
|
Size |
片段的数据大小 类型：Integer 父节点：Part |
出错响应
|
响应代码 |
描述 |
HTTP状态码 |
|
NoSuchUpload |
指定的分片上传过程不存在，上传ID可能非法，分片上传过程可能被终止或者已经完成。 |
404Not Found |
请求示例
假设用户上传了一系列以1开头的有连续分片号的片段，下面的List Part请求指定了max-parts和part-number-marker查询参数。此次请求列出了紧随片段1的两个片段，从请求响应体中可以获取到片段2和片段3。如果有更多的片段存在，则片段列表操作没有完成，响应体中将会包含值为true的IsTruncated元素。同时，响应体中还会包含值为3的NextPartNumberMarker元素，这个值用来指定在下一次连续的列表操作中part-number-marker参数的值。
|
GET /example-object?uploadId=XXBsb2FkIElEIGZvciBlbHZpbmcncyVcdS1tb3ZpZS5tMnRzEEEw bG9hZA&max-parts=2&part-number-marker=1 HTTP/1.1 Host: example-bucket.oos-cn.ctyunapi.cn Date: Mon, 1 Nov 2010 20:34:56 GMT Authorization: AWS 7799e793ce4624ee7e5a:xQE0diMbLRepdf3YB+FIEXAMPLE= |
返回示例
|
HTTP/1.1 200 OK x-amz-request-id: 656c76696e6727732072657175657374 Date: Mon, 1 Nov 2010 20:34:56 GMT Content-Length: 985 Connection: keep-alive Server: CTYUN
<?xml version="1.0" encoding="UTF-8"?> <ListPartsResult xmlns="/doc/2006-03-01/"> <Bucket>example-bucket</Bucket> <Key>example-object</Key> <UploadId>XXBsb2FkIElEIGZvciBlbHZpbmcncyVcdS1tb3ZpZS5tMnRzEEEwbG9hZA</UploadId> <Initiator> <ID>mailaddress@email.com</ID> <DisplayName>umat-user-11116a31-17b5-4fb7-9df5-b288870f11xx</DisplayName> </Initiator> <Owner> <ID></ID> <DisplayName></DisplayName> </Owner> <StorageClass>STANDARD</StorageClass> <PartNumberMarker>1</PartNumberMarker> <NextPartNumberMarker>3</NextPartNumberMarker> <MaxParts>2</MaxParts> <IsTruncated>true</IsTruncated> <Part> <PartNumber>2</PartNumber> <LastModified>2010-11-10T20:48:34.000Z</LastModified> <ETag>"7778aef83f66abc1fa1e8477f296d394"</ETag> <Size>10485760</Size> </Part> <Part> <PartNumber>3</PartNumber> <LastModified>2010-11-10T20:48:33.000Z</LastModified> <ETag>"aaaa18db4cc2f85cedef654fccc4a4x8"</ETag> <Size>10485760</Size> </Part> </ListPartsResult> |
