接口描述

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

请求（Request）

• 请求语法

  Plain Text 复制

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

• 请求头域

  无特殊要求头域

• 请求参数

名称	类型	参数位置	描述	是否必需
delimiter	String	Query参数	分隔符;主要应此项实现list文件夹的逻辑	否
keyMarker	String	Query参数	与uploadIdMarker参数配合使用，用于指定返回结果的起始位置。 如果未设置uploadIdMarker参数，Object按照字典序排序后，本次从keyMarker的后面的一条开始返回。 如果设置了uploadIdMarker参数，查询结果中包含： 所有Object名称的字典序大于keyMarker参数值的Multipart Upload事件。 Object名称等于keyMarker参数值，但是UploadId比uploadIdMarker参数值大的Multipart Upload事件。	否
uploadIdMarker	String	Query参数	与keyMarker参数配合使用，用于指定返回结果的起始位置。 如果未设置keyMarker参数，则BOS会忽略uploadIdMarker参数。 如果设置了keyMarker参数，查询结果中包含： 所有Object名称的字典序大于keyMarker参数值的Multipart Upload事件。 Object名称等于keyMarker参数值，但是UploadId比uploadIdMarker参数值大的Multipart Upload事件。	否
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	本次请求指定的object的起始位置
uploadIdMarker	String	本次请求指定的uploadId的起始位置。
maxUploads	Int	请求指定的本次返回的Multipart Uploads的最大数目
nextKeyMarker	String	如果本次没有返回全部结果，响应请求中将包含nextKeyMarker元素，用于表示接下来请求的keyMarker值。
nextUploadIdMarker	String	如果本次没有返回全部结果，响应请求中将包含nextUploadIdMarker元素，用于表示接下来请求的uploadIdMarker值
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的接口说明。

示例

• 请求示例

  Plain Text 复制

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

• 响应示例（JSON）

  Plain Text 复制

  1HTTP/1.1 200 OK
  2x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
  3Date: Wed, 06 Apr 2016 06:34:40 GMT
  4Content-Length: 1330
  5Connection: keep-alive
  6Server: BceBos
  7
  8{
  9    "bucket": "bucket",
  10    "keyMarker": "",
  11    "nextKeyMarker": "my-movie.m2ts",
  12    "nextUploadMarker": "c41cc9aad11cbd637851767bab156984",
  13    "maxUploads": 3,
  14    "isTruncated": true,
  15    "uploads": [
  16        {
  17            "key": "my-divisor",
  18            "uploadId": "a44cc9bab11bdc157676984aad851637",
  19            "owner": {
  20                "id": "75aa57f09aa0c8caeab4aeebf76c078efc7c6caea54ba06a",
  21                "displayName": "OwnerDisplayName"
  22            },
  23            "initiated": "2010-11-10T20:48:33Z",
  24            "storageClass": "STANDARD_IA"
  25        },
  26        {
  27            "key": "my-movie",
  28            "uploadId": "b44cc9bab11cbd156984767aad637851",
  29            "owner": {
  30                "id": "b1d16700c70b0b05597d7acd6a3f92be",
  31                "displayName": "OwnerDisplayName"
  32            },
  33            "initiated": "2010-11-10T20:48:33Z",
  34            "storageClass": "STANDARD"
  35        },
  36        {
  37            "key": "my-movie.m2ts",
  38            "uploadId": "b41cc9aad11cbd637851767bab156984",
  39            "owner": {
  40                "id": "b1d16700c70b0b05597d7acd6a3f92be",
  41                "displayName": "OwnerDisplayName"
  42            },
  43            "initiated": "2010-11-10T10:49:33Z",
  44            "storageClass": "STANDARD_IA"
  45        },
  46        {
  47            "key": "my-movie.m2ts",
  48            "uploadId": "c41cc9aad11cbd637851767bab156984",
  49            "owner": {
  50                "id": "b1d16700c70b0b05597d7acd6a3f92be",
  51                "displayName": "OwnerDisplayName"
  52            },
  53            "initiated": "2010-11-10T20:49:33Z",
  54            "storageClass": "STANDARD_IA"
  55        }
  56    ]
  57}