对象存储BOS

    UploadPartCopy

    接口描述

    在调用InitiateMultipartUpload获取UploadId后,我们需要用UploadPartCopy命令来复制Object拆分后的数据(Part)。为了标识各个Part在Object的相对位置,在UploadPartCopy需要指定一个partNumber参数,partNumber的取值范围是1-10000,即每次三步复制最多可以有10000个part,最少1个part。

    说明:

    • 每次Copy Part最多可以复制5G bytes的数据。
    • 三步复制得到的目的Object的Meta信息,不会从源Object复制而来,需要用户在CompleteMultipartUpload时重新上传,或者完成之后,通过CopyObject接口复制自身来更新Meta。
    • UploadPartCopy时,不同的part可能来自不同的Object,系统并不对此进行限制。
    • 目前支持跨区域文件复制,即复制文件所在的源Bucket和目标Bucket可以不在同一region(目前只支持从其它Region向本Region复制数据)。当进行跨区域文件复制时,复制产生的流量会收取跨区域流量费。跨区域收费标准参见产品定价
    • 三步复制不适用于Append Object,Append Object可以使用普通复制方法来完成备份和meta更新。
    • 如果复制的源Object是归档存储类型的,需要首先调用RestoreObject接口取回归档存储类型的Object。

    请求(Request)

    • 请求语法

      PUT /<ObjectName>?uploadId=UploadId&partNumber=PartNumber HTTP/1.1
      Host: <BucketName>.bj.bcebos.com
      Date: <Date>
      Authorization: <AuthorizationString>
      Content-Type: text/plain
      Content-Length: <ContentLength>
      x-bce-copy-source: /SrcBucket/SrcObject
      x-bce-copy-source-range: bytes=0-9
    • 请求头域

      header 是否必填 描述
      x-bce-copy-source 复制源文件,比如/SrcBucket/SrcObject
      x-bce-copy-source-range 复制源文件的字节范围,必须使用bytes=first-last的格式,比如bytes=0-9,代表复制前10个字节。如果不提供此header,则复制整个文件,除最后一个part外,其他part需要大于等于5MB,或者是1MB的整数倍,单个part不能超过5GB,但是整个Object的大小不能超过5TB。
      x-bce-copy-source-if-match 如果源文件的etag值与此header提供的相同,则复制,否则不复制
      x-bce-copy-source-if-none-match 如果源文件的etag值与此header提供的不相同,则复制,否则不复制
      x-bce-copy-source-if-unmodifed-since 如果源文件在此header提供的时间后未曾修改,则复制,否则不复制
      x-bce-copy-source-if-modifed-since 如果源文件在此header提供的时间后曾修改过,则复制,否则不复制

      说明:

      各字段的格式与CopyObject接口对应字段相同。 假设Object内容为"0123456789",长度为10。x-bce-copy-source-range举例如下:

      • range: 0-3,拷贝"0123";
      • range: 4-,从下标为4的开始拷贝到文件结束即拷贝"456789";
      • range: -4,拷贝末尾4个即"6789"。
    • 请求参数

      名称 类型 参数位置 描述 是否必需
      partNumber Int Query参数 此part在目的Object中的序号。partNum取值范围 1-10000,一次MultiPart的PartNumber要求必须严格有序,比如有3个Part,PartNumber可以是1,3,5。
      uploadId String Query参数 InitiateMultipartUpload获取的UploadId

    响应(Response)

    • 响应元素

      名称 描述
      ETag 复制目的Object的ETag
      lastModified 目的Object的修改时间

      注意事项

      1. UploadPartCopy会返回本次Part的ETag,在MultipartUpload的第三步中需要此ETag,也建议用户用ETag验证上传数据的正确性。
      2. 为了保持复制过程中的http连接,UploadPartCopy接口的http结果可能使用Transfer-Encoded: Chunked编码方式。
      3. UploadPartCopy过程中,如果发生服务器端错误,http status code可能返回2XX但是复制失败,复制结果请根据http body中的json判定。

    示例

    • 请求示例

      PUT /ObjectName?uploadId=a44cc9bab11cbd156984767aad637851&partNumber=1 HTTP/1.1
      Host: BucketName.bj.bcebos.com
      Date: <Date>
      Authorization: <AuthorizationString>
      Content-Type: text/plain
      Content-Length: 0
      x-bce-copy-source: /SrcBucket/SrcObject
      x-bce-copy-source-range: bytes=0-9
    • 响应示例

      HTTP/1.1 200 OK
      Date: Thu, 12 May 2016 09:14:32 GMT
      Content-Type: application/json; charset=utf-8
      Connection: keep-alive
      Server: BceBos
      x-bce-debug-id: MTAuNjMuMTIzLjI3OlRodSwgMTIgTWF5IDIwMTYgMTc6MTQ6MzIgQ1NUOjg3MjkzODMwMA==
      x-bce-request-id: bb90cc9c-2b80-462c-87a4-095e610c9a2f
      Transfer-Encoding: chunked
      {   
          "lastModified":"2016-05-12T09:14:32Z",
          "eTag":"67b92a7c2a9b9c1809a6ae3295dcc127"
      }

      拷贝失败, 需要根据返回的json判断

      HTTP/1.1 200 OK
      Date: Thu, 12 May 2016 09:14:32 GMT
      Content-Type: application/json; charset=utf-8
      Connection: keep-alive
      Server: BceBos
      x-bce-debug-id: MTAuNjMuMTIzLjI3OlRodSwgMTIgTWF5IDIwMTYgMTc6MTQ6MzIgQ1NUOjg3MjkzODMwMA==
      x-bce-request-id: bb90cc9c-2b80-462c-87a4-095e610c9a2f
      Transfer-Encoding: chunked
      {
          "code":"InternalError",
          "message":"We encountered an internal error. Please try again.",
          "requestId":"52454655-5345-4420-4259-204e47494e58"
      }
    上一篇
    UploadPart
    下一篇
    CompleteMultipartUpload