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大小 |
细节分析
- List Parts支持max-parts和part-number-marker两种请求参数。
- max-parts参数最大值为1000；默认值也为1000。
- 在COS的返回结果按照Part号码升序排列。
- 由于网络传输可能出错，所以不推荐用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: COS
{
"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
}
]
}