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. 错误码

该接口没有特殊错误码,错误码可以参考公共错误码

个结果匹配 ""

    无结果匹配 ""