该接口用于合并已经上传的分片数据。在调用该接口时,必须提供有效的分片列表(包含PartNumber
和ETag
),TOS 服务端收到请求后,会根据提供的分片列表来合并分片为一个对象。
UploadId
,当一个UploadId
合并成功之后会被删除,其他未合并的UploadId
不受影响。PartNumber
的取值有效范围 [1,10000],合并时会进行校验,所有的上传分片都必须参与合并。POST /objectName?uploadId=UploadId HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: GMT Date Authorization: authorization string Content-Length: length { "Parts":[{ "PartNumber":partNumber, "ETag":etag }] }
该请求使用公共请求消息头,请参见公共参数。
名称 | 位置 | 参数类型 | 是否必选 | 示例值 | 说明 |
---|---|---|---|---|---|
uploadId | Query | String | 是 | f93f6fc9da94371f321e**** | 指定分片上传任务。 |
x-tos-forbid-overwrite | Header | String | 否 | false | 是否允许覆盖同名 Object,取值说明如下:
注意 当目标 Bucket 处于已开启或已暂停的版本控制状态时, |
该请求中的请求元素,携带了合并时需要的分片列表。
名称 | 参数类型 | 示例值 | 说明 |
---|---|---|---|
Parts | Array | /- | 已上传的分片信息。 |
PartNumber | Integer | 1 | 已上传的分片号。父节点为 Parts。 |
ETag | String | 00b8d61d63ca2bbc2b535917e40ef478-1 | 分片上传成功返回的 ETag 值。父节点为 Parts。 |
该请求返回的公共响应消息头,请参见公共参数。
名称 | 参数类型 | 示例值 | 说明 |
---|---|---|---|
x-tos-server-side-encryption | String | AES256 | 对象是 SSE-TOS 加密或 SSE-KMS 时返回该头域,该头域表示对象的服务端加密方式,取值如下:
|
x-tos-server-side-encryption-kms-key-id | String | trn:kms:cn-beijing:20000111:keyrings/ring-test/keys/key-test | 对象采用 SSE-KMS 加密方式时返回该头域,该头域表示 SSE-KMS 加密使用的 KMS 主密钥 ID。 |
x-tos-version-id | String | 57AF1A32CECB56721267 | 合并后返回对象的版本号。如果不存在版本号,则该消息头不会出现在响应消息中。 |
x-tos-hash-crc64ecma | Integer | 6186290338114851376 | 表示该对象的 64 位 CRC 值。该 64 位 CRC 根据 ECMA-182 标准计算得出。 说明 当上传对象使用服务端加密时,该值为对象明文内容的 CRC64 校验值。 |
名称 | 参数类型 | 示例值 | 说明 |
---|---|---|---|
Location | String | http://bucketName.tos-cn-beijing.volces.com/objectName | 新创建对象的带域名的 URL。 |
Bucket | String | bucketName | 桶名。 |
Key | String | objectName | 合并得到的对象名。 |
ETag | String | 00b8d61d63ca2bbc2b535917e40ef478 | 对象生成时创建的 ETag,用于唯一标识对象内容。 |
POST /objectName?uploadId=UploadId HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 13:59:38 GMT Authorization: authorization string Content-Length: 100 { "Parts":[{ "PartNumber":partNumber, "ETag":"ETag" }] }
HTTP/1.1 200 OK x-tos-id-2: 9b84750a5bbc0029-a444ed0 x-tos-request-id: 9b84750a5bbc0029-a444ed0 Date: Fri, 30 Jul 2021 13:59:38 GMT server: TosServer Content-Length: 235 { "Location": "http://bucketName.tos-cn-beijing.volces.com/objectName", "Bucket": "bucketName", "Key": "objectName", "ETag": "\"00b8d61d63ca2bbc2b535917e40ef478-1\"" }