List Multipart Uploads

描述

此 List 操作将会列出所有正在进行的分块上传任务。正在进行的分块上传任务是指那些已经启动，却没有放弃或完成的分块上传任务。

在一次响应中，此操作最多返回1000（默认值）个分块上传任务。用户可以使用 max-uploads 参数来限定最大值。如果用户空间中正在进行的分块上传任务数大于此操作设定的最大值，响应中将会将 IsTruncated 元素设为 true。用户可以使用 key-marker 和 upload-id-marker 参数来列出未列出的任务。

请求

语法

GET /?uploads HTTP/1.1
Host: {BucketName}.kss.ksyun.com
Date: date
Authorization: authorization string

请求参数

参数	描述	必需
delimiter	分隔符，用于对一组参数进行分割的字符。类型: String 默认值: 无	否
encoding-type	指明请求KS3与KS3响应使用的编码方式。`object key` 可以包含任意Unicode字符。然而，XML 1.0解析器无法解析某些字符，如ASCII码中的0到10。对于这些不能被解析的字符可以添加到请求中，KS3会在响应中对他们进行编码。类型: String 默认值: 无有效值: url	否
max-uploads	限定要列出正在进行任务的最大值([1,1000])。响应中将会在响应体中返回其值。类型: Integer 默认值: 1000	否
upload-id-marker	与`key-marker`一起使用，指定列举指定空间中正在进行分块上传任务的起始位置。如果 `key-marker` 没有指定，此参数将被忽略。否则将只会列出 `upload ID` 比设定的大的任务。类型: String 默认值: 无	否
key-marker	与 `upload-id-marker` 一起使用，指定列举指定空间中正在进行分块上传任务的起始位置。如果 `upload-id-marker` 没有指定，则只会列出 `key` 按照词典顺序比给定的 `key-marker` 大的任务。如果 `upload-id-marker` 被指定了，那么将列出 `key` 等于给定的 `key-marker` 或被包含且上传ID大于指定的 `upload-id-marker` 的任务。类型: String 默认值: 1000	否
prefix	限定响应结果列表使用的前缀，正如你在电脑中使用的文件夹一样。类型: String 默认值: 无	否

请求头部

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

请求内容

该接口不使用请求内容。

响应

响应头部

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

响应内容

名称	描述
ListMultipartUploadsResult	响应内容的容器。类型: Container 子节点:`Bucket`, `KeyMarker`, `UploadIdMarker`, `NextKeyMarker`, `NextUploadIdMarker`, `MaxUploads`, `Delimiter`, `Prefix`, `CommonPrefixes`, `IsTruncated` 父节点: 无
Bucket	启动分块上传任务的用户空间名称。类型：String 父节点: ListMultipartUploadsResult
KeyMarker	列表开始位置的 `Key` 。类型：String 父节点: ListMultipartUploadsResult
UploadIdMarker	列表开始位置的 `upload ID`。类型：String 父节点: ListMultipartUploadsResult
NextKeyMarker	在一个连续列表请求中，如果列表是被截断的，应该通过设定 `key-marker` 值来返回下次列表开始位置。类型：String 父节点: ListMultipartUploadsResult
NextUploadIdMarker	在一个连续列表请求中，如果列表是被截断的，应该通过设定 `upload-id-marker` 值来返回下次列表开始位置类型：String 父节点: ListMultipartUploadsResult
Encoding-Type	KS3响应中对对象名称的编码方式。类型: String 父节点: ListBucketResult
MaxUploads	响应中列表应包含的最大条目数。类型：Integer 父节点: ListMultipartUploadsResult
IsTruncated	是否被截断。如果对象列表记录数超过了设定的最大值，那么将会被截断。类型: BooleanAncestor: ListMultipartUploadsResult
Upload	包含某个特定分块上传任务信息的容器。响应中应包含0个或多个 `Upload` 元素。类型：Container 子节点：`Key`, `UploadId`, `InitiatorOwner`, `StorageClass`, `Initiated` 父节点: ListMultipartUploadsResult
Key	分块上传任务上传对象的 `key`。类型: Integer 父节点: Upload
UploadID	分块上传任务的ID。类型: Integer 父节点: Upload
Initiator	包含分块上传任务发起人信息的容器。类型：Container 子节点: ID, DisplayName 父节点: Upload
ID	用户ID。类型：String 父节点：Initiator,Owner
DisplayName	发起人或拥有者的名称。类型: String 父节点: Initiator,Owner
Owner	用户空间拥有者信息。类型: String 子节点: DisplayName, ID 父节点: Upload
StorageClass	存储方式，包括： STANDARD 类型: String 父节点: Upload
Initiated	分块上传任务启动时的时间和日期。类型：Date 父节点：Upload
ListMultipartUploadsResult.Prefix	对象 `key` 中指定的前缀。类型: String 父节点: ListMultipartUploadsResult
Delimiter	分隔符，用于分割参数。分割后便于确定公共前缀。类型: String 父节点: ListMultipartUploadsResult
CommonPrefixes	当用户指定分隔符后，KS3会返回他们的公共前缀。实际上，公共前缀包括的值类似于文件目录中的同一个目录下的子目录。值的数量不能超过最大数量。例如：指定分隔符为 `/`,对于`notes/summer/a.txt` 和 `notes/summer/b.xml`，其公共前缀为 `notes/summer/`。类型: String 父节点: ListMultipartUploadsResult
CommonPrefixes.Prefix	如果设定了 `Prefix` 参数，则此参数的值将为`Prefix`后开始到第一个分隔符止，否则从头开始到第一个分隔符止。类型: String 父节点:CommonPrefixes

特殊错误

该接口不返回任何特殊错误。

示例

请求示例

GET /?uploads&max-uploads=3 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
x-kss-request-id: 656c76696e6727732072657175657374
Date: Mon, 1 Nov 2014 20:34:56 GMT
Content-Length: 1330
Connection: keep-alive
Server: KS3

<?xml version="1.0" encoding="UTF-8"?>
<ListMultipartUploadsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Bucket>bucket</Bucket>
  <KeyMarker></KeyMarker>
  <UploadIdMarker></UploadIdMarker>
  <NextKeyMarker>my-movie.m2ts</NextKeyMarker>
  <NextUploadIdMarker>YW55IGlkZWEgd2h5IGVsdmluZydzIHVwbG9hZCBmYWlsZWQ</NextUploadIdMarker>
  <MaxUploads>3</MaxUploads>
  <IsTruncated>true</IsTruncated>
  <Upload>
    <Key>my-divisor</Key>
    <UploadId>f9957b016aaf37c7569c91fd14501847</UploadId>
    <Initiator>
      <ID>KS3UserId</ID>
      <DisplayName>Ks3User</DisplayName>
    </Initiator>
    <Owner>
      <ID> KS3UserId</ID>
      <DisplayName> Ks3User</DisplayName>
    </Owner>
    <StorageClass>STANDARD</StorageClass>
    <Initiated>2014-11-10T20:48:33.000Z</Initiated>  
  </Upload>
  <Upload>
    <Key>my-movie.m2ts</Key>
    <UploadId>f9957b016aaf37c7569c91fd14501847</UploadId>
    <Initiator>
      <ID> KS3UserId</ID>
      <DisplayName> Ks3User</DisplayName>
    </Initiator>
    <Owner>
      <ID> KS3UserId</ID>
      <DisplayName> Ks3User</DisplayName>
    </Owner>
    <StorageClass>STANDARD</StorageClass>
    <Initiated>2014-11-10T20:48:33.000Z</Initiated>
  </Upload>
  <Upload>
    <Key>my-movie.m2ts</Key>
    <UploadId>f9957b016aaf37c7569c91fd14501847</UploadId>
    <Initiator>
      <ID> KS3UserId</ID>
      <DisplayName> Ks3User</DisplayName>
    </Initiator>
    <Owner>
      <ID>b1d16700c70b0b05597d7acd6a3f92be</ID>
      <DisplayName>OwnerDisplayName</DisplayName>
    </Owner>
    <StorageClass>STANDARD</StorageClass>
    <Initiated>2014-11-10T20:49:33.000Z</Initiated>
  </Upload>
</ListMultipartUploadsResult>

接口细节分析

通过该接口可以把bucket下正在进行的分块上传罗列出来。对于很久之前初始化，且无人再使用的分块上传，建议调用Abort Multipart Upload接口删除。