List Parts

描述

此接口将会列出指定上传任务中所有已上传的块。

使用此接口，必须包含发送启动分块任务请求时KS3返回的 upload ID。 由于默认分块数上限为1000，所以该请求最多返回1000个已上传的块。用户可以指定 max-parts 来限制返回的块的数量。如果用户已上传的块数量超过1000，KS3返回的响应中 IsTruncated 的值将会为 true 并增加一个 NextPartNumberMarker 元素。在一个连续 List Parts 请求中，用户可以设置 part-number-marker 参数为之前一个请求返回响应的 NextPartNumberMarker 的值，完成连续列出分块。

请求

请求语法

GET /{ObjectKey}?uploadId={UploadId} HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {Date}
Authorization: {SignatureValue}

注意：

• endpoint与Region对应关系
• SignatureValue签名算法

请求参数

参数	描述	是否必选
encoding-type	指明请求KS3与KS3响应使用的编码方式。object key 可以包含任意Unicode字符。然而，XML 1.0解析器无法解析某些字符，如ASCII码中的0到10。对于这些不能被解析的字符可以添加到请求中，KS3会在响应中对他们进行编码。 类型: String 默认值: 无 有效值: url	否
uploadId	用于标识分块上传任务。 类型: String 默认值: 无	是
max-parts	设置响应体中块的上限数量。 类型: String 默认值: 1,000	否
part-number-marker	指定应该从哪个块开始列举。只有比设定值大的块才会被列举。 类型: String 默认值: 无	否

请求头部

该请求只使用常用请求头部。获取更多信息，请点击常用请求头部。

响应

响应头部

该接口使用常用响应头部。获取更多信息，请点击常用响应头部。

响应内容

名称	描述
ListPartsResult	响应信息的容器。 子节点: Bucket, Key, UploadId, Initiator, Owner, StorageClass,PartNumberMarker, NextPartNumberMarker, MaxParts, IsTruncated, Part 类型: Container
Bucket	启动分块上传任务的空间的名称。 类型: String 父节点: ListPartsResult
Encoding-Type	KS3发送的XML响应中 object key的编码方式。如果用户指定了一种编码方式，那么KS3响应中将会对 object key 使用用户指定的编码方式进行编码。 类型: String 父节点: ListBucketResult
Key	启动分块上传任务的对象的 object key。 类型: String 父节点: ListPartsResult
UploadId	用于标识分块上传任务。 类型: String 父节点: ListPartsResult
Initiator	包含分块上传任务发起人的信息的容器。 子节点: ID, DisplayName 类型: Container 父节点: ListPartsResult
ID	Object拥有者或被授权者用户ID的Base64编码。 类型: String 父节点: Initiator
DisplayName	Object拥有者或被授权者用户ID的Base64编码。 类型: String 父节点: Initiator
Owner	标识对象拥有者信息的容器。 子节点: ID, DisplayName 类型: Container 父节点: ListPartsResult
StorageClass	上传对象的存储方式。 类型: String 说明：标准存储返回STANDARD；低频存储返回STANDARD_IA ；归档存储返回ARCHIVE 父节点: ListPartsResult
PartNumberMarker	列举块的开始位置。 类型: Integer 父节点: ListPartsResult
NextPartNumberMarker	当一个列表被截断了，该参数指定最后一个块的序号，可以用来在连续列举块请求中设置 part-number-marker 值。 类型: Integer 父节点: ListPartsResult
MaxParts	响应体中块的上限数量。 类型: Integer 父节点: ListPartsResult
IsTruncated	标识列表是否完整。如果上传的块数超过了 MaxParts，那么这个列表应该是被截断的。 类型: Boolean 父节点: ListPartsResult
Part	包含某个指定块的信息的容器。响应中可以包含0个或多个块容器。 子节点: PartNumber, LastModified, ETag, Size 类型: String 父节点: ListPartsResult
PartNumber	标识块的块序列号。 类型: Integer 父节点: Part
LastModified	指定块最后一个完成上传的时间。 类型: Date 父节点: Part
ETag	块上传完成后返回的实体标签。 类型: String 父节点: Part
Size	块的大小。 类型: Integer 父节点: Part

特殊错误

该请求不返回任何特殊错误。

示例

请求示例

GET /test111?uploadId=31286aadcfae40cab7fa495c4ced284e&max-parts=2&part-number-marker=2 HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyun.com
Date: Mon, 1 Nov 2010 20:34:56 GMT
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
Date: Mon, 1 Nov 2010 20:34:56 GMT
Content-Length: 985
Connection: keep-alive
x-kss-request-id: f86oot80he2obs6odlib7no5lkalr0qg
Server: KS3

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:ListPartsResult xmlns:ns2="http://s3.amazonaws.com/doc/2006-03-01/">
    <ns2:Bucket>ywj-ks3-apitest4</ns2:Bucket>
    <ns2:Key>test111</ns2:Key>
    <ns2:UploadId>31286aadcfae40cab7fa495c4ced284e</ns2:UploadId>
    <ns2:PartNumberMarker>2</ns2:PartNumberMarker>
    <ns2:NextPartNumberMarker>4</ns2:NextPartNumberMarker>
    <ns2:MaxParts>2</ns2:MaxParts>
    <ns2:Part>
        <PartNumber>3</PartNumber>
        <ETag>9bfaca6daec296b39e006f3495f80b62</ETag>
        <LastModified>2022-11-16T06:27:34.474Z</LastModified>
        <Size>106755</Size>
    </ns2:Part>
    <ns2:Part>
        <PartNumber>4</PartNumber>
        <ETag>9bfaca6daec296b39e006f3495f80b62</ETag>
        <LastModified>2022-11-16T06:27:37.700Z</LastModified>
        <Size>106755</Size>
    </ns2:Part>
    <ns2:IsTruncated>false</ns2:IsTruncated>
    <ns2:Initiator>
        <ns2:ID>NzM0MDQwNjA=</ns2:ID>
        <ns2:DisplayName>NzM0MDQwNjA=</ns2:DisplayName>
    </ns2:Initiator>
    <ns2:Owner>
        <ns2:ID>NzM0MDQwNjA=</ns2:ID>
        <ns2:DisplayName>NzM0MDQwNjA=</ns2:DisplayName>
    </ns2:Owner>
    <ns2:StorageClass>STANDARD</ns2:StorageClass>
</ns2:ListPartsResult>