搜本产品 
Complete Multipart Upload
描述
该操作通过组合之前上传的分片来完成分片上传。
首先初始化分片上传，然后使用Upload Parts上传分片。成功上传所有分片后，可调用该API完成分片上传。OSS收到该请求后，会按照分片编号进行升序连接以创建Object。在该请求中，需要提供完整的分片列表，以及每个分片的编号及Etag。
合并所以分片需要几分钟时间，所以OSS在开始处理该请求后会回复200 OK。在处理过程中，OSS会定期发送空白字符以防止连接超时。该请求在200 OK响应发送后可能会失败，您需要检查响应主体来确定请求是否成功。
请求
语法
POST /ObjectName?uploadId=UploadId HTTP/1.1
Host: <bucket>.s3.<region>.jdcloud-oss.com
Date: <Date>
Content-Length: <Size>
Authorization: <authorization string>
<CompleteMultipartUpload>
<Part>
<PartNumber>PartNumber</PartNumber>
<ETag>ETag</ETag>
</Part>
...
</CompleteMultipartUpload>
请求参数
无请求参数
请求Header
无特殊Header
请求元素
| 名称 | 描述 | 必须 |
|---|---|---|
| CompleteMultipartUpload | 请求集合。 Ancestor: None Type: Container Children: One or more Part elements |
是 |
| Part | 之前上传的分片的PartNumber及ETag信息的集合。 Ancestor: CompleteMultipartUpload Type: Container Children: PartNumber, ETag |
是 |
| PartNumber | 分片的唯一标识符。 Ancestor: Part Type: Integer |
是 |
| ETag | 分片上传后返回的实体标签。 Ancestor: Part Type: String |
是 |
响应
响应Header
无特殊Header
响应元素
| 名称 | 描述 |
|---|---|
| CompleteMultipartUploadResult | 响应集合。 Type: Container Children: Bucket, Key, UploadId Ancestors: None |
| Location | 新创建的Bucket的URL。 Type: URI Ancestors: CompleteMultipartUploadResult |
| Bucket | 所在的Bucket名称 Type: String Ancestors: CompleteMultipartUploadResult |
| Key | 新创建的Object名称。 Type: String Ancestors: CompleteMultipartUploadResult |
| Etag | Etag可以标识新创建的Object数据。不同Object有不同的Etag。 Type: String Ancestors: CompleteMultipartUploadResult |
特殊错误
| Error Code | 描述 | HTTP Status Code |
|---|---|---|
| InvalidPart | 一个或多个指定的分片不存在。分片可能没有上传或者指定的Etag与分片的Etag不匹配。 | 400 Bad Request |
| InvalidPartOrder | 分片列表没有按照升序排列。 | 400 Bad Request |
| NoSuchUpload | 指定的分片上传不存在，Upload ID是无效的。 | 404 Not Found |
示例
请求示例
POST /example-object?uploadId=AAAsb2FkIElEIGZvciBlbHZpbmcncyWeeS1tb3ZpZS5tMnRzIRRwbG9hZA HTTP/1.1
Host: oss-example.s3.<region>.jdcloud-oss.com
Date: Mon, 1 Nov 2010 20:34:56 GMT
Content-Length: 391
Authorization: <authorization string>
<CompleteMultipartUpload>
<Part>
<PartNumber>1</PartNumber>
<ETag>"a54357aff0632cce46d942af68356b38"</ETag>
</Part>
<Part>
<PartNumber>2</PartNumber>
<ETag>"0c78aef83f66abc1fa1e8477f296d394"</ETag>
</Part>
<Part>
<PartNumber>3</PartNumber>
<ETag>"acbd18db4cc2f85cedef654fccc4a4d8"</ETag>
</Part>
</CompleteMultipartUpload>
响应示例
HTTP/1.1 200 OK x-amz-request-id: 656c76696e6727732072657175657374 Date: Mon, 1 Nov 2010 20:34:56 GMT Connection: close Server: JDCloudOSS <?xml version="1.0" encoding="UTF-8"?> <CompleteMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Location>http://Example-Bucket.s3.amazonaws.com/Example-Object</Location> <Bucket>Example-Bucket</Bucket> <Key>Example-Object</Key> <ETag>"3858f62230ac3c915f300c664312c11f-9"</ETag> </CompleteMultipartUploadResult>
更新时间：2021-12-01 16:54:25
文档反馈
