喜讯：国内、香港、海外云服务器租用特惠活动，2核/4G/10M仅需31元每月，点击抢购>>>
点击这里注册天翼云特邀VIP帐号，立即体验天翼云对象存储>>>
天翼云对象存储（经典版）I型API参考-Copy Part
可以将已经存在的Object作为分段上传的片段，拷贝生成一个新的片段。需要指定请求头x-amz-copy-source来定义拷贝源。如果只拷贝源Object中的一部分，需要增加请求头x-amz-copy-source-range。PartNumber为新对象分片号，UploadId为新对象的分片上传ID。
在上传任何一个分片之前，必须执行Initial Multipart Upload操作来初始化分片上传操作，初始化成功后，OOS会返回一个上传ID，这是一个唯一的标识，用户必须在调用Copy Part接口时加入该ID。
请求语法
PUT /ObjectName?partNumber=PartNumber&uploadId=UploadId HTTP/1.1 Host: BucketName.oos-cn.ctyunapi.cn x-amz-copy-source: /source_bucket/sourceObject x-amz-copy-source-range:bytes=first-last x-amz-copy-source-if-match: etag x-amz-copy-source-if-none-match: etag x-amz-copy-source-if-unmodified-since: time_stamp x-amz-copy-source-if-modified-since: time_stamp Date: Date Authorization: Signature |
请求头
名称 | 描述 | 是否必须 |
x-amz-copy-source | 指定源bucketname和objectname，用斜杠/分隔。 类型：字符串。 | 是 |
x-amz-copy-source-range | 要从源object拷贝的bytes范围。Range值的格式是bytes=第一个字节-最后一个字节。第一个字节从0开始。例如要拷贝前10个字节，bytes=0-9。只允许对大于5G的源object进行部分拷贝的操作。 如果要拷贝整个object，不需要这个头。 复制整个源对象时不需要此请求标头。 类型：字符串。 | 否 |
x-amz-copy-source-if-match | 只有对象的实体Etag与给定Etag匹配，才执行拷贝对象的操作；否则，返回412HTTP状态码错误。 类型：字符串。 | 否 |
x-amz-copy-source-if-none-match | 只有对象实体Etag和指定实体Etag不同，才执行拷贝操作；否则，返回412错误。 类型：字符串。 | 否 |
x-amz-copy-source-if-unmodified-since | 只有对象在指定时间点之后没有修改过，才执行拷贝操作；否则，返回412错误。 类型：字符串。 | 否 |
x-amz-copy-source-if-modified-since | 只有对象在指定时间点之后被修改过，才执行拷贝操作；否则，返回412错误。 类型：字符串。 | 否 |
响应结果
名称 | 描述 |
CopyPartResult | 包含整个响应的容器。 类型：容器 父节点：无 |
LastModified | 分片的最后修改时间。 类型：字符串 父节点：CopyPartResult |
ETag | 新分片的ETag。 类型：字符串 父节点：CopyPartResult |
请求示例
通过从源Object中指定范围，拷贝生成一个新片段。
PUT /newobject?partNumber=2&uploadId=738428231343369398 HTTP/1.1
Host: example-bucket.oos-cn.ctyunapi.cn
Date: Mon, 11 Apr 2011 20:34:56 GMT
x-amz-copy-source: /source-bucket/sourceobject
x-amz-copy-source-range:bytes=500-6291456
Authorization: AWS 7799e793ce4624ee7e5a:xQE0diMbLRepdf3YB+FIEXAMPLE=
响应示例
HTTP/1.1 200 OK
x-amz-request-id: 996c76696e6727732072657175657374
Date: Mon, 1 Nov 2010 20:34:56 GMT
Server: CTYUN
<CopyPartResult xmlns=”http://s3.amazonaws.com/doc/2006-03-01/”>
<LastModified>2009-10-28T22:32:00</LastModified>
<ETag>9b2cf535f27731c974343645a3985328</ETag>
</CopyPartResult>
推荐：TOP云智能建站优惠活动，仅880元即可搭建一个后台管理五端合一的智能网站（PC网站、手机网站、百度智能小程序、微信小程序、支付宝小程序），独享百度搜索SEO优势资源，让你的网站不仅有颜值有排面，更有排名，可以实实在在为您带来效益，请点击进入TOP云智能建站>>>，或咨询在线客服了解详情。
湘公网安备43019002001857号
备案号：
客服1 