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}.kss.ksyun.com
Date: Date
Authorization: authorization string

请求参数

参数	描述	必须
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	用户ID 类型: String 父节点: Initiator
DisplayName	用户的显示名称。类型: String 父节点: Initiator
Owner	标识对象拥有者信息的容器。子节点: ID, DisplayName 类型: Container 父节点: ListPartsResult
StorageClass	上传对象的存储方式（暂时仅支持标准存储）。类型: String 父节点: 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 /{ObjectKey}?uploadId={UploadId}&max-parts={max-parts}&part-number-marker={part-number-marker} HTTP/1.1
Host: {BucketName}.kss.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>example-bucket</Bucket>
  <Key>example-object</Key>
  <UploadId>27965feb8b60cc1aa9cfad5e2e405c8f</UploadId>
  <Initiator>
      <ID>NzM0MDAyMjE=</ID>
      <DisplayName>NzM0MDAyMjE=</DisplayName>
  </Initiator>
  <Owner>
    <ID>NzM0MDAyMjE=</ID>
    <DisplayName>NzM0MDAyMjE=</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>