You need to enable JavaScript to run this app.
导航

UploadPartCopy

最近更新时间2024.01.15 15:20:42

首次发布时间2021.10.13 16:14:08

功能描述

该接口用于将已上传对象的一部分或者全部拷贝为分片。在 UploadPart 接口请求的基础上,增加请求头x-tos-copy-source来调用此接口。

使用说明

  • 使用 CopyObject 或 UploadPartCopy 接口均要求对源对象有读权限。
  • 不允许拷贝以 AppendObject 方式上传的对象。
  • 必须先通过初始化分片任务接口获取一个任务的UploadId,用于UploadPartCopy 上传分片数据。
  • 源对象拷贝为分片,如果分片已经存在,则会被覆盖,因此在使用拷贝分片接口前请确认目标分片不存在或已不使用,避免被误删。
  • 使用 UploadPartCopy 接口拷贝归档存储、冷归档存储和深度冷归档存储对象前,需要先恢复对象。

多版本

桶多版本开启时,同一个对象可能存在多个版本。默认情况下,通过请求头x-tos-copy-source是获取源对象的当前版本进行拷贝。如果对象的当前版本为删除标记并且在请求头x-tos-copy-source中没有指定versionId,将会返回一个 404 Not Found 错误,因为对象已经不存在。如果在请求头x-tos-copy-source中指定了versionId,但对应版本的对象为删除标记,返回 400 Bad Request,因为在请求头x-tos-copy-source中指定删除标记的versionId是不允许的。

请求消息样式

PUT /objectName?partNumber=PartNumber&uploadId=UploadId HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: GMT Date
Authorization: authorization string
x-tos-copy-source: /sourcebucketname/SourceObjectName
x-tos-copy-source-range: bytes=start-end

请求参数和消息头

该请求使用的公共请求消息头,请参见公共参数

名称

位置

参数类型

是否必选

示例值

说明

partNumber

Query

Integer

1

上传的分片号,有效取值 [1,10000]。

uploadId

Query

String

f93f6fc9da94371f321e1008

初始化分片任务返回的分片任务 ID,用于唯一标识上传的分片属于哪个对象。

x-tos-copy-source

Header

String

/sourcebucketname/SourceObjectName?versionId=xxx

指定拷贝的源桶和源对象名。当源对象存在多个版本时,通过 versionId 指定源对象的版本号。

x-tos-copy-source-if-match

Header

String

8a36be0d764367db4eea2deb16b71543

只有当源对象的 ETag 与此参数指定的值相等时才进行复制对象操作。

x-tos-copy-source-if-modified-since

Header

String

Mon, 04 Jul 2022 02:57:31 GMT

如果自指定时间以来对象已被修改,则复制该对象。时间格式为 RFC1123 GMT。

x-tos-copy-source-if-none-match

Header

String

8a36be0d764367db4eea2deb16b71543

只有当源对象的 ETag 与此参数指定的值不相等时才进行复制对象操作。

x-tos-copy-source-if-unmodified-since

Header

String

Mon, 04 Jul 2022 02:57:31 GMT

如果自指定时间以来对象未被修改,则复制该对象。时间格式为 RFC1123 GMT。

x-tos-copy-source-range

Header

String

bytes=0-5242880

指定拷贝源对象的范围,它的起始值最小为 0,最大为对象长度减 1。格式为:bytes=start-end。

x-tos-copy-source-server-side-encryption-customer-algorithm

Header

String

否,源对象是 SSE-C 加密时,必选。

AES256

源对象是 SSE-C 加密时使用该头域,该头域表示解密源对象使用的算法,取值说明如下:

  • AES256:解密源对象使用的算法

x-tos-server-side-encryption-customer-key

Header

String

否,使用 SSE-C 加密时,必选。

YWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWE=

x-tos-server-side-encryption-customer-algorithm 配套使用,指定 SSE-C 加密目标对象的密钥,格式为 base64 编码的 256 bit 的加密密钥。

x-tos-copy-source-server-side-encryption-customer-key-MD5

Header

String

否,源对象是 SSE-C 加密时,必选。

0gYVWExOAz67jX5A6qY4+A==

源对象是 SSE-C 加密时使用该头域,与 x-tos-copy-source-server-side-encryption-customer-key 配套使用,该头域表示解密源对象使用的密钥的 MD5 值。该头域由密钥的 128-bit MD5 值经过 base64-encoded 得到,该值用于消息完整性检查,确认加密密钥在传输过程中没有出错。

x-tos-traffic-limit

Header

String

819200

TOS 提供单链接限速功能,在上传、下载文件等操作中进行流控控制,以保证其他应用的网络带宽。取值说明如下:

  • 取值范围:819200-838860800,单位为bit/s
  • Header和Query中不能同时存在此参数

x-tos-traffic-limit

Query

String

819200

TOS 提供单链接限速功能,在上传、下载文件等操作中进行流控控制,以保证其他应用的网络带宽。取值说明如下:

  • 取值范围:819200-838860800,单位为bit/s
  • Header和Query中不能同时存在此参数

x-tos-server-side-encryption-customer-algorithm

Header

String

否,使用 SSE-C 加密时,必选。

AES256

指定 SSE-C 加密对象要使用的算法,取值说明如下:

  • AES256:使用 AES256 算法加密对象。

x-tos-server-side-encryption-customer-key

Header

String

否,使用 SSE-C 加密时,必选。

1234567890abcdefghijklmnopqrstuv

与 x-tos-server-side-encryption-customer-algorithm 配套使用,指定 SSE-C 加密对象的密钥。

x-tos-server-side-encryption-customer-key-MD5

Header

String

否,使用 SSE-C 加密时,必选。

0gYVWExOAz67jX5A6qY4+A==

与 x-tos-server-side-encryption-customer-key 配套使用,该头域表示加密对象使用的密钥的MD5值。该头域由密钥的 128-bit MD5 值经过 base64-encoded 得到,该值用于消息完整性检查,确认加密密钥在传输过程中没有出错。

请求元素

该请求中不使用请求消息元素。

响应消息头

该请求返回的公共响应消息头,请参见公共参数

名称

参数类型

说明

x-tos-copy-source-version-id

String

源对象的版本号,指定对象版本号拷贝时返回。

x-tos-server-side-encryption

String

对象是 SSE-TOS 加密或 SSE-KMS 时返回该头域,该头域表示对象的服务端加密方式,取值如下:

  • AES256:使用 SSE-TOS 加密方式。
  • kms:使用 SSE-KMS 加密方式。
    关于 SSE-TOS、 SSE-KMS 加密方式详细说明,请参见服务端加密概述

x-tos-server-side-encryption-kms-key-id

String

对象采用 SSE-KMS 加密方式时返回该头域,该头域表示 SSE-KMS 加密使用的 KMS 主密钥 ID。

x-tos-server-side-encryption-customer-algorithm

String

对象采用 SSE-C 加密方式时返回该头域,该头域表示 SSE-C 加密使用的加密算法。

x-tos-server-side-encryption-customer-key-md5

String

对象采用 SSE-C 加密方式时返回该头域,该头域表示 SSE-C 加密使用的密钥的 MD5 值。

响应元素

名称

参数类型

描述

ETag

String

目标段的 ETag 值,是分片内容的唯一标识,用于分片合并时校验数据一致性。

LastModified

String

目标段的最后修改时间。

x-tos-hash-crc64ecma

Integer

表示该对象的 64 位 CRC 值。该 64 位 CRC 根据 ECMA-182 标准计算得出。

说明

对 TOS 服务端支持 64 位 CRC 校验前创建的对象,则该消息头不会出现在响应消息中。

请求示例

PUT /objectName?partNumber=PartNumber&uploadId=UploadId HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 00:12:21 GMT
Authorization: authorization string
x-tos-copy-source: /sourcebucketname/SourceObjectName
x-tos-copy-source-range: bytes=0-5242880

响应示例

HTTP/1.1 200 OK
x-tos-id-2: 4fac130c7e29003a-a444ed0
x-tos-request-id: 4fac130c7e29003a-a444ed0
x-tos-hash-crc64ecma: 6186290338114851376
Date: Fri, 30 Jul 2021 00:12:21 GMT
server: TosServer

{
    "ETag": "\"8a36be0d764367db4eea2deb16b71543\"",
    "LastModified": "2021-08-20T06:45:57.000Z"
}