复制对象
功能介绍
复制对象（Copy Object）特性用来为OBS上已经存在的对象创建一个副本。
当进行复制对象操作时，目标对象默认复制源对象的元数据；用户也可以将目标对象的元数据替换为本次请求中所带的元数据。新建的目标对象不会复制源对象的ACL信息，默认的新建对象的ACL是private，用户可以使用设置ACL的操作接口来重新设定新对象的ACL。
复制对象操作的请求需要通过头域携带拷贝的原桶和对象信息，不能携带消息实体。
目标对象大小范围是[0, 5GB]，如果源对象大小超过5GB，只能使用拷贝段功能拷贝部分对象。
复制对象的结果不能仅根据HTTP返回头域中的status_code来判断请求是否成功，头域中status_code返回200时表示服务端已经收到请求，且开始处理复制对象请求。复制是否成功会在响应消息的body中，只有body体中有ETag标签才表示成功，否则表示复制失败。
多版本
默认情况下，x-obs-copy-source标识复制源对象的最新版本。如果源对象的最新版本是删除标记，则认为该对象已删除。要复制指定版本的对象，可以在x-obs-copy-source请求消息头中携带versionId参数。
如果目标对象的桶的多版本状态是开启的，系统为目标对象生成唯一的版本号（此版本号与源对象的版本号不同），并且会在响应报头x-obs-version-id返回该版本号。如果目标对象的桶的多版本状态是暂停的，则目标对象的版本号为null。
在桶没有开启多版本的情况下，将源对象object_A复制为目标对象object_B，如果在复制操作之前对象object_B已经存在，复制操作执行之后老对象object_B则会被新复制对象object_B覆盖，复制成功后，只能下载到新的对象object_B，老对象object_B将会被删除。因此在使用copy接口时请确保目标对象不存在或者已无价值，避免因copy导致数据误删除。复制过程中源对象object_A无任何变化。
请求消息样式
1 2 3 4 5 6 7 8 9 10 |
PUT /destinationObjectName HTTP/1.1 Host: bucketname.obs.region.example.com x-obs-copy-source: /sourceBucket/sourceObject x-obs-metadata-directive: metadata_directive x-obs-copy-source-if-match: etag x-obs-copy-source-if-none-match: etag x-obs-copy-source-if-unmodified-since: time_stamp x-obs-copy-source-if-modified-since: time_stamp Authorization: signature Date: date |
请求消息参数
该请求消息中不使用消息参数。
请求消息头
该消息可以带附加的消息头指定复制的信息，具体如表3所示。
|
消息头名称 |
描述 |
是否必选 |
|---|---|---|
|
x-obs-acl |
复制对象时，可以加上此消息头设置对象的权限控制策略，使用的策略为预定义的常用策略，包括：private；public-read；public-read-write。 类型：String 示例：x-obs-acl: acl |
否 |
|
x-obs-grant-read |
创建对象时，使用此头域授权domain下所有用户有读对象和获取对象元数据的权限 类型：String |
否 |
|
x-obs-grant-read-acp |
创建对象时，使用此头域授权domain下所有用户有获取对象ACL的权限。 类型：String |
否 |
|
x-obs-grant-write-acp |
创建对象时，使用此头域授权domain下所有用户有写对象ACL的权限。 类型：String |
否 |
|
x-obs-grant-full-control |
创建对象时，使用此头域授权domain下所有用户有读对象、获取对象元数据、获取对象ACL、写对象ACL的权限。 类型：String |
否 |
|
x-obs-copy-source |
用来指定复制对象操作的源桶名以及源对象名。当源对象存在多个版本时，通过versionId参数指定版本源对象。 类型：String 约束：中文字符与%，需要进行URLEncode 示例：x-obs-copy-source: /source_bucket/sourceObject |
是 |
|
x-obs-metadata-directive |
此参数用来指定新对象的元数据是从源对象中复制，还是用请求中的元数据替换。 类型：String 有效取值：COPY或REPLACE。 默认值：COPY。 示例：x-obs-metadata-directive: metadata_directive 约束条件：如果此参数的值不是COPY或REPLACE，则OBS立即返回400错误；如果用户进行修改元数据操作（源对象与目标对象相同），则此参数只能为REPLACE，否则此请求作为无效请求，服务端响应400。 |
否 |
|
x-obs-copy-source-if-match |
只有当源对象的Etag与此参数指定的值相等时才进行复制对象操作，否则返回412（前置条件不满足）。 类型：String 示例：x-obs-copy-source-if-match: etag 约束条件：此参数可与x-obs-copy-source-if-unmodified-since一起使用，但不能与其它条件复制参数一起使用。 |
否 |
|
x-obs-copy-source-if-none-match |
只有当源对象的Etag与此参数指定的值不相等时才进行复制对象操作，否则返回412（前置条件不满足）。 类型：String 示例：x-obs-copy-source-if-none-match: etag 约束条件：此参数可与x-obs-copy-source-if-modified-since一起使用，但不能与其它条件复制参数一起使用。 |
否 |
|
x-obs-copy-source-if-unmodified-since |
只有当源对象在此参数指定的时间之后没有修改过才进行复制对象操作，否则返回412（前置条件不满足），此参数可与x-obs-copy-source-if-match一起使用，但不能与其它条件复制参数一起使用。 类型：String 格式：符合http://www.ietf.org/rfc/rfc2616.txt规定格式的HTTP时间字符串。
对应示例：
约束条件：此参数指定的时间不能晚于当前的服务器时间（GMT时间），否则参数不生效。 |
否 |
|
x-obs-copy-source-if-modified-since |
只有当源对象在此参数指定的时间之后修改过才进行复制对象操作，否则返回412（前置条件不满足），此参数可与x-obs-copy-source-if-none-match一起使用，但不能与其它条件复制参数一起使用。 类型：String 格式：符合http://www.ietf.org/rfc/rfc2616.txt规定格式的HTTP时间字符串。
对应示例：
约束条件：此参数指定的时间不能晚于当前的服务器时间（GMT时间），否则参数不生效。 |
否 |
|
x-obs-website-redirect-location |
当桶设置了Website配置，可以将获取这个对象的请求重定向到桶内另一个对象或一个外部的URL，OBS将这个值从头域中取出，保存在对象的元数据中。 类型：String 默认值：无 约束：必须以“/”、“http://”或“https://”开头，长度不超过2K。 |
否 |
|
success_action_redirect |
此参数的值是一个URL，用于指定当此次请求操作成功响应后的重定向的地址。
类型：String |
否 |
其他消息头请参见表3章节。
请求消息元素
该请求在消息中不使用消息元素。
响应消息样式
1 2 3 4 5 6 7 8 9 10 |
HTTP/1.1 status_code Content-Type: application/xml Date: date Content-Length: length <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <CopyObjectResult xmlns="http://obs.region.example.com/doc/2015-06-30/"> <LastModified>modifiedDate</LastModified> <ETag>etagValue</ETag> </CopyObjectResult> |
响应消息元素
该请求的响应消息通过消息元素来返回复制结果，元素具体含义如表3所示。
错误响应消息
无特殊错误，所有错误已经包含在表2中。
请求示例：普通复制
普通对象拷贝，将桶bucket中的对象srcobject拷贝到桶examplebucket中destobject对象
1 2 3 4 5 6 7 |
PUT /destobject HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.region.example.com Accept: */* Date: WED, 01 Jul 2015 04:19:21 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:2rZR+iaH8xUewvUKuicLhLHpNoU= x-obs-copy-source: /bucket/srcobject |
响应示例：普通复制
1 2 3 4 5 6 7 8 9 10 11 12 |
HTTP/1.1 200 OK Server: OBS x-obs-request-id: 001B21A61C6C00000134031BE8005293 x-obs-id-2: MDAxQjIxQTYxQzZDMDAwMDAxMzQwMzFCRTgwMDUyOTNBQUFBQUFBQWJiYmJiYmJi Date: WED, 01 Jul 2015 04:19:21 GMT Content-Length: 249 <?xml version="1.0" encoding="utf-8"?> <CopyObjectResult xmlns="http://obs.region.example.com/doc/2015-06-30/"> <LastModified>2015-07-01T00:48:07.706Z</LastModified> <ETag>"507e3fff69b69bf57d303e807448560b"</ETag> </CopyObjectResult> |
请求示例：复制多版本对象
拷贝一个多版本对象，将桶bucket中的版本号为AAABQ4uBLdLc0vycq3gAAAAEVURTRkha的对象srcobject拷贝到桶examplebucket中destobject对象
1 2 3 4 5 6 7 |
PUT /destobject HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.region.example.com Accept: */* Date: WED, 01 Jul 2015 04:20:29 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:4BLYv+1UxfRSHBMvrhVLDszxvcY= x-obs-copy-source: /bucket/srcobject?versionId=AAABQ4uBLdLc0vycq3gAAAAEVURTRkha |
响应示例：复制多版本对象
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
HTTP/1.1 200 OK Server: OBS x-obs-request-id: DCD2FC9CAB78000001438B8A9C898B79 x-obs-id-2: DB/qBZmbN6AIoX9mrrSNYdLxwvbO0tLR/l6/XKTT4NmZspzharwp5Z74ybAYVOgr Content-Type: application/xml x-obs-version-id: AAABQ4uKnOrc0vycq3gAAAAFVURTRkha x-obs-copy-source-version-id: AAABQ4uBLdLc0vycq3gAAAAEVURTRkha Date: WED, 01 Jul 2015 04:20:29 GMT Transfer-Encoding: chunked <?xml version="1.0" encoding="utf-8"?> <CopyObjectResult xmlns="http://obs.region.example.com/doc/2015-06-30/"> <LastModified>2015-07-01T01:48:07.706Z</LastModified> <ETag>"507e3fff69b69bf57d303e807448560b"</ETag> </CopyObjectResult> |
