文档中心>数据保险箱>API 文档>分片上传>查询特定分块上传中的已上传的块

查询特定分块上传中的已上传的块

最近更新时间:2023-02-03 11:04:09

接口描述

  • 接口名称:ListParts
  • 接口功能:该接口用于查询特定上传分块中已上传的分块,即罗列出指定 UploadId 所属的所有已上传成功的分块。

请求

请求示例

GET /<CofferName-APPID>/<ObjectKey>?uploadId=UploadId HTTP/1.1
Host: cdcs.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String

说明:

Authorization: Auth String 详情,请参见 请求签名 文档。

请求头

此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。

请求参数

名称                   必选 类型 描述
UploadId string 标识本次分块上传的 ID。使用 InitiateMultipartUpload 接口 初始化分片上传时会得到一个 uploadId,该 ID 不但唯一标识这一分块数据,也标识了这分块数据在整个文件内的相对位置。
encoding-type string 规定返回值的编码方式。
max-parts string 单次返回最大的条目数量,默认1000。
part-number-marker string 默认以 UTF - 8 二进制顺序列出条目,所有列出条目从 part-number-marker 开始。

请求体

该请求的请求体为空。

响应

响应头

此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。

响应体

查询成功,返回 application/json 数据,包含已完成的分片信息。

{
    "Coffer": "examplecoffer-1250000000",
    "Key": "exampleobject",
    "UploadId": "14846420620b1f381e5d7b057692e131dd8d72dfa28f2633cfbbe4d0a9e8bd0719933545b0",
    "Initiator": {
        "ID": "1250000000",
        "DisplayName": "1250000000"
    },
    "Owner": {
        "ID": "qcs::cam::uin/100000000001:uin/100000000001",
        "DisplayName": "100000000001"
    },
    "PartNumberMarker": "1",
    "IsTruncated": "true",
    "NextPartNumberMarker": "1",
    "MaxParts": 0,
    "Part": [{
        "PartNumber": 1,
        "LastModified": "Tue Jan 17 16:43:37 2017",
        "ETag": "\"a1f8e5e4d63ac6970a0062a6277e191fe09a1382\"",
        "Size": 5242880
    }]
}

请求参数描述如下:

节点名称(关键字) 类型 描述
Coffer string 分块上传的目标数据保险箱,数据保险箱的名字由用户自定义字符串和系统生成 AppID 数字串连接而成,例如:examplecoffer-1250000000。
Encoding-Type string 编码格式。
Key string Object 的名字。
UploadId string 标识本次分块上传的 ID。
Initiator Object 用来表示这些分块所有者的信息。
Owner Object 用来表示这些分块所有者的信息。
PartNumberMarker string 默认以 UTF - 8 二进制顺序列出条目,所有列出条目从 marker 开始。
NextPartNumberMarker string 假如返回条目被截断,则返回 NextMarker 就是下一个条目的起点。
MaxParts string 单次返回最大的条目数量。
IsTruncated boolean 响应请求条目是否被截断,布尔值:true 或 false。
Part Object 元数据信息。

Initiator 对象的描述:

节点名称(关键字) 类型 描述
ID string 创建者的一个唯一标识。
DisplayName string 创建者的用户名描述。

Owner 对象的描述:

节点名称(关键字) 类型 描述
ID string 创建者的唯一标识。
DisplayName string 创建者的用户名描述。

Part 对象的描述:

节点名称(关键字) 类型 描述
PartNumber string 块的编号。
LastModified string 说明块最后被修改时间。
ETag string 块的 MD-5 算法校验值。
Size string 说明块大小,单位是 Byte。

示例

请求

GET /examplecoffer-1250000000/exampleobject?uploadId=1585130821cbb7df1d11846c073ad648e8f33b087cec2381df437acdc833cf654b9ecc6361 HTTP/1.1
Host: cdcs.ap-beijing.myqcloud.com
Date: Wed, 25 Mar 2020 10:07:25 GMT
Authorization: [Auth String]
Connection: close

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 1119
Connection: close
Date: Wed, 25 Mar 2020 10:07:25 GMT
Server: tencent-cdcs
x-cdcs-request-id: NWU3YjJkNWRfMjNhZjJhMDlfNWY5Ml8zMmUy****

{
    "Coffer": "examplecoffer-1250000000",
    "Key": "exampleobject",
    "UploadId": "14846420620b1f381e5d7b057692e131dd8d72dfa28f2633cfbbe4d0a9e8bd0719933545b0",
    "Initiator": {
        "ID": "1250000000",
        "DisplayName": "1250000000"
    },
    "Owner": {
        "ID": "qcs::cam::uin/100000000001:uin/100000000001",
        "DisplayName": "100000000001"
    },
    "PartNumberMarker": "1",
    "IsTruncated": "true",
    "NextPartNumberMarker": "1",
    "MaxParts": 0,
    "Part": [{
        "PartNumber": 1,
        "LastModified": "Tue Jan 17 16:43:37 2017",
        "ETag": "\"a1f8e5e4d63ac6970a0062a6277e191fe09a1382\"",
        "Size": 5242880
    }]
}