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

results matching ""

    No results matching ""