文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>对象存储>API 文档>Object 接口>分块上传>List Parts

List Parts

最近更新时间：2024-11-15 21:48:54

我的收藏

本页目录：

功能描述

List Parts 用来查询特定分块上传中的已上传的块，即罗列出指定 UploadId 所属的所有已上传成功的分块。
说明 只有主账号或者被授权 List Part 接口权限的子账号可以调用该接口。


授权说明

授权策略中 action 设置为 cos:ListParts 。查看所有 action。

请求

请求示例

GET /<ObjectKey>?uploadId=UploadId HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
说明
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com，其中 <BucketName-APPID> 为带 APPID 后缀的存储桶名字，例如 examplebucket-1250000000，详情请参见 存储桶概览 > 基本信息 和 存储桶概述 > 存储桶命名规范 文档；<Region> 为 COS 的可用地域，详情请参见 地域和访问域名 文档。
Authorization: Auth String（详情请参见 请求签名 文档）。

请求头

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

请求参数

名称
描述
类型
是否必选
UploadId
标识本次分块上传的 ID，使用 Initiate Multipart Upload 接口初始化分块上传时得到的 UploadId
string
是
encoding-type
规定返回值的编码方式
string
否
max-parts
单次返回最大的条目数量，最大值为1000，默认值为1000
int
否
part-number-marker
默认以 UTF-8 二进制顺序列出条目，所有列出条目从 marker 开始
string
否

请求体

该请求的请求体为空。

响应

响应头

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

响应体

查询成功，返回 application/xml 数据，包含已完成的分片信息。
<?xml version="1.0" encoding="UTF-8" ?>
<ListPartsResult>
    <Bucket>examplebucket-1250000000</Bucket>
    <EncodingType/>
    <Key>exampleobject</Key>
    <UploadId>14846420620b1f381e5d7b057692e131dd8d72dfa28f2633cfbbe4d0a9e8bd0719933545b0</UploadId>
    <Initiator>
        <ID>1250000000</ID>
        <DisplayName>1250000000</DisplayName>
    </Initiator>
    <Owner>
        <ID>qcs::cam::uin/100000000001:uin/100000000001</ID>
        <DisplayName>100000000001</DisplayName>
    </Owner>
    <PartNumberMarker>0</PartNumberMarker>
    <Part>
        <PartNumber>1</PartNumber>
        <LastModified>2020-03-25T10:07:14.000Z</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 的内容：
节点名称（关键字）
父节点
描述
类型
Bucket
ListPartsResult
分块上传的目标 Bucket，存储桶的名字，由用户自定义字符串和系统生成 APPID 数字串由中划线连接而成，如：examplebucket-1250000000
string
EncodingType
ListPartsResult
编码格式
string
Key
ListPartsResult
Object 的名称
string
UploadId
ListPartsResult
标识本次分块上传的 ID
string
Initiator
ListPartsResult
用来表示初始化分块任务的用户信息
Container
Owner
ListPartsResult
用来表示这些分块所有者的信息，与 Initiator 相同
Container
StorageClass
ListPartsResult
用来表示这些分块的存储类型，枚举值：STANDARD，STANDARD_IA，ARCHIVE，DEEP_ARCHIVE 等，更多存储类型请参见 存储类型概述
string
PartNumberMarker
ListPartsResult
默认以 UTF-8 二进制顺序列出条目，所有列出条目从 marker 开始
string
NextPartNumberMarker
ListPartsResult
假如返回条目被截断，则返回 NextMarker 就是下一个条目的起点
string
MaxParts
ListPartsResult
单次返回最大的条目数量
int
IsTruncated
ListPartsResult
响应请求条目是否被截断，布尔值：true，false
boolean
Part
ListPartsResult
元数据信息
Container
Container 节点 Initiator 的内容：
节点名称（关键字）
父节点
描述
类型
ID
ListPartsResult.Initiator
创建者的一个唯一标识
string
DisplayName
ListPartsResult.Initiator
创建者的用户名描述
string
Container 节点 Owner 的内容：
节点名称（关键字）
父节点
描述
类型
ID
ListPartsResult.Owner
创建者的一个唯一标识
string
DisplayName
ListPartsResult.Owner
创建者的用户名描述
string
Container 节点 Part 的内容：
节点名称（关键字）
父节点
描述
类型
PartNumber
ListPartsResult.Part
块的编号
string
LastModified
ListPartsResult.Part
说明块最后被修改时间
string
ETag
ListPartsResult.Part
块的 MD-5 算法校验值
string
Size
ListPartsResult.Part
说明块大小，单位是 Byte
string

错误码

此接口遵循统一的错误响应和错误码，详情请参见 错误码 文档。

实际案例

请求

GET /exampleobject?uploadId=1585130821cbb7df1d11846c073ad648e8f33b087cec2381df437acdc833cf654b9ecc6361 HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Wed, 25 Mar 2020 10:07:25 GMT
Authorization: q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1585130845;1585138045&q-key-time=1585130845;1585138045&q-header-list=date;host&q-url-param-list=uploadid&q-signature=****************************************
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-cos
x-cos-request-id: NWU3YjJkNWRfMjNhZjJhMDlfNWY5Ml8zMmUy****



<ListPartsResult>
            <Bucket>examplebucket-1250000000</Bucket>
            <EncodingType/>
            <Key>exampleobject</Key>
            <UploadId>1585130821cbb7df1d11846c073ad648e8f33b087cec2381df437acdc833cf654b9ecc6361</UploadId>
            <Owner>
                <ID>1250000000</ID>
                <DisplayName>1250000000</DisplayName>
            </Owner>
            <PartNumberMarker>0</PartNumberMarker>
            <Initiator>
                <ID>qcs::cam::uin/100000000001:uin/100000000011</ID>
                <DisplayName>100000000011</DisplayName>
            </Initiator>
            <Part>
                <PartNumber>1</PartNumber>
                <LastModified>2020-03-25T10:07:14.000Z</LastModified>
                <ETag>&quot;39270a968a357d24207e9911162507eb&quot;</ETag>
                <Size>1048576</Size>
            </Part>
            <Part>
                <PartNumber>2</PartNumber>
                <LastModified>2020-03-25T10:07:13.000Z</LastModified>
                <ETag>&quot;d899fbd1e06109ea2e4550f5751c88d6&quot;</ETag>
                <Size>1048576</Size>
            </Part>
            <Part>
                <PartNumber>3</PartNumber>
                <LastModified>2020-03-25T10:07:13.000Z</LastModified>
                <ETag>&quot;762890d6c9a871b7bd136037cb2260cd&quot;</ETag>
                <Size>1048576</Size>
            </Part>
            <StorageClass>Standard</StorageClass>
            <MaxParts>1000</MaxParts>
            <IsTruncated>false</IsTruncated>
</ListPartsResult>

中国站
目录