Complete Multipart Upload

最近更新时间:2023-06-01 17:50:05

查看PDF

描述

此操作将完成对象装配之前的块上传任务 。

用户启动一个分块上传任务后,会使用 Upload Parts 接口上传所有的块。成功上传所有相关块之后,用户需要调用此接口来完成分块上传。收到完成请求后,KS3将会根据块序号将所有的块组装起来创建一个新的对象。在用户的完成任务请求中需要用户提供分块列表,由于KS3将会按照列表将所有块连接起来,所以要求用户保证所有的块已经完成上传。对于分块列表中的每一个块,用户需要在上传块时添加块序号以及对象的 ETag 头部,KS3则会在块完成上传后回复完成响应。

请注意,如果 Complete Multipart Upload 请求失败了,用户应用应当能够进行重试操作。

说明

  • 用户提交的part列表必须是升序连续的。
  • 当执行完该操作后,对应的UploadId将会失效。
  • 同一个Object可以同时拥有不同的UploadId,当Complete一个UploadId后,该Object的其他UploadId不受影响。
  • 提交的part列表中的每个part必须是存在的,否则会报InvalidPartOrder。

请求

请求语法

POST /{ObjectKey}?uploadId={UploadId} HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {Date}
Content-Length: {Size}
Authorization: {SignatureValue}

<CompleteMultipartUpload>
<Part>
<PartNumber>{PartNumber}</PartNumber>
<ETag>{ETag}</ETag>
</Part>
...
</CompleteMultipartUpload>

注意:

请求参数

名称 描述 是否必选
uploadId 此次分块上传事件的唯一标识,是在初始化分块上传时获取的。
类型:String

请求头部

该请求仅使用常用请求头部。获取更多信息,请点击常用请求头部

请求内容

名称 描述 是否必选
CompleteMultipartUpload 请求信息容器。
父节点: 无
类型: Container
子节点: One or more Part elements
Part 某一特定的已上传的块信息容器。
父节点: CompleteMultipartUpload
类型: Container
子节点: PartNumber, ETag
PartNumber 用于标识块的块序列号。
父节点: Part
类型: Integer
ETag 块上传后返回的实体标签。
父节点: Part
类型: String

响应

响应头部

该接口使用常用响应头部。获取更多信息,请点击常用响应头部

名称 描述
x-kss-server-side-encryption 如果存储 object 时使用了服务端加密,则响应会包含该头部,值为使用的加密算法。
类型:String
x-kss-server-side-encryption-customer-algorithm 如果服务端使用了用户提供的加密秘钥加密,在请求解密时,响应将会包含该头部来确认使用的解密算法。
类型:String
有效值:AES256
x-kss-server-side-encryption-customer-key-MD5 如果服务端使用了用户提供的加密秘钥加密,在请求解密时,响应将会包含该头部来提供用户提供加密秘钥的数据一致性验证信息。
类型:String

响应内容

名称 描述
CompleteMultipartUploadResult 响应信息的容器。
类型: Container
子节点: Location, Bucket, Key, ETag
父节点: None
Location 用于标识新创建对象的URI。
类型: URI
父节点: CompleteMultipartUploadResult
Bucket 包含新创建对象的空间的名称。
类型: String
父节点: CompleteMultipartUploadResult
Key 新创建对象的 object key
类型: String
父节点: CompleteMultipartUploadResult
ETag 用于标识Object内容的32位十六进制字符串,不同内容的Object对应着不同的ETag。对于Put ObjectPost Object请求创建的ObjectETag值是其内容的MD5值;对于分块上传方式创建的ObjectETag值是每个分块的MD5值进行字符串拼接后再次计算所得到的MD5值。ETag值可以用于检查Object内容是否发生变化。
类型: String
父节点: CompleteMultipartUploadResult

示例

请求示例

POST /my-viedo.rm?uploadId=1aa9cfad5e2e405c8f27965feb8b60cc HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.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
Date: Mon, 1 Nov 2010 20:34:56 GMT
Connection: keep-alive
x-kss-request-id: f86mktegmek8a875thib7nqmllrd2k7b
Server: KS3

<?xml version="1.0" encoding="UTF-8"?>
<CompleteMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
	<Location>http://ks3-example.ks3-cn-beijing.ksyuncs.com/my-video.rm</Location>
	<Bucket>ks3-example</Bucket>
	<Key>my-video.rm</Key>
	<ETag>"3858f62230ac3c915f300c664312c11f"</ETag>
</CompleteMultipartUploadResult>

错误码

错误码 HTTP状态码 描述
EntityTooSmall 400 用户拟上传的块大小小于对象所允许的最小值。除了最后一个块之外,每一个块至少在5MB以上。当文件总大小在5M以内的话,可以允许除了最后一个块之外,每一个块至少在100K以上。
InvalidPart 400 一个或多个指定的块没有找到。块可能没有被上传,也可能因为上传了但实体标签不匹配。
InvalidPartOrder 400 分块列表不连续(分块列表要求必须连续)。
NoSuchUpload 404 指定的分块上传任务不存在。可能是上传ID无效,也可能是分块上传任务已经完成或放弃。
InvalidArgument 400 提供了SSE-S3或SSE-C加密请求头。

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

内容不全,不深入
内容更新不及时
描述不清晰,比较混乱
系统或功能太复杂,缺乏足够的引导
内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈