全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

List Parts

最近更新时间:2022-12-30 15:48:03

描述

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

使用此接口,必须包含发送启动分块任务请求时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
默认值: 无

请求头部

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

响应

响应头部

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

除常用响应头部外,还返回x-kss-storage-class响应头,表示文件的类型。

名称 描述
x-kss-storage-class 用于说明Bucket文件类型。
标准存储不返回此响应头;低频存储返回STANDARD_IA ;归档存储返回ARCHIVE

响应内容

名称 描述
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>
文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈