Complete Multipart Upload

最近更新时间:2019-01-14 10:10:58

Complete Multipart Upload


描述

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

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

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

请求

语法

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>

注意:

请求参数

该请求不使用请求参数。

请求头部

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

请求内容

名称 描述 必须
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

响应内容

名称 描述
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

特殊错误

错误代码 描述 HTTP状态码
EntityTooSmall 用户拟上传的块大小小于对象所允许的最小值。除了最后一个块之外,每一个块至少在5MB以上。当文件总大小在5M以内的话,可以允许除了最后一个块之外,每一个块至少在100K以上。 400 Bad Request
InvalidPart 一个或多个指定的块没有找到。块可能没有被上传,也可能因为上传了但实体标签不匹配。 400 Bad Request
InvalidPartOrder 分块列表没有按照升序排列。分块必须按序指定分块序号。 400 Bad Request
NoSuchUpload 指定的分块上传任务不存在。可能是上传ID无效,也可能是分块上传任务已经完成或放弃。 404 Not Found

示例

请求示例

POST /my-viedo.rm ?uploadId=1aa9cfad5e2e405c8f27965feb8b60cc HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyun.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: close
Server: Tengine

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

接口细节分析

  • 除了最后一个块之外,每一个块至少在5MB以上。当文件总大小在5M以内的话,可以允许除了最后一个块之外,每一个块至少在100K以上。
  • 用户提交的part列表必须是升序连续的。
  • 当执行完该操作后,对应的uploadId将会失效
  • 同一个Object可以同时拥有不同的Upload Id,当Complete一个Upload ID后,该Object的其他Upload ID不受影响。
  • 提交的part列表中的每个part必须是存在的。否则会报InvalidPartOrder

金山云,开启您的云计算之旅

注册有礼