ListMultipartUploads

接口描述

此命令用于列出指定Bucket下面的所有未执行完成的Multipart Upload。“未执行完”是指完成了InitMultipartUpload，但是还没有调用CompleteMultipartUpload或AbortMultipartUpload的Multipart Upload。每次BOS最多返回1000个Multipart Upload，BOS支持prefix和delimiter过滤。

请求（Request）

• 请求语法

  GET /?uploads HTTP/1.1
  Host: <BucketName>.bj.bcebos.com
  Date: <Date>
  Authorization: <Authorization_String>

• 请求头域

  无特殊要求头域

• 请求参数

  名称	类型	参数位置	描述	是否必需
  delimiter	String	Query参数	分隔符; 主要应此项实现list文件夹的逻辑	否
  keyMarker	String	Query参数	Object按照字典序排序后，本次从keyMarker的后面的一条开始返回	否
  maxUploads	Int	Query参数	本次请求返回Multipart Uploads的最大数目,默认1000，最大1000	否
  prefix	String	Query参数	key前缀，限定返回的object key必须以此为前缀	否
  uploads	String	Query参数	标明请求是 ListMultipartUploads	是

响应（Response）

• 响应头域

  无特殊头域

• 响应元素

名称	类型	描述
bucket	String	所属Bucket名称
commonPrefixes	-	如果在请求的时候指定了delimiter，将返回此项。BOS把匹配到的Object名称 按照一定规则（从preifx到第一个delimiter）截取，截取的字符串去重作为CommonPrefixes的数据返回
delimiter	String	返回请求中的delimiter值
prefix	String	object前缀
isTruncated	Bool	标明是否本次是否没有返回所有的数据。 true表示本次没有返回全部结果； false表示本次已经返回了全部结果
keyMarker	String	请求指定的本次返回的MultipartUpload的起始位置
maxUploads	Int	请求指定的本次返回的Multipart Uploads的最大数目
nextKeyMarker	String	本次返回的最后一条MultipartUpload，可以作为下一次请求的KeyMarker
uploads	Container	保存一个MultipartUpload的容器
+key	String	Object名称
+uploadId	String	MultipartUpload的ID
+owner	Container	Object所属的用户信息
++displayName	String	用户名
++id	String	用户ID
+initiated	Date	本次MultipartUpload开始时间
+storageClass	String	Object的存储类型，低频存储返回STANDARD_IA，冷存储返回COLD，标准存储返回STANDARD，归档类型返回ARCHIVE；如果是多AZ类型bucket，多AZ低频存储返回MAZ_STANDARD_IA，多AZ标准存储返回MAZ_STANDARD。

> **注意事项**：此处的Delimiter跟ListObjects的类似，可以参考ListObjects的接口说明。

示例

• 请求示例

  GET /?uploads HTTP/1.1
  Host: BucketName.bj.bcebos.com
  Date: Wed, 06 Apr 2016 06:34:40 GMT
  Authorization: AuthorizationString

• 响应示例（JSON）

  HTTP/1.1 200 OK
  x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
  Date: Wed, 06 Apr 2016 06:34:40 GMT
  Content-Length: 1330
  Connection: keep-alive
  Server: BceBos
  
  {
    "bucket":"bucket",
    "keyMarker":"",
    "nextKeyMarker":"my-movie.m2ts",
    "maxUploads":3,
    "isTruncated":true,
    "uploads": [
        {
            "key":"my-divisor",
            "uploadId":"a44cc9bab11bdc157676984aad851637",
            "owner":{
                "id":"75aa57f09aa0c8caeab4aeebf76c078efc7c6caea54ba06a",
                "displayName":"OwnerDisplayName"
            },
            "initiated":"2010-11-10T20:48:33Z"
            "storageClass" : "STANDARD_IA",
        },
        {
            "key":"my-movie",
            "uploadId":"b44cc9bab11cbd156984767aad637851",
            "owner":{
                "id":"b1d16700c70b0b05597d7acd6a3f92be",
                "displayName":"OwnerDisplayName"
            },
            "initiated":"2010-11-10T20:48:33Z"
            "storageClass" : "STANDARD",
        },
        {
            "key":"my-movie.m2ts",
            "uploadId":"c41cc9aad11cbd637851767bab156984",
            "owner":{
                "id":"b1d16700c70b0b05597d7acd6a3f92be",
                "displayName":"OwnerDisplayName"
            },
            "initiated":"2010-11-10T20:49:33Z"
            "storageClass" : "STANDARD_IA",
        }
    ]
  }