功能描述

此接口用于列举指定 UploadId 的已上传的分片，这个请求最多返回 1000 个上传的分片。默认返回的分片信息数量是 1000 个，您可以通过指定max-parts请求参数来限制返回的分片数量。如果您的分片上传任务包含超过 1000 个分片，响应将返回一个值为true的IsTruncated字段和一个NextPartNumberMarker元素。您可以通过part-number-marker查询参数，并将其值设置为来自前一个响应的NextPartNumberMarker字段值，从而列举后续的分片。

请求消息样式

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
uploadId	Query	String	是	f93f6fc9da94371f321e1008	初始化分片任务返回的分片任务 ID，用于唯一标识上传的分片属于哪个对象。
max-parts	Query	Integer	否	100	返回分片的最大数量，默认值为 1000，取值范围为 1 ~ 1000，即一次请求最多返回 1000 个分片。
part-number-marker	Query	Integer	否	2	指定分片号的起始位置，只列举分片号大于此值的段。取值范围为 ≥ 0 的整数，默认值为 0。

请求元素

该请求无请求消息元素。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

名称	参数类型	示例值	说明
Bucket	String	test-bucket	桶名。
Key	String	abcd	对象名。
UploadId	String	1e91667ba7171cebdcd9016168fadcd4	分片任务 ID。
MaxParts	Integer	2	请求参数中的 max-parts。
PartNumberMarker	Integer	2	请求参数中的 part-number-marker。
IsTruncated	Bool	true	返回的结果是否被截断，取值说明如下： false：已返回全部结果。 true：还有结果未返回。
NextPartNumberMarker	Integer	4	如果结果未完全返回，标识下次请求的 part-number-marker 值。
StorageClass	String	STANDARD	分片上传任务的存储类型，取值说明如下： STANDARD：标准存储。 IA：低频访问存储。 INTELLIGENT_TIERING：智能分层存储。 ARCHIVE_FR：归档闪回存储。 ARCHIVE：归档存储。 COLD_ARCHIVE：冷归档存储。 DEEP_COLD_ARCHIVE：深度冷归档存储。
Parts	Array	-	分片信息的根节点。说明 Parts 是 PartNumber、LastModified、 ETag、Size 参数的根节点。
PartNumber	Integer	1	分片号。父节点为 Parts。
LastModified	String	2024-06-06T07:58:17.000Z	分片上传的时间。父节点为 Parts。
ETag	String	32185e15494ca8e0eedf12bd218787f6	分片内容的 ETag。父节点为 Parts。
Size	Integer	4813	分片大小。父节点为 Parts。
Owner	Object	-	分片上传任务的创建者。说明 Owner 是 ID 和 DisplayName 参数的根节点。
ID	String	1234567890	账号 ID。父节点为 Owner。
DisplayName	String	test-owner-name	账号名。父节点为 Owner。

请求示例

响应示例

对象存储