功能描述

此接口用于列举指定 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	返回的结果是否被截断，取值说明如下： `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。

请求示例

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
        }
    ]
}

最近更新时间：2024.09.19 10:21:15

这个页面对您有帮助吗？

有用

无用

对象存储

功能描述 #

请求消息样式 #

请求参数和消息头 #

请求元素 #

响应消息头 #

响应元素 #

请求示例 #

响应示例 #