list-multipart-upload-parts
List Multipart Upload Parts
1. 描述
该接口用于列举uploadId所属的所有已经成功上传的part
2. 请求地址
GET /{bucket}/{object}
3. 请求头
请求头信息请参考【公共参数】部分
4. 请求参数
| Name | Type | Description | Required |
|---|---|---|---|
| uploadId | String | 已初始化的分片上传ID | 是 |
| maxParts | Integer | 显示块数 | 否 |
| partNumberMarker | String | 分页标识，前一页最后一个part的parNumber | 否 |
5. 响应头
该响应头信息请参考【公共参数】部分。
6. 响应体
| Name | Type | Description |
|---|---|---|
| bucketName | String | 接收对象的bucket |
| key | String | Object的名称 |
| uploadId | String | 后续上传使用的ID |
| maxParts | Integer | 分片上传的最大块数，与请求时的参数相同 |
| partNumberMarker | String | 本次响应结果的PartNumber起始处 |
| owner | Container | 上传的object对象所属对象 |
| id | String | 初始化者的ID |
| displayName | String | 初始化者的名称 |
| storageClass | String | 上传的块存储级别 |
| nextPartNumberMarker | String | 若IsTruncated值为true，NextPartNumberMarker值为下次请求中PartNumber的值 |
| part | Container | 包含partNumber、lastModified、size和etag属性 |
| initiator | Container | 发起初始化者的相关信息 |
| lastModified | Date | 最后修改的时间 |
| partNumber | Container | 块编号 |
| eTag | String | 块ETag值 |
| size | Integer | 上传块的大小 |
| truncated | Boolean | 若结果已全部返回，值为false；若未全部返回则为true |
7. 请求示例
GET /bucket123/QQ_V6.5.0.dmg?uploadId=2%7EfDm836prWZZ7bUeHIbf0itmBSCpU61f&maxParts=10 HTTP/1.1
Host: cn-east-1.cloud-oss.com
Nonce: 87dcfae6-8f99-4d13-9217-a0d3d161e836
Authorization: YCS1-HMAC-SHA1 Credential=d1a190cf-b05e-4ca4-9a24-3c3ac7938e08, SignedHeaders=date;nonce;version, Signature=DfKT9qM/E+9nW/r1rAXJmvsQxJA=
Version: 2018-10-30
Date: Tue, 20 Nov 2018 08:56:03 GMT
Content-Type: application/json;charset=UTF-8
8. 返回示例
{
"bucketName" : "bucket123",
"key" : "QQ_V6.5.0.dmg",
"uploadId" : "2~fDm836prWZZ7bUeHIbf0itmBSCpU61f",
"maxParts" : 10,
"partNumberMarker" : 0,
"owner" : {
"displayName" : "2c9481226684eb130166854b595e0035",
"id" : "2c9481226684eb130166854b595e0035"
},
"storageClass" : "STANDARD",
"nextPartNumberMarker" : 2,
"parts" : [ {
"partNumber" : 1,
"lastModified" : 1542703724347,
"size" : 10485760,
"etag" : "f26f9370c96b0fdbbcf13190735bd602"
}, {
"partNumber" : 2,
"lastModified" : 1542703730258,
"size" : 10485760,
"etag" : "b8f44bd6e24ff9b0f0c1b5e622f7771a"
} ],
"truncated" : false,
"requesterCharged" : false
}
9. 错误码
该接口没有特殊错误码，错误码可以参考公共错误码