对象存储

对象存储

产品文档

对象存储

帮助中心 > OpenAPI & SDK > 对象存储 > ListMultipartUploads
搜本产品

ListMultipartUploads

List Multipart Uploads可以列出指定Bucket下还未完成的MultipartUpload，请求时可以通过一些查询条件来限制返回的结果。该操作最多返回10000个Multipart Upload。如果符合查询条件的结果超过10000个。超过10000个Multipart Upload，会返回 400错误，错误码返回 TooManyMultipartUploads。

请求语法

GET /BucketName?uploads HTTP/1.1
Host: BucketName.s-bj.jcloud.com
Date: GMT Date
Authorization: signatureValue

请求参数

名称 描述
prefix 限定返回的object key必须以prefix作为前缀。注意使用prefix查询时，返回的key中仍会包含prefix。
类型：字符串

响应元素

名称 描述
Bucket Bucket名称
类型：字符串
Key 初始化Multipart Upload事件的Object名字
类型：字符串
UploadId Multipart Upload事件的ID
类型：字符串
Initiated Multipart Upload事件初始化的时间
类型：日期
Enable-Encryption 是否对上传的内容进行加密
有效值：TRUE(进行加密)，FALSE(不进行加密)
类型：枚举字符串
StorageClass Object的存储类型，默认值是"STANDARD"（标准存储）
支持"STANDARD"（标准存储）和"REDUCED_REDUNDANCY"（低频访问型）两种存储类型
注意：目前"REDUCED_REDUNDANCY"（低频访问型）仅华北机房支持
类型：字符串
默认值："STANDARD"（标准存储）

细节分析

1."max-uploads"参数最大值为10000。

2.返回的结果按照Key和UploadId的字典序排序。

请求示例

GET   /?uploads HTTP/1.1
Date:   Wed, 12 Jul 2017 13:58:14 GMT
Authorization:   jingdong   298718BEDE59FF1B2E96A3152937D37B:YVbn+CqITQzQNRWzVKcxPq3V0PY=
Host: oss-test.s-bj.jcloud.com
Connection:   Keep-Alive

返回示例

HTTP/1.1 200 OK
Server: nginx
Date: Wed, 12 Jul 2017   13:58:14 GMT
Content-Type:   application/json;charset=UTF-8
Content-Length: 714
Connection: keep-alive
x-jss-request-id:   A9E0EE26B6EF677E
 
{"Bucket":"oss-test","Prefix":null,"Upload":[{"Key":"oss-test-mul1","UploadId":"97D11DAE98672320",
"Initiated":"Wed,   12 Jul 2017 13:58:02 GMT","Enable-Encryption":"false","Summary":null,"StorageClass":"STANDARD"},
{"Key":"oss-test-mul2","UploadId":"8238F7E35F3FFCFE","Initiated":"Wed,   12 Jul 2017 13:58:02   GMT",
"Enable-Encryption":"false","Summary":null,"StorageClass":"STANDARD"},{"Key":"oss-test-mul3",
"UploadId":"90895A4BB2A635DF","Initiated":"Wed,   12 Jul 2017 13:58:02   GMT",
"Enable-Encryption":"false","Summary":null,"StorageClass":"STANDARD"},
{"Key":"oss-test-mul4","UploadId":"857A7712C57EA243","Initiated":"Wed,   12 Jul 2017 13:58:02   GMT",
"Enable-Encryption":"false","Summary":null,"StorageClass":"STANDARD"}]}
更新时间：2021-12-03 12:22:45
feedback