列举分片上传事件

该接口用来列举正在执行中的分片上传事件,即已经初始化但还未完成或者终止的分片上传事件。

请求

  • 请求语法

    • 内容

        Get /?uploads HTTP/1.1
        Host: {BucketName}.{Endpoint}
        Date: {date}
        Authorization: SignatureValue
      
    • 描述

        Endpoint:参考与region地域的关系
        SignatureValue:参考签名算法
      
  • 请求参数

该请求支持delimiter、max-uploads、key-marker、prefix、upload-id-marker参数,通过组合参数,可以设定查询规则。

名称 类型 描述
delimiter 字符串 分隔符,即对object名字进行分组的字符。从指定的前缀prefix到第一次出现delimiter字符之间的内容作为一组元素(即CommonPrefixes)。
max-uploads 字符串 限定此次列举分片上传事件最大的返回数目,默认为1000,且取值不能大于1000。
key-marker 字符串 与upload-id-marker参数一同使用来指定返回结果的起始位置。
如果已设置upload-id-marker,查询结果中包含所有Object名字的字典序大于key-marker的分片上传事件。
如果未设置upload-id-marker,查询结果中包含:
(1) 所有Object名字的字典序大于key-marker的分片上传事件;
(2)Object名字等于key-marker参数值,但是Upload ID比upload-id-marker参数值大的分片上传事件。
prefix 字符串 限定返回的object key必须以prefix作为前缀。
upload-id-marker 字符串 与key-marker参数一同使用来指定返回结果的起始位置。
如果已设置upload-id-marker,查询结果中包含所有Object名字的字典序大于key-marker的分片上传事件。
如果未设置upload-id-marker,查询结果中包含:
(1) 所有Object名字的字典序大于key-marker的分片上传事件;
(2)Object名字等于key-marker参数值,但是Upload ID比upload-id-marker参数值大的分片上传事件。
encoding-type 字符串 指定对返回内容编码的类型。默认值:无

响应

  • 非公共响应头

  • 响应体

名称 类型 描述
ListMultipartUploadsResult 容器 存放响应元素。
子节点:Bucket, KeyMarker, UploadIdMarker, NextKeyMarker, NextUploadIdMarker, MaxUploads, Delimiter, Prefix, CommonPrefixes, IsTruncated
父节点:无
Bucket 字符串 存储桶的名称。
父节点:ListMultipartUploadsResult
KeyMarker 字符串 指定返回结果中Object的起始位置。
父节点:ListMultipartUploadsResult
UploadIdMarker 字符串 指定返回结果中UploadID的起始位置。
父节点:ListMultipartUploadsResult
NextKeyMarker 字符串 本次列举没有返回全部结果时,会标记列表被截(IsTruncated=true),同时返回最后一个object的名称。如果IsTruncated为true,则可以使用NextKeyMarker作为下次list的marker参数。
父节点:ListMultipartUploadsResult
NextUploadIdMarker 字符串 如果列表被截断,此元素在后续请求中标记请求参数。
父节点:ListMultipartUploadsResult
Encoding-Type 字符串 对返回的内容进行编码,指定编码的类型。默认值:无
父节点: ListBucketResult
MaxUploads 字符串 限定此次返回分片上传事件的最大数目,默认为1000,且取值不能大于1000。
父节点:ListMultipartUploadsResult
IsTruncated 枚举字符串 请求中返回的结果是否被截断。有效值:true表示本次没有返回全部结果,false表示本次已经返回了全部结果。
父节点:ListMultipartUploadsResult
Upload 容器 存放分片上传的元素。
子节点:Key, UploadId, InitiatorOwner, StorageClass, Initiated
父节点:ListMultipartUploadsResult
Key 字符串 对象的名称。
父节点:Upload
UploadId 字符串 上传事件的标识符。
父节点:Upload
Initiator 容器 任务的创建者。
子节点:ID, DisplayName
父节点:Upload
ID 字符串 创建者的ID。
父节点:Initiator, Owner
DisplayName 字符串 创建者的DisplayName。
子节点:ID, DisplayName
父节点:Upload
Owner 容器 对象的拥有者。
子节点:ID, DisplayName
父节点:Upload
StorageClass 字符串 表明待分片上传的对象存储类型。
父节点:Upload
Initiated 字符串 Multipart Upload任务的初始化时间。
父节点:Upload
ListMultipartUploadsResult.Prefix 字符串 请求中的Prefix。
父节点:ListMultipartUploadsResult
Delimiter 字符串 分隔符,即对object名字进行分组的字符。从指定的前缀prefix到第一次出现delimiter字符之间的内容作为一组元素(即CommonPrefixes)。
父节点:ListMultipartUploadsResult
CommonPrefixes 容器 请求中带Delimiter参数时,返回消息带CommonPrefixes分组信息。
父节点:ListMultipartUploadsResult
CommonPrefixes. Prefix 字符串 CommonPrefixes分组信息中的Prefix。
父节点:CommonPrefixes

示例

  • 请求
          Get /?uploads  HTTP/1.1
          Host:oss-example.oss-cn-beijing.inspurcloud.com
          Date: Thu, 13 Feb 2019 15:14:62 GMT
          Authorization: OSS qDKLKLFJrqxo2oawuk53otfjbyc:JX75CtQqsmBBz+dciGHHDJHGS
    
  • 响应

          HTTP/1.1 200 OK
          x-amz-id-2: 6522JHGGDDyRx9e6j5Onimru9pO4ZVKnJ2Qz7/C1NPcfTGJHKEFHJKK==
          x-amz-request-id: 66548948419696e672773207255646544564165
          Date: Mon, 5 Nov 2019 10:34:42 GMT
          Content-Length: 1330
          Connection: keep-alive
    
          <?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>test1.m2ts</NextKeyMarker>
          <NextUploadIdMarker>YGGFDFJKIKgd2h5IGVsd58424GVGHVwbG9hZCBmJKYHFGFDF</NextUploadIdMarker>
          <MaxUploads>3</MaxUploads>
          <IsTruncated>true</IsTruncated>
          <Upload>
              <Key>test2</Key>
              <UploadId>XmcncyBuVjawMgbGlrZSBlbHb3QgaGF2aW5nIG11Y2ggbHZpb</UploadId>
              <Initiator>
                  <ID>user1</ID>
                  <DisplayName>user1</DisplayName>
              </Initiator>
              <Owner>
                  <ID>7ca9d10f8e7faea0c8caeab4f8c24e9c078efc7c6ebf76ea55aa57f09a4ba06a</ID>
                  <DisplayName>OwnerDisplayName</DisplayName>
              </Owner>
              <StorageClass>STANDARD</StorageClass>
              <Initiated>2019-11-10T20:48:33.000Z</Initiated>  
          </Upload>
          <Upload>
              <Key>test2</Key>
              <UploadId>VXBsb2FkIElEIZpbmcncyBteS1tZvciBlbHS5tMnRzIHG9hZAVwb3ZpZGb</UploadId>
              <Initiator>
                  <ID>b7000b05591d167d7ac70bcd6a3f92be</ID>
                  <DisplayName>InitiatorDisplayName</DisplayName>
              </Initiator>
              <Owner>
                  <ID>d16700c452597d70b056a3f92be</ID>
                  <DisplayName>OwnerDisplayName</DisplayName>
              </Owner>
              <StorageClass>STANDARD</StorageClass>
              <Initiated>2019-11-10T20:48:33.000Z</Initiated>
          </Upload>
          <Upload>
              <Key>test3</Key>
              <UploadId>lksdmlbG9hZCBmYWlsuZYW55IGydzIHZWEgd2h5IGVVwZWQ</UploadId>
              <Initiator>
                  <ID>user1</ID>
                  <DisplayName>user1</DisplayName>
              </Initiator>
              <Owner>
                  <ID>user1</ID>
                  <DisplayName>OwnerDisplayName</DisplayName>
              </Owner>
              <StorageClass>STANDARD</StorageClass>
              <Initiated>2019-11-10T20:49:33.000Z</Initiated>
          </Upload>
          </ListMultipartUploadsResult>
    

错误码

错误码 描述 状态码 描述
... ... ... ...