搜索本产品文档关键词
UploadPartCopy
所有文档
menu

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)

  • 请求语法

    Plain Text
    1PUT /<ObjectName>?uploadId=UploadId&partNumber=PartNumber HTTP/1.1
    2Host: <BucketName>.bj.bcebos.com
    3Date: <Date>
    4Authorization: <AuthorizationString>
    5Content-Type: text/plain
    6Content-Length: <ContentLength>
    7x-bce-copy-source: /SrcBucket/SrcObject
    8x-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 分片需要大于等于 100 KB,小于等于 5GB,且整个 Object 大小不超过 48.8 TB。
    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提供的时间后曾修改过,则复制,否则不复制
    Plain Text
    1> **说明:**
    2>
    3> 各字段的格式与[CopyObject接口](BOS/API参考/Object相关接口/基础操作/CopyObject.md)对应字段相同。
    4> 假设Object内容为"0123456789",长度为10。x-bce-copy-source-range举例如下:
    5>
    6> -   range: 0-3,拷贝"0123";
    7> -   range: 4-,从下标为4的开始拷贝到文件结束即拷贝"456789";
    8> -   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判定。

示例

  • 请求示例

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

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

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

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