186
云计算
负载均衡
产品简介
产品价格
快速入门
用户指南
实践操作
常见问题
购买指南
云服务器
产品简介
计费规则
购买指导
控制台使用指南
常见问题
云数据库
产品简介
计费规则
购买指导
快速入门
连接实例
控制台使用指南
对象存储
产品简介
控制台使用指南
程序员百科
Python
天翼云对象存储(经典版)I型API参考-PUT Object - Copy

产品推荐:

1、安全稳定的云服务器租用,2核/2G/5M仅37元,点击抢购>>>

2、高防物理服务器20核/16G/50M/500G防御仅350元,点击抢购>>>

3、百度智能建站(五合一网站)仅880元/年,点击抢购>>> 模板建站(PC+手机站)仅480元/年,点击抢购>>>

4、阿里云服务器2核2G3M仅99元/年、2核4G5M仅199元/年,新老同享,点击抢购>>> 

5、腾讯云服务器2核2G4M仅99元/年、新老同享,点击抢购>>>   



点击这里注册天翼云特邀VIP帐号,立即体验天翼云对象存储>>>


天翼云对象存储(经典版)I型API参考-PUT Object - Copy


此操作用来创建一个存储在OOS里的对象拷贝。类似于执行一个GET,然后再执行一次PUT。要执行拷贝请求,用户需要对源对象有读权限,对目标Bucket有写权限。

注意:当OOS接收到请求或者正在执行拷贝操作时,拷贝操作可能会返回失败。如果在拷贝操作开始之前出现异常,OOS返回标准的错误信息。如果在拷贝操作过程中出现异常,由于200 OK状态码是先返回的,这意味着200 OK响应体可能包含成功或错误。请在客户端应用程序中解析响应体的内容并进行适当处理。


请求语法

PUT   /destinationObject   HTTP/1.1

Host:   destinationBucket.oos-cn.ctyunapi.cn

x-amz-copy-source:   /source_bucket/sourceObject

x-amz-metadata-directive:   metadata_directive

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

x-amz-meta-paramater: value

Authorization:   signatureValue

Date:   date


请求头

名称

描述

是否必须

x-amz-copy-source

源Bucket和对象的名称,用斜杠(/)分割。

类型:字符串

x-amz-metadata-directive

指明元数据是源对象的拷贝或者元数据被请求头提供的元数据覆盖。

类型:字符串

取值:

l  COPY:除存储类型(x-amz-storage-class)、数据位置(x-ctyun-data-location)外的其他元数据保持不变,拷贝源对象的元数据;

l  REPLACE:所有原始元数据都被指定的元数据覆盖。

默认值为COPY。

注意:如果取值为COPY,源对象和目的对象相同,则必须携带x-amz-storage-class,否则不能拷贝,返回400错误码。

x-amz-copy-source-if-match

只有当源对象的Etag与给定Etag匹配时,才能执行对象拷贝操作,否则返回412HTTP状态码错误。

类型:字符串

x-amz-copy-source-if-none-match

只有当源对象的Etag与给定Etag不匹配时,才能执行对象拷贝操作,否则返回412HTTP状态码错误。

类型:字符串

x-amz-copy-source-if-unmodified-since

只有源对象在指定时间点之后没有修改,才执行对象拷贝操作,否则返回412错误。

类型:字符串。

取值:符合https://tools.ietf.org/html/rfc7232规定格式的HTTP时间字符串。

x-amz-copy-source-if-modified-since

只有源对象在指定时间点之后修改过,才执行对象拷贝操作,否则返回412错误。

类型:字符串。

取值:符合https://tools.ietf.org/html/rfc7232规定格式的HTTP时间字符串。

x-amz-storage-class

目标对象的存储类型。

类型:字符串

取值:

l  STANDARD:标准存储

l  STANDARD_IA:低频访问存储

默认值为STANDARD。

x-ctyun-data-location

设置数据存储的位置。

注意:香港节点不支持此参数。

类型:字符串

格式为:type=Local,scheduleStrategy=scheduleStrategy或者type=Specified,location=location,scheduleStrategy=scheduleStrategy

l  type:指定数据存储位置的类型,取值为Local或者Specified。Local表示就近写入,Specified表示指定位置。如果type取值为Specified,则需要指定具体的数据位置location,location可以填写多个,以逗号分隔,可取值为ChengDu、GuiYang、LaSa、LanZhou、QingDao、SH2、ShenYang、ShenZhen、SuZhou、WuHan、WuHu、WuLuMuQi、ZhengZhou。

l  scheduleStrategy:调度策略,取值为:

Ø  Allowed:允许OOS自动调度数据存储位置

Ø  NotAllowed:不允许OOS自动调度数据存储位置。

x-amz-meta-paramater

用户自定义的元数据,用户可以根据需要,自定义一些元数据的参数。

类型:字符串


响应结果

名称

描述

CopyObjectResult

包含所有返回元素的容器。

类型:容器。

子节点:LastModified、Etag。

LastModified

返回对象最后一次修改的日期。

类型:字符串。

父节点:CopyObjectResult。

ETag

返回新对象的ETag。ETag只反映对象内容发生了改变,元数据未改变。

类型:字符串。

父节点:CopyObjectResult。

请求示例

将存储桶testbucket001中的对象1.txt复制一份到本存储桶,新对象命名为2.txt。

PUT /2.txt HTTP/1.1
Host: testbucket001.oos-dhv6.ctyunapi.cn
User-Agent: curl/7.68.0
Accept: */*
x-amz-date: 20210625T033636Z
x-amz-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
Content-Type: application/x-www-form-urlencoded; charset=utf-8
x-amz-copy-source: /testbucket001/1.txt
Content-Length: 0
Authorization: AWS4-HMAC-SHA256 Credential=abd20200520202020/20210625/dhv6/s3/aws4_request, SignedHeaders=content-length;content-type;host;x-amz-content-sha256;x-amz-copy-source;x-amz-date, Signature=8c7022d7adc24ae1bcb218e37ca7ff35076ce2ca5a2140a2225f9370e95f8b6f


响应示例

HTTP/1.1 200 OK
Date: Fri, 25 Jun 2021 03:37:22 GMT
x-amz-request-id: 28fcb1549c45469228746b7c827f82616880808d8876918e66
Content-Type: application/xml
Transfer-Encoding: chunked
Server: CTYUN
 
<CopyObjectResult><LastModified>2021-06-25T03:37:23.727Z</LastModified><ETag>eb733a00c0c9d336e65691a37ab54293</ETag></CopyObjectResult>


这条帮助是否解决了您的问题? 已解决 未解决

提交成功!非常感谢您的反馈,我们会继续努力做到更好! 很抱歉未能解决您的疑问。我们已收到您的反馈意见,同时会及时作出反馈处理!