1. List Multipart Upload Parts
1.1. 描述
该接口用于列举uploadId所属的所有已经成功上传的part
1.2. 请求地址
GET /{bucket}/{object}
1.3. 请求头
请求头信息请参考【公共参数】部分
1.4. 请求参数
Name | Type | Description | Required |
---|---|---|---|
uploadId | String | 已初始化的多块上传ID | 是 |
maxParts | Integer | 显示块数 | 否 |
partNumberMarker | String | 分页标识,前一页最后一个part的parNumber | 否 |
1.5. 响应头
该响应头信息请参考【公共参数】部分。
1.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 |
1.7. 请求示例
GET /lj-test-002/QQ_V6.5.0.dmg?uploadId=2%7EfDm836prWZZ7bUeHIbf0itmBSCpU61f&maxParts=10 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 |
1.7.1. 返回结果
响应头
Expires: 0 Cache-Control: no-cache, no-store, max-age=0, must-revalidate X-XSS-Protection: 1; mode=block Pragma: no-cache X-Frame-Options: DENY Content-Disposition: inline;filename=f.txt Date: Tue, 20 Nov 2018 08:56:04 GMT Connection: keep-alive X-Content-Type-Options: nosniff Transfer-Encoding: chunked Content-Type: application/json;charset=UTF-8
响应体
{
"bucketName" : "lj-test-002",
"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
}
1.8. 错误码
该接口没有特殊错误码,错误码可以参考公共错误码
2. List Multipart Upload Parts
2.1. 功能描述
该接口用于列举uploadId所属的所有已经成功上传的part
2.2. 请求
2.2.1. 请求语法
GET /{bucket}/{object}?uploadId=123 HTTP/1.1 Host:<region>.cloud-oss.com Date:GMT Date Authorization: {AccessKey}:{AccessKeySecret} |