ListParts

ListParts命令可以罗列出指定UploadID所属的所有已经上传成功Part。

请求语法

Get  /ObjectName?uploadId=UploadId HTTP/1.1
Host: bucketname.cos.chinac.com
Date: GMT Date
Authorization: Signature

请求参数

Name Type Description
uploadId String Multipart Upload事件的ID
max-parts int 规定在COS响应中的最大Part数目
part-number-marker int 指定List的起始位置,只有Part Number数目大于该参数的Part会被列出

响应参数

Name Type Description
Bucket String Bucket名称
Key String Object名称
UploadId Long Upload事件ID
PartNumberMarker int 这次List结果的PartNumber起始位置。
NextPartNumberMarker int 如果本次没有返回全部结果,用于标明接下来请求的PartNumberMarker值。
MaxParts int 返回请求中最大的Part数目
IsTruncated boolean 标明是否本次返回的List Part结果列表被截断。“true”表示本次没有返回全部结果;“false”表示本次已经返回了全部结果。
Part Array 保存Part信息
PartNumber int 标示Part的数字
LastModified String Part上传的时间
ETag String 已上传Part内容的ETag
Size Long 已上传Part大小

细节分析

  1. List Parts支持max-parts和part-number-marker两种请求参数。
  2. max-parts参数最大值为1000;默认值也为1000。
  3. 在COS的返回结果按照Part号码升序排列。
  4. 由于网络传输可能出错,所以不推荐用List Part出来的结果(Part Number和ETag值)来生成最后Complete Multipart的Part列表。

示例

请求示例
Get  /multipart.data?uploadId=0004B999EF5A239BB9138C6227D69F95  HTTP/1.1
Host: test-bucket.cos.chinac.com
Date: Thu, 23 Feb 2012 07:13:28 GMT
Authorization: COS qn6qrrqxo2oawuk53otfjbyc:4qOnUMc9UQWqkz8wDqD3lIsa9P8=
返回示例
HTTP/1.1 200 
Content-Type: application/json
Content-Length: 1221
Connection: keep-alive
x-cos-request-id: 106452c8-10ff-812d-736e-c865294afc1c
Date: Thu, 23 Feb 2012 07:13:28 GMT
Server: ChinacCOS

{
    "Bucket": "test-bucket",
    "Key": "multipart.data",
    "UploadId": 1251,
    "PartNumberMarker": 0,
    "NextPartNumberMarker": 2,
    "MaxParts": 1000,
    "IsTruncated": false,
    "Parts":[
    {
        "PartNumber": 1,
        "LastModified": "2016-02-25T15:46:18+0800",
        "ETag": "dcfbec872939710ea5dd0df82ed27789",
        "Size": 21
    },
    {
        "PartNumber": 2,
        "LastModified": "2016-02-25T15:47:15+0800",
        "ETag": "71cb71a054447b28e0702f4c22fa938d",
        "Size": 37
    }
    ]
}

results matching ""

    No results matching ""