全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

Upload Part Copy

最近更新时间:2022-12-30 15:48:02

描述

此操作将可以通过拷贝已存在的对象的方式实现上传一个块。用户通过在请求中配置请求头部 x-kss-copy-source 来指定数据源,通过请求头部 x-kss-copy-source-range 来指定字节范围。

注意事项

  • 此外你还可以通过在请求中包含数据的方式来实现块的上传,更多信息,请查看接口 Upload Part
  • 在你上传任一块之前你必须先要启动一个分块上传任务。在你发送一个启动请求后,KS3会给你一个唯一的 upload ID。每次上传块时,都需要将上传ID包含在请求中。
  • 块的数量可以是1到10,000中的任意一个(包含1和10,000)。块序号用于标识一个块以及其在对象创建时的位置。如果你上传一个新的块,使用之前已经使用的序列号,那么之前的那个块将会被覆盖。
  • 所有块的大小均要求小于等于500MB。  当所有块总大小大于5M时:除了最后一个块外,其余块的大小均要求在5MB以上。  当所有块总大小小于等于5MB时:除了最后一个块外,其余块的大小均要求在100KB以上。

请求

请求语法

PUT /{ObjectName}?partNumber={PartNumber}&uploadId={UploadId} HTTP/1.1
Host: {BucketName}.{endpoint}
x-kss-copy-source: {/source_bucket/sourceObject}
x-kss-copy-source-range:bytes={first}-{last}
Date: {date}
Authorization: {SignatureValue}

注意:

请求参数

该请求不使用请求参数。

请求头部

该接口可以使用所有常用请求头部。获取更多信息,请点击常用请求头部

名称 描述 是否必选
x-kss-copy-source 空间名称与对象的object key名称的组合,通过斜杠分隔('/')。
类型: String
默认值: 无
x-kss-copy-source-range 从数据源拷贝的字节范围。范围设定必需使用 bytes=first-last,其值是基于0的。例如:bytes=0-9 表示用户将复制前10个字节。当拷贝整个对象时,不需要此头部。
类型: Integer
默认值: 无
若要求服务端加密则需要以下头部
名称 描述 是否必选
x-kss-server-side-encryption-customer-key 由用户指定KS3加密时使用的 base64-encoded 加密秘钥,其值必须与启动分块上传任务时的秘钥一致。
类型:String
约束:需要和有效的 x-kss-server-side-encryption-customer-algorithm,x-kss-server-side-encryption-customer-key-MD5 同时使用
x-kss-server-side-encryption-customer-algorithm 如果服务端使用了用户提供的加密秘钥加密,在请求解密时,响应将会包含该头部来确认使用的解密算法。
类型:String
有效值:AES256
约束:需要和有效的 x-kss-server-side-encryption-customer-key,x-kss-server-side-encryption-customer-key-MD5 同时使用
x-kss-server-side-encryption-customer-key-MD5 如果服务端使用了用户提供的加密秘钥加密,在请求解密时,响应将会包含该头部来提供用户提供加密秘钥的数据一致性验证信息。
类型:String
约束:需要和有效的 x-kss-server-side-encryption-customer-key,x-kss-server-side-encryption-customer-algorithm 同时使用

如果作为数据源的对象使用用户秘钥进行服务端加密,用户需要使用下列头部使KS3能够对对象解密。

名称 描述 是否必选
x-kss-copy-source-server-side-encryption-customer-key 由用户指定KS3解密时使用的 base64-encoded 加密秘钥,其值必须数据源对象创建时使用的秘钥一致。
类型:String
约束:需要和有效的 x-kss-server-side-encryption-customer-algorithm,x-kss-server-side-encryption-customer-key-MD5 同时使用
x-kss-copy-source-server-side-encryption-customer-algorithm 指定数据源对象解密使用的解密算法。
类型:String
有效值:AES256
约束:需要和有效的 x-kss-server-side-encryption-customer-key,x-kss-server-side-encryption-customer-key-MD5 同时使用
x-kss-copy-source-server-side-encryption-customer-key-MD5 如果服务端使用了用户提供的加密秘钥加密,在请求解密时,响应将会包含该头部来提供用户提供加密秘钥的数据一致性验证信息。
类型:String
约束:需要和有效的 x-kss-server-side-encryption-customer-key,x-kss-server-side-encryption-customer-algorithm 同时使用

请求内容

该接口不使用请求内容。

响应

响应头部

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

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

响应内容

名称 描述
CopyPartResult 响应内容的容器。
类型: Container
父节点: 无
ETag 返回一个新块的实体标签。
类型: String
父节点: CopyPartResult
LastModified 返回最后被修改的时间日期。
类型: String
父节点: CopyPartResult

示例

请求示例

PUT /new-video.rm?partNumber=2 &uploadId=6aaf37c7501847569c91f9957b01fd14 HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
Date: Mon, 11 Apr 2011 20:34:56 GMT
x-kss-copy-source: /source-bucket/sourceobject
x-kss-copy-source-range:bytes=500-6291456
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
Date: Mon, 11 Apr 2011 20:34:56 GMT
x-kss-request-id: f86mgt82ketobs6lcpib5no5lmo38q11
Server: KS3

<CopyObjectResult>
    <LastModified>2009-10-28T22:32:00</LastModified>
    <ETag>"9b2cf535f27731c974343645a3985328"</ETag>
</CopyObjectResult>

错误码

错误码 HTTP状态码 描述
NoSuchUpload 404 指定的分块上传任务不存在。可能是上传ID无效,也可能是分块上传任务已经完成或放弃。
NoSuchKey 404 指定的文件不存在。
NoSuchBucket 404 指定的桶不存在。
InvalidObjectState 403 源文件存储类型是归档存储,未解冻时调用该接口。
InvalidRequest 400 指定数据源对象不支持按字节范围进行拷贝。
InvalidPartNum 400 超出PartNumber取值范围(1~10000)。
InvalidStorageClass 400 源文件存储类型与目的文件存储类型不一致。
文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈