CompleteMultipartUpload
在将所有数据Part都上传完成后,必须调用CompleteMultipartUpload接口来完成整个文件的MultipartUpload。
在执行该操作时,用户必须提供所有有效的数据的Part列表(包括Part号码和ETag)。OSS收到用户提交的Part列表后,会逐一验证每个数据Part的有效性。当所有的数据Part验证通过后,OSS将把这些数据part组合成一个完整的Object。
说明
- CompleteMultipartUpload时会确认除最后一块以外所有块的大小是否都大于100KB,并检查用户提交的Part列表中的每一个Part号码和Etag。所以在上传Part时,客户端除了需要记录Part号码外,还需要记录每次上传Part成功后服务器返回的ETag值。
- 由于OSS处理CompleteMultipartUpload请求时会持续一定的时间。在这段时间内,如果客户端与OSS之间连接中断,OSS仍会继续将该请求。
- 用户提交的Part列表中,Part号码可以不连续。例如第一块的Part号码是1,第二块的Part号码是5。
- OSS处理CompleteMultipartUpload请求成功后,该Upload ID就会变成无效。
- 同一个Object可以同时拥有不同的Upload ID,当Complete一个Upload ID后,该Object的其他Upload ID不受影响。
- 若调用InitiateMultipartUpload接口时,指定了x-oss-server-side-encryption请求头,则在CompleteMultipartUpload的响应头中返回x-oss-server-side-encryption,其值表明该Object的服务器端加密算法。
请求语法
POST /ObjectName?uploadId=UploadId HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Content-Length: Size
Authorization: Signature
<CompleteMultipartUpload>
<Part>
<PartNumber>PartNumber</PartNumber>
<ETag>ETag</ETag>
</Part>
...
</CompleteMultipartUpload>
请求参数(Request Parameters)
CompleteMultipartUpload时,可以通过Encoding-type对返回结果中的Key进行编码。
名称 | 类型 | 描述 |
---|---|---|
Encoding-type | 字符串 | 指定对返回的Key进行编码,目前支持url编码。Key使用UTF-8字符,但xml 1.0标准不支持解析一些控制字符,例如ascii值从0到10的字符。对于Key中包含xml
1.0标准不支持的控制字符,可以通过指定encoding-type对返回的Key进行编码。
默认值:无 可选值:url |
请求头
名称 | 类型 | 是否必选 | 描述 |
---|---|---|---|
x-oss-forbid-overwrite | 字符串 | 否 | 指定CompleteMultipartUpload操作时是否覆盖同名Object。
|
x-oss-complete-all:yes | 字符串 | 否 |
|
请求元素
名称 | 类型 | 描述 |
---|---|---|
CompleteMultipartUpload | 容器 | 保存Complete Multipart Upload请求内容的容器。
子节点:一个或多个Part元素 父节点:无 |
ETag | 字符串 | Part成功上传后,OSS返回的ETag值。
父节点:Part |
Part | 容器 | 保存已经上传Part信息的容器。
子节点:ETag, PartNumber 父节点:InitiateMultipartUploadResult |
PartNumber | 整数 | Part数目。
父节点:Part |
响应元素
名称 | 类型 | 描述 |
---|---|---|
Bucket | 字符串 | Bucket名称。
父节点:CompleteMultipartUploadResult |
CompleteMultipartUploadResult | 容器 | 保存Complete Multipart Upload请求结果的容器。
子节点:Bucket, Key, ETag, Location 父节点:None |
ETag | 字符串 | ETag(entity tag)在每个Object生成的时候被创建,用于标识一个Object的内容。Complete Multipart Upload请求创建的Object,ETag值是其内容的UUID。ETag值可以用于检查Object内容是否发生变化。
父节点:CompleteMultipartUploadResult |
Location | 字符串 | 新创建Object的URL。
父节点:CompleteMultipartUploadResult |
Key | 字符串 | 新创建Object的名字。
父节点:CompleteMultipartUploadResult |
EncodingType | 字符串 | 指明返回结果中编码使用的类型。如果请求的参数中指定了encoding-type,那返回的结果会对Key进行编码。
父节点:容器 |
示例
- 请求示例
POST /multipart.data? uploadId=0004B9B2D2F7815C432C9057C03134D4 HTTP/1.1 Host: oss-example.oss-cn-hangzhou.aliyuncs.com Content-Length: 1056 Date: Fri, 24 Feb 2012 10:19:18 GMT Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:8VwFhFUWmVecK6jQlHlXMK/z**** <CompleteMultipartUpload> <Part> <PartNumber>1</PartNumber> <ETag>"3349DC700140D7F86A0784842780****"</ETag> </Part> <Part> <PartNumber>5</PartNumber> <ETag>"8EFDA8BE206636A695359836FE0A****"</ETag> </Part> <Part> <PartNumber>8</PartNumber> <ETag>"8C315065167132444177411FDA14****"</ETag> </Part> </CompleteMultipartUpload>
返回示例HTTP/1.1 200 OK Server: AliyunOSS Content-Length: 329 Content-Type: Application/xml Connection: keep-alive x-oss-request-id: 594f0751-3b1e-168f-4501-4ac71d21**** Date: Fri, 24 Feb 2012 10:19:18 GMT <?xml version="1.0" encoding="UTF-8"?> <CompleteMultipartUploadResult xmlns=”http://doc.oss-cn-hangzhou.aliyuncs.com”> <Location>http://oss-example.oss-cn-hangzhou.aliyuncs.com /multipart.data</Location> <Bucket>oss-example</Bucket> <Key>multipart.data</Key> <ETag>B864DB6A936D376F9F8D3ED3BBE540****</ETag> </CompleteMultipartUploadResult>
SDK
错误码
错误码 | HTTP 状态码 | 描述 |
---|---|---|
InvalidDigest | 400 | 为了保证数据在网络传输过程中不出现错误,用户发送请求时可以携带Content-MD5,OSS计算上传数据的MD5与用户上传的MD5值不一致。 |
FileAlreadyExists | 409 | 当请求的header中携带x-oss-forbid-overwrite=true时,表示禁止覆盖同名文件。如果文件已存在,则返回此错误。 |
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论