租户端 存储 对象存储（COS） COS API参考 查询已上传块

查询已上传块

最近更新时间: 2025-02-18 16:02:00

功能描述

List Parts 用来查询特定分块上传中的已上传的块，即罗列出指定 UploadId 所属的所有已上传成功的分块。

请求

请求示例

  • 复制
    复制成功
GET /<ObjectKey>?uploadId=UploadId HTTP/1.1
Host: <BucketName-APPID>.<Endpoint>
Date: GMT Date
Authorization: Auth String

说明：

Authorization: Auth String (详情请参见请求签名章节)。

请求头

公共头部

该请求操作的实现使用公共请求头，了解公共请求头详情请参见 公共请求头部 章节。

非公共头部

该请求操作无特殊的请求头部信息。

请求参数

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

请求体

该请求请求体为空。

响应

响应头

公共响应头

该响应包含公共响应头，了解公共响应头详情请参见 公共响应头部 章节。

特有响应头

该响应无特殊的响应头。

响应体

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

  • 复制
    复制成功
<?xml version="1.0" encoding="UTF-8" ?>
<ListPartsResult>
    <Bucket>examplebucket-1250000000</Bucket>
    <Encoding-type/>
    <Key>exampleobject</Key>
    <UploadId>14846420620b1f381e5d7b057692e131dd8d72dfa28f2633cfbbe4d0a9e8bd0719933545b0</UploadId>
    <Initiator>
        <ID>1250000000</ID>
        <DisplyName>1250000000</DisplyName>
    </Initiator>
    <Owner>
        <ID>qcs::cam::uin/100000000001:uin/100000000001</ID>
        <DisplyName>100000000001</DisplyName>
    </Owner>
    <PartNumberMarker>0</PartNumberMarker>
    <Part>
        <PartNumber>1</PartNumber>
        <LastModified>Tue Jan 17 16:43:37 2017</LastModified>
        <ETag>"a1f8e5e4d63ac6970a0062a6277e191fe09a1382"</ETag>
        <Size>5242880</Size>
    </Part>
    <NextPartNumberMarker>1</NextPartNumberMarker>
    <StorageClass>STANDARD</StorageClass>
    <MaxParts>1</MaxParts>
    <IsTruncated>true</IsTruncated>
</ListPartsResult>

具体的数据描述如下：

节点名称（关键字）父节点描述类型
ListPartsResult无保存 List Parts 请求结果的所有信息Container

Container 节点 ListPartsResult 的内容：

节点名称（关键字）父节点描述类型
BucketListPartsResult分块上传的目标 Bucket，存储桶的名字，由用户自定义字符串和系统生成 APPID 数字串由中划线连接而成，如：examplebucket-1250000000string
Encoding-TypeListPartsResult编码格式string
KeyListPartsResultObject 的名字string
UploadIdListPartsResult标识本次分块上传的 IDstring
InitiatorListPartsResult用来表示这些分块所有者的信息Container
OwnerListPartsResult用来表示这些分块所有者的信息Container
StorageClassListPartsResult用来表示这些分块的存储级别，枚举值：STANDARD，STANDARD_IA，ARCHIVEstring
PartNumberMarkerListPartsResult默认以 UTF-8 二进制顺序列出条目，所有列出条目从 marker 开始string
NextPartNumberMarkerListPartsResult假如返回条目被截断，则返回 NextMarker 就是下一个条目的起点string
MaxPartsListPartsResult单次返回最大的条目数量string
IsTruncatedListPartsResult响应请求条目是否被截断，布尔值：true，falseboolean
PartListPartsResult元数据信息Container

Container 节点 Initiator 的内容：

节点名称（关键字）父节点描述类型
IDListPartsResult.Initiator创建者的一个唯一标识string
DisplayNameListPartsResult.Initiator创建者的用户名描述string

Container 节点 Owner 的内容：

节点名称（关键字）父节点描述类型
IDListPartsResult.Owner创建者的一个唯一标识string
DisplayNameListPartsResult.Owner创建者的用户名描述string

Container 节点 Part 的内容：

节点名称（关键字）父节点描述类型
PartNumberListPartsResult.Part块的编号string
LastModifiedListPartsResult.Part说明块最后被修改时间string
ETagListPartsResult.Part块的 MD-5 算法校验值string
SizeListPartsResult.Part说明块大小，单位是 Bytestring

实际案例

请求

  • 复制
    复制成功
GET /exampleobject?uploadId=14846420620b1f381e5d7b057692e131dd8d72dfa28f2633cfbbe4d0a9e8bd0719933545b0&max-parts=1 HTTP/1.1
Host: <BucketName-APPID>.<Endpoint>
Date: Wed，18 Jan 2017 16:17:03 GMT
Authorization:q-sign-algorithm=sha1&q-ak=AKIDxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&q-sign-time=1484643123;1484646723&q-key-time=1484643123;1484646723&q-header-list=host&q-url-param-list=max-parts;uploadid&q-signature=b8b4055724e64c9ad848190a2f7625fd3f9d3e87

响应

  • 复制
    复制成功
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 661
Connection: keep-alive
Date: Wed，18 Jan 2017 16:17:03 GMT
x-cos-request-id: NTg3ZGRiMzhfMmM4OGY3XzdhY2NfYw==

<ListPartsResult>
    <Bucket>examplebucket-1250000000</Bucket>
    <Encoding-type/>
    <Key>exampleobject</Key>
    <UploadId>14846420620b1f381e5d7b057692e131dd8d72dfa28f2633cfbbe4d0a9e8bd0719933545b0</UploadId>
    <Initiator>
        <ID>1250000000</ID>
        <DisplyName>1250000000</DisplyName>
    </Initiator>
    <Owner>
        <ID>qcs::cam::uin/100000000001:uin/100000000001</ID>
        <DisplyName>100000000001</DisplyName>
    </Owner>
    <PartNumberMarker>0</PartNumberMarker>
    <Part>
        <PartNumber>1</PartNumber>
        <LastModified>Tue Jan 17 16:43:37 2017</LastModified>
        <ETag>"a1f8e5e4d63ac6970a0062a6277e191fe09a1382"</ETag>
        <Size>5242880</Size>
    </Part>
    <NextPartNumberMarker>1</NextPartNumberMarker>
    <StorageClass>STANDARD</StorageClass>
    <MaxParts>1</MaxParts>
    <IsTruncated>true</IsTruncated>
</ListPartsResult>