List Parts
描述:列出已经上传的所有分块
请求格式:
GET /<ObjectName>?uploadId=<UploadId> HTTP/1.1
Host: <Your-Bucket-Name>.ss.bscstorage.com
Date: <date>
Authorization: <authorization string> #请参照《签名算法》
- 响应:
HTTP/1.1 200 OK
Date: Tue, 08 Apr 2014 02:59:47 GMT
Connection: keep-alive
x-amz-request-id: 0000106c-1608-0810-4621-00163e000064
x-amz-s2-requester: <Your UserName>
<?xml version="1.0" encoding="UTF-8"?>
<ListPartsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Bucket>example-bucket</Bucket>
<Key>example-object</Key>
<UploadId>XXBsb2FkIElEIGZvciBlbHZpbmcncyVcdS1tb3ZpZS5tMnRzEEEwbG9hZA</UploadId>
<Initiator>
<ID>initiator</ID>
<DisplayName></DisplayName>
</Initiator>
<Owner>
<ID>owner</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>
- Request Parameters(请求参数):
Parameter | Description | Required |
---|---|---|
uploadId | 通过Initiate Multipart Upload(大文件分片上传初始化接口)获得的uploadId值 | Yes |
max-parts | 返回最大的part数量, 默认返回2048个 | Yes |
part-number-marker | 列出该partNumber之后的parts, 不包括该partNUmber指定的part, partNUmber从1开始 | Yes |
Request Headers(请求头):
Response Body(响应XML Body):
Name Description ListPartsResult 包含Bucket, Key, UploadId, Initiator, Owner, StorageClass, PartNumberMarker, NextPartNumberMarker, MaxParts, IsTruncated, Part元素 Bucket bucket name Key objectName UploadId 标识该分块上传的ID, 之后上传分片时需要携带该参数 Initiator 包含ID, DisplayName元素 ID init UserName DisplayName Owner 包含ID, DisplayName元素, 指定文件的owner StorageClass 存储类别 PartNumberMarker list开始的partNumber, 不包含该partNumber NextPartNumberMarker 下次开始list的partNumber MaxParts 最大part数量 IsTruncated 是否被truncated Part 包含PartNumber, LastModified, ETag, Size元素, 表示一个part的信息 PartNumber part的number LastModified part的最后修改时间 ETag part的md5 Size part的size