此接口将会列出指定上传任务中所有已上传的块。
使用此接口,必须包含发送启动分块任务请求时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}
注意:
参数 | 描述 | 是否必选 |
---|---|---|
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>
文档内容是否对您有帮助?
评价建议不能为空
非常感谢您的反馈,我们会继续努力做到更好!