数据保险箱
有奖捉虫：行业应用 & 管理与支持文档专题 HOT
文档中心 > 数据保险箱 > API 文档 > 分片上传 > 查询特定分块上传中的已上传的块

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

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

前往 GitHub 编辑 我的收藏

本页目录：

接口描述

  • 接口名称：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
    }]
}

中国站