ListParts
更新时间 2026-04-10 20:11:09
最近更新时间: 2026-04-10 20:11:09
功能说明
ListParts用来查询指定Upload ID所属的分段上传中的已上传的分段的信息。
请求消息样式
GET /{Bucket}/{key}?part-number-marker=0&max-parts=100&uploadId=2~D-ixxGkXNw6F79q2AcwMQH_41XMMkUr 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 | 是 |
| Key | 参数解释： 上传对象名称。 | String | 是 |
| max-parts | 参数解释： 单次最多返回的分段数量，大小是1-1000，超过1000的数据会被视为1000。 | Long | 否 |
| part-bumber-marker | 参数解释： list的分段编号的起始编号，只有分段编号大于这个数字的分段信息才会返回。 | Long | 否 |
| uplodaId | 参数解释： 分段上传的ID。 | String | 是 |
请求消息头
该请求使用公共的请求消息头，请参见如何调用API-构造请求-请求消息头。
请求消息元素
该请求消息中不带消息元素。
响应消息样式
HTTP/1.1 Status Code
Transfer-Encoding: chunked
x-amz-request-id: tx000000000000000000047-00624d4f50-5403f-default
Content-Type: application/xml
Date: Wed, 06 Apr 2022 08:29:04 GMT
Connection: Keep-Alive
<?xml version="1.0" encoding="UTF-8"?>
<ListPartsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Bucket>bk-multi-part</Bucket>
<Key>key</Key>
<UploadId>2~D-ixxGkXNw6F79q2AcwMQH_41XMMkUr</UploadId>
<StorageClass>STANDARD</StorageClass>
<PartNumberMarker>0</PartNumberMarker>
<NextPartNumberMarker>2</NextPartNumberMarker>
<MaxParts>100</MaxParts>
<IsTruncated>false</IsTruncated>
<Owner>
<ID></ID>
<DisplayName></DisplayName>
</Owner>
<Part>
<LastModified>2022-04-06T08:26:45.233Z</LastModified>
<PartNumber>1</PartNumber>
<ETag>"5f363e0e58a95f06cbe9bbc662c5dfb6"</ETag>
<Size>5242880</Size>
</Part>
<Part>
<LastModified>2022-04-06T09:01:41.181Z</LastModified>
<PartNumber>2</PartNumber>
<ETag>"af5df3928dffe923b1756663188295a7"</ETag>
<Size>124</Size>
</Part>
</ListPartsResult>响应消息头
该请求的响应消息使用公共的响应消息头，请参见如何调用API-响应结果-响应消息头。
响应消息元素
| 参数名称 | 参数描述 | 类型 |
|---|---|---|
| ListPartsResult | 参数解释： 本次列举分段数据返回的结果。 | Container |
表ListPartsResult
| 参数名称 | 参数描述 | 类型 |
|---|---|---|
| Bucket | 参数解释： 分段上传的Bucket名称 | String |
| Key | 参数解释： 用户分段上传的对象名。 | String |
| UploadId | 参数解释： 分段上传的ID。 | String |
| PartNumberMarker | 参数解释： 本次请求的起始分段号。 | Long |
| NextPartNumberMarker | 参数解释： 下一次请求的起始分段号，当分段信息过多是，该请求可以多次发送。 | Long |
| MaxParts | 参数解释： 最多返回的分段数。 | Long |
| IsTruncated | 参数解释： 是否截断返回，当该对象的分段数大于MaxParts时，该值为true。 | Boolean |
| Owner | 参数解释： 对象所有者信息。 | Container |
| Part | 参数解释： 各个分段信息。 | Container |
表Owner
| 参数名称 | 参数描述 | 类型 |
|---|---|---|
| DisplayName | 参数解释： 所有者名称。 | String |
| ID | 参数解释： 所有者ID。 | String |
表Part
| 参数名称 | 参数描述 | 类型 |
|---|---|---|
| LastModified | 参数解释： 该分段的最新更新时间。 | Date |
| PartNumber | 参数解释： 分段号。 | Long |
| Etag | 参数解释： 该分段的Etag。 | String |
| Size | 参数解释： 该分段大小，单位为bytes。 | Long |
错误码
请参见调用前必知-错误码-全局错误码。
