此接口用于列举指定 UploadId 的已上传的分片，这个请求最多返回 1000 个上传的分片。默认返回的分片信息数量是 1000 个，您可以通过指定max-parts请求参数来限制返回的分片数量。如果您的分片上传任务包含超过 1000 个分片，响应将返回一个值为true的IsTruncated字段和一个NextPartNumberMarker元素。您可以通过part-number-marker查询参数，并将其值设置为来自前一个响应的NextPartNumberMarker字段值，从而列举后续的分片。
GET /objectName?uploadId=UploadId HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: GMT Date Authorization: authorization string
该请求使用的公共请求消息头，请参见公共参数。
名称 | 位置 | 参数类型 | 是否必选 | 示例值 | 说明 |
|---|---|---|---|---|---|
uploadId | Query | String | 是 | f93f6fc9da94371f321e1008 | 初始化分片任务返回的分片任务 ID，用于唯一标识上传的分片属于哪个对象。 |
max-parts | Query | Integer | 否 | 100 | 返回分片的最大数量，最大值为 1000，即一次请求最多返回 1000 个分片。 |
part-number-marker | Query | Integer | 否 | 2 | 指定分片号的起始位置，只列举分片号大于此值的段。 |
该请求无请求消息元素。
该请求返回的公共响应消息头，请参见公共参数。
名称 | 参数类型 | 示例值 | 说明 |
|---|---|---|---|
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 | 返回的结果是否被截断，取值说明如下：
|
NextPartNumberMarker | Integer | 4 | 如果结果未完全返回，标识下次请求的 part-number-marker 值。 |
StorageClass | String | STANDARD | 分片上传任务的存储类型，取值说明如下：
|
Parts | Array | - | 分片信息的根节点。 说明
|
PartNumber | Integer | 1 | 分片号。父节点为 Parts。 |
LastModified | String | 2024-06-06T07:58:17.000Z | 分片上传的时间。父节点为 Parts。 |
ETag | String | 32185e15494ca8e0eedf12bd218787f6 | 分片内容的 ETag。父节点为 Parts。 |
Size | Integer | 4813 | 分片大小。父节点为 Parts。 |
Owner | Object | - | 分片上传任务的创建者。 说明
|
ID | String | 1234567890 | 账号 ID。父节点为 Owner。 |
DisplayName | String | test-owner-name | 账号名。父节点为 Owner。 |
GET /objectName?uploadId=UploadId HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 00:15:25 GMT Authorization: authorization string
HTTP/1.1 200 OK x-tos-id-2: 4fac130c7ea5003e-a444ed0 x-tos-request-id: 4fac130c7ea5003e-a444ed0 Date: Fri, 30 Jul 2021 00:15:25 GMT server: TosServer Content-Length: 693 { "Bucket": "bucketName", "Key": "multiobj1", "UploadId": "f93f6fc90d5f371f4f18c0b1", "PartNumberMarker": 0, "NextPartNumberMarker": 0, "MaxParts": 1000, "IsTruncated": false, "StorageClass": "STANDARD", "Owner": { "ID": "AccountID" }, "Parts": [ { "PartNumber": 1, "LastModified": "2021-08-20T06:43:49Z", "ETag": "\"7de47c292287f7965357c1ddd724b2b7\"", "Size": 10 } ] }