CompleteMultipartUpload
更新时间 2026-04-10 20:11:08
最近更新时间: 2026-04-10 20:11:08
功能说明
CompleteMultipartUpload用来实现完成整个分块上传。
注意事项
当您已经使用分段上传请求上传所有块以后,可以用该API完成上传。在使用该API时,您必须在Body中给出每一个块的PartNumber和ETag用来校验块的准确性。服务端在调用CompleteMultipartUpload接口时会对PartNumber做校验。PartNumber取值为1~10000。PartNumber可以不连续,但必须升序排列。例如第一个Part的PartNumber是1,第二个Part的PartNumber可以是5。
请求消息样式
POST /{Bucket}/{key}?uploadId=2~9aZMn-bJtPT4F-WjVYkxtWVB820G4sC HTTP/1.1
Host: xxx.zos.ctyun.cn
x-amz-content-SHA256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b85
x-amz-Date: 20220406T063538Z
Content-Length: 296
Authorization: string
<CompleteMultipartUpload xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Part>
<PartNumber>1</PartNumber>
<ETag>5f363e0e58a95f06cbe9bbc662c5dfb6</ETag>
</Part>
<Part>
<PartNumber>2</PartNumber>
<ETag>af5df3928dffe923b1756663188295a7</ETag>
</Part>
</CompleteMultipartUpload>请求消息参数
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| Bucket | 参数解释: Bucket的名称。 | String | 是 |
| Key | 参数解释: 需要完成分段上传过程的对象名。 | String | 是 |
| UploadId | 参数解释: 分段上传初始化时返回的uploadId。 | String | 是 |
请求消息头
该请求使用公共的请求消息头,请参见如何调用API-构造请求-请求消息头。
请求消息元素
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| CompleteMultipartUpload | 参数解释: 完成分段上传需要的分段数据信息。 | Container | 是 |
表CompleteMultipartUpload
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| Part | 参数解释: 所有分段信息 | Container | 是 |
表Part
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| PartNumber | 参数解释: 具体某个分段的分段号 | Long | 是 |
| ETag | 参数解释: 具体某个分段的Etag | String | 是 |
响应消息样式
HTTP/1.1 Status Code
x-amz-request-id: tx000000000000000000042-00624d4b05-5403f-default
Content-Type: application/xml
Content-Length: 296
Date: Wed, 06 Apr 2022 08:10:45 GMT
Connection: Keep-Alive
<?xml version="1.0" encoding="UTF-8"?>
<CompleteMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Location>http://192.168.218.131:7480/bucket-3/key</Location>
<Bucket>bucket-3</Bucket>
<Key>key</Key>
<ETag>38d95dc1f762ef78d9e73d1d6515abb4-2</ETag>
</CompleteMultipartUploadResult>响应消息头
该请求的响应消息使用公共的响应消息头,请参见如何调用API-响应结果-响应消息头。
响应消息元素
| 参数名称 | 参数描述 | 类型 |
|---|---|---|
| CompleteMultipartUploadResult | 参数解释: 接口返回的结果信息 | Container |
表 CompleteMultipartUploadResult
| 参数名称 | 参数描述 | 类型 |
|---|---|---|
| Bucket | 参数解释: 分段上传的Bucket名称 | String |
| Location | 参数解释: 对象具体位置 | String |
| Key | 参数解释: 用户分段上传的对象名 | String |
| Etag | 参数解释: 本次分段上传整体数据的Etag | String |
错误码
请参见调用前必知-错误码-全局错误码。