全部文档
当前文档

暂无内容

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

文档中心

List Multipart Uploads

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

描述

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

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

请求

语法

GET /?uploads HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}

注意:

请求参数

参数 描述 是否必选
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,此参数将被忽略。
如果设置了key-marker,查询结果中将包含:
    - 所有key按照词典顺序比key-marker 参数值大的任务。
    - key等于key-marker参数值,但是upload IDupload-id-marker参数值大的任务。
类型: String
默认值: 无
key-marker upload-id-marker配合使用,指定列举目标空间中正在进行分块上传任务的起始位置。
如果未设置upload-id-marker,则只会列出所有key按照词典顺序比key-marker参数值大的任务。
如果设置了upload-id-marker,查询结果中将包含:
    - 所有key按照词典顺序比key-marker参数值大的任务。
    - key等于key-marker参数值,但是upload IDupload-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 Object拥有者或被授权者ID的base64编码。
类型:String
父节点:Initiator,Owner
DisplayName Object拥有者或被授权者ID的base64编码。
类型: String
父节点: Initiator,Owner
Owner 用户空间拥有者信息。
类型: String
子节点: DisplayName, ID
父节点: Upload
StorageClass 上传对象的存储方式。
类型: String
说明:标准存储返回STANDARD;低频存储返回STANDARD_IA ;归档存储返回ARCHIVE
类型: String
父节点: Upload
Initiated 分块上传任务启动时的时间和日期。
类型:Date
父节点:Upload
ListMultipartUploadsResult.Prefix 对象 key 中指定的前缀。
类型: String
父节点: ListMultipartUploadsResult
Delimiter 分隔符,用于分割参数。分割后便于确定公共前缀。
类型: String
父节点: ListMultipartUploadsResult
CommonPrefixes 当用户指定分隔符后,KS3会返回他们的公共前缀。实际上,公共前缀包括的值类似于文件目录中的同一个目录下的子目录。值的数量不能超过上限数量。例如:指定分隔符为 /,对于notes/summer/a.txtnotes/summer/b.xml,其公共前缀为 notes/summer/
类型: String
父节点: ListMultipartUploadsResult
CommonPrefixes.Prefix 如果设定了 Prefix 参数,则此参数的值将为Prefix后开始到第1个分隔符止,否则从头开始到指定分隔符为止。
类型: String
父节点:CommonPrefixes

特殊错误

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

示例

请求示例

GET /?uploads&max-uploads=3 HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
Date: Mon, 1 Nov 2010 20:34:56 GMT
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
Date: Mon, 1 Nov 2014 20:34:56 GMT
Content-Length: 1330
Connection: keep-alive
x-kss-request-id: 656c76696e6727732072657175657374
Server: KS3

<?xml version="1.0" encoding="UTF-8"?>
<ListMultipartUploadsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Bucket>ks3-example</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>MjAwMDEwMz****</ID>
      <DisplayName>MjAwMDEwMz****</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>MjAwMDEwMz****</ID>
      <DisplayName>MjAwMDEwMz****</DisplayName>
    </Initiator>
    <Owner>
      <ID>MjAwMDEwMz****</ID>
      <DisplayName>MjAwMDEwMz****</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>MjAwMDEwMz****</ID>
      <DisplayName>MjAwMDEwMz****</DisplayName>
    </Initiator>
    <Owner>
     <ID>MjAwMDEwMz****</ID>
     <DisplayName>MjAwMDEwMz****</DisplayName>
    </Owner>
    <StorageClass>STANDARD</StorageClass>
    <Initiated>2014-11-10T20:49:33.000Z</Initiated>
  </Upload>
</ListMultipartUploadsResult>

接口细节分析

  • 通过该接口可以把bucket下正在进行的分块上传罗列出来。对于很久之前初始化,且无人再使用的分块上传,建议调用Abort Multipart Upload接口删除。
文档导读
纯净模式常规模式

纯净模式

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