List Parts

最近更新时间:2019-01-14 10:10:58

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}

注意:

请求参数

参数 描述 必须
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
默认值: 无

请求头部

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

响应

响应头部

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

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

名称 描述
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 用户ID
类型: String
父节点: Initiator
DisplayName 用户的显示名称。
类型: 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 /my-video.rm ?uploadId=1aa9cfad5e2e405c8f27965feb8b60cc &max-parts=2 &part-number-marker=1 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
Server: Tengine

<?xml version="1.0" encoding="UTF-8"?>
<ListPartsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Bucket>ks3-example</Bucket>
    <Key>my-video.rm</Key>
    <UploadId>1aa9cfad5e2e405c8f27965feb8b60cc</UploadId>
    <Initiator>
        <ID>73410125</ID>
        <DisplayName>ks3@kingsoft.com</DisplayName>
    </Initiator>
    <Owner>
        <ID>73410125</ID>
        <DisplayName>ks3@kingsoft.com</DisplayName>
    </Owner>
    <StorageClass>STANDARD</StorageClass>
    <PartNumberMarker>1</PartNumberMarker>
    <NextPartNumberMarker>3</NextPartNumberMarker>
    <MaxParts>2</MaxParts>
    <IsTruncated>true</IsTruncated>
    <Part>
        <PartNumber>2</PartNumber>
        <LastModified>2010-11-10T20:48:34.000Z</LastModified>
        <ETag>7778aef83f66abc1fa1e8477f296d394</ETag>
        <Size>10485760</Size>
    </Part>
    <Part>
        <PartNumber>3</PartNumber>
        <LastModified>2010-11-10T20:48:33.000Z</LastModified>
        <ETag>aaaa18db4cc2f85cedef654fccc4a4x8</ETag>
        <Size>10485760</Size>
    </Part>
</ListPartsResult>

金山云,开启您的云计算之旅

立即注册