ListMultipartUploads
更新时间 2026-04-10 20:11:10
最近更新时间: 2026-04-10 20:11:10
功能说明
ListMultipartUploads用来查询所有正在进行中的分段上传，也就是已经初始化但是还没有终止或者结束的分段上传数据，单次最多列出1000个正在进行中的分段上传。
请求消息样式
GET /{Bucket}?uploads&max-uploads=123&prefix=obj&key-marker=0 HTTP/1.1
Host: xxx.zos.ctyun.cn
x-amz-content-SHA256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b85
x-amz-Date: 20220406T063538Z
Authorization: AWS4-HMAC-SHA256 Credential=base/20220406/us-east-1/s3/aws4_request, SignedHeaders=host;x-amz-acl;x-amz-content-sha256;x-amz-date;x-amz-storage-class;x-amz-tagging, Signature=4f31f3b56e248aa32b165005714448c3fe30b38a76e1c3cdeac11bf5d8314963 请求消息参数
| 参数名称 | 描述 | 类型 | 是否必须 |
|---|---|---|---|
| Bucket | 参数解释： Bucket名称。 | String | 是 |
| max-uploads | 参数解释： 单次最多返回的分段上传数据。 取值范围： 1-1000，超过1000的数据会被视为1000。 默认值： 1000 | Long | 否 |
| prefix | 参数解释： key的前缀，只有以prefix为开头的key才会被返回。 | String | 否 |
| key-marker | 参数解释： 只有key大于key-marker的分段上传数据才会返回。 | String | 否 |
请求消息头
该请求使用公共的请求消息头，请参见如何调用API-构造请求-请求消息头。
请求消息元素
该请求消息中不带消息元素。
响应消息样式
HTTP/1.1 Status Code
Transfer-Encoding: chunked
x-amz-request-id: tx00000000000000000004e-00624d61a0-5403f-default
Content-Type: application/xml
Date: Wed, 06 Apr 2022 09:47:12 GMT
Connection: Keep-Alive
<?xml version="1.0" encoding="UTF-8"?>
<ListMultipartUploadsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Bucket>YYYYYY</Bucket>
<NextKeyMarker>bk-multi-part</NextKeyMarker>
<NextUploadIdMarker>2~ls51tmBOaXRZ0cphaKniJgwYvTXYd9E</NextUploadIdMarker>
<MaxUploads>1000</MaxUploads>
<IsTruncated>false</IsTruncated>
<Upload>
<Key>111</Key>
<UploadId>2~wa0ng7BS4kgkv_H53-BIv6IiKghQicI</UploadId>
<Initiator>
<ID>base</ID>
<DisplayName>base</DisplayName>
</Initiator>
<Owner>
<ID>base</ID>
<DisplayName>base</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
<Initiated>2022-04-06T06:44:46.545Z</Initiated>
</Upload>
<Upload>
<Key>obj</Key>
<UploadId>2~3VNk9y7oax_EplNPYRoVCwZDJIvxAI9</UploadId>
<Initiator>
<ID>base</ID>
<DisplayName>base</DisplayName>
</Initiator>
<Owner>
<ID>base</ID>
<DisplayName>base</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
<Initiated>2022-04-06T06:20:02.607Z</Initiated>
</Upload>
</ListMultipartUploadsResult> 响应消息头
该请求的响应消息使用公共的响应消息头，请参见如何调用API-响应结果-响应消息头。
响应消息元素
| 参数名称 | 参数描述 | 类型 |
|---|---|---|
| ListMultipartUploadsResult | 参数解释： 返回的所有分段数据。 | Container |
表ListMultipartUploadsResult
| 参数名称 | 参数描述 | 类型 |
|---|---|---|
| Bucket | 参数解释： Bucket 的名称。 | String |
| NextKeyMarker | 参数解释： 下一次请求参数 key-marker，用于多次发送请求时使用。 | String |
| NextUploadIdMarker | 参数解释： 下一个 UploadId，用于多次发送请求时使用。 | String |
| MaxUploads | 参数解释： 最大返回的分段数据数。 | Long |
| IsTruncated | 参数解释： 是否截断返回，当该 Bucket 下的分段数大于 MaxUploads 时该值为 true 。 | Boolean |
| Upload | 参数解释： 具体每一个分段信息。 | Container |
表Upload
| 参数名称 | 描述 | 类型 |
|---|---|---|
| Key | 参数解释： 该分段的对象名。 | String |
| UploadId | 参数解释： 该分段的 UploadId。 | String |
| Initiator | 参数解释： 创建该分段上传的用户信息。 | Container |
| Owner | 参数解释： 该分段所属用户。 | Container |
| StorageClass | 参数解释： 该分段的存储级别。 | String |
| Initiated | 参数解释： 该分段创建时间 | String |
表Initiator
| 参数名称 | 描述 | 类型 |
|---|---|---|
| DisplayName | 参数解释： 创建者的名称。 | String |
| ID | 参数解释： 创建者的ID。 | String |
表Owner
| 参数名称 | 描述 | 类型 |
|---|---|---|
| DisplayName | 参数解释： 所有者名称。 | String |
| ID | 参数解释： 所有者ID。 | String |
错误码
请参见调用前必知-错误码-全局错误码。
