更新时间:2024-04-15 GMT+08:00

设置桶的跨区域复制配置

功能介绍

跨区域复制是指跨不同区域中的桶自动、异步地复制对象。通过激活跨区域复制,OBS可将新创建的对象及修改的对象从一个源桶复制到不同区域中的目标桶。

如果已经设置过桶的跨集群或跨区域复制配置,再次设置将会覆盖已有的复制策略。

配置跨区域复制需要选择IAM委托,配置方法请参见《对象存储用户指南》的“创建IAM委托”章节。

设置桶的跨区域复制,需要满足以下两个要求:

  1. 要求源桶和目标桶多版本状态保持一致,否则不能设置replication。如何设置桶的多版本,请参见设置桶的多版本状态
  2. 源桶的拥有者和代理人(OBS)必须要有目标桶的写权限(目标桶需要配置BucketPolicy),同时代理人(OBS)还要有源桶的读权限。这需要通过“BucketPolicy”来实现这个权限委托。

如何设置桶策略,请参见设置桶策略。设置桶策略后,代理人(OBS)就有权限可以读取源桶的对象,也有权限将对象复制到目标桶中。

请求消息样式

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
PUT /?replication HTTP/1.1 
Host: bucketname.obs.region.example.com
x-obs-date: date 
Content-MD5: MD5
Authorization: authorization string 
Content-Length: contentlength 

<ReplicationConfiguration> 
    <Agency>testAcy</Agency>
    <Rule> 
        <ID>rule1</ID> 
        <Prefix>key-prefix</Prefix> 
        <Status>rule-status</Status> 
        <Destination> 
            <Bucket>targetbucketname</Bucket> 
            <DeleteData>Enabled</DeleteData>
        </Destination> 
        <HistoricalObjectReplication>Enabled</HistoricalObjectReplication>
    </Rule> 
</ReplicationConfiguration>

请求消息参数

该请求消息中不使用消息参数。

请求消息头

该请求使用的消息头如下所示。

表1 设置桶的复制配置请求消息头

名称

描述

是否必选

Content-MD5

按照RFC 1864标准计算出消息体的MD5摘要字符串,即消息体128-bit MD5值经过base64编码后得到的字符串。

请求消息元素

在此请求中,需要在请求的消息体中配置桶的复制配置,通知的配置信息以XML格式上传。具体的配置元素如下描述。

表2 设置桶的复制配置元素

名称

描述

是否必须

ReplicationConfiguration

复制规则的容器,最多可以达到100条规则,所有的复制配置大小可达到50KB。

类型:Container

子节点:Rule

父节点:无

Agency

用户创建的委托名字,最大长度为64字符。

类型:String

父节点:ReplicationConfiguration

Rule

一条特定复制规则信息的容器。

复制配置必须至少配置一条规则,最多能达到100条规则。

类型:Container

父节点:

ReplicationConfiguration

ID

规则的特殊辨识符,最大长度为255字符。

类型:String

父节点:Rule

Status

如果Status为Disabled,这条规则会被忽略。

类型:String

父节点:Rule

有效值:Enabled,Disabled

Prefix

对象键值名的前缀,适配于一个或者多个对象。如果前缀配置为空,则跨区域复制规则将作用于整个桶。

最大前缀长度可达到为1024个字节,不支持重叠的前缀。

类型:String

父节点:Rule

Destination

目标桶信息的容器。

类型:Container

父节点:Rule

Bucket

存储被规则标识的对象副本的桶名称。

如果在复制配置中有多条规则,这些规则必须都要标识同一个桶作为目标桶。

类型:String

父节点:Destination

DeleteData

删除同步复制关键字,如果为Enabled,源桶的对象删除操作会复制到目标端。

类型:String

父节点:Destination

有效值:Enabled,Disabled(如果不设置,则默认为Disabled)

HistoricalObjectReplication

历史对象复制关键字,如果为Enabled,会复制符合这条规则的历史对象。

类型:String

父节点:Rule

有效值:Enabled, Disabled(如果不设置,则默认为Disabled)

响应消息样式

1
2
3
4
HTTP/1.1 status_code 
Server: OBS 
Date:date 
Content-Length: contentlength

响应消息头

该请求的响应消息使用公共消息头,具体请参考表1

响应消息元素

该请求的响应消息中不带有响应元素。

错误响应消息

在此请求的响应中不会返回特殊错误。

请求示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
PUT /?replication HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.example.com
Accept: */*
Date: Wed, 27 Jun 2018 13:39:15 +0000
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:CdeqU0Vg9xNdJMZ0PGPgh5EnkO0=
Content-MD5: l/Z8mfSX+VyV8k5EhIQz5Q==
Content-Length: 330

<ReplicationConfiguration>
   <Agency>testAcy</Agency>
   <Rule>
       <ID>Rule-1</ID>
       <Status>Enabled</Status>
       <Prefix></Prefix>
       <Destination>
          <Bucket>dstbucket</Bucket>
          <DeleteData>Enabled</DeleteData>
       </Destination>      
       <HistoricalObjectReplication>Enabled</HistoricalObjectReplication>
     </Rule>
</ReplicationConfiguration>

响应示例

1
2
3
4
5
6
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: B59500000164417839932E5A2295674C
x-obs-id-2: 32AAAQAAEAABKAAQAAEAABAAAQAAEAABCStv51t2NMMx+Ou+ow7IWV4Sxo231fKe
Date: Wed, 27 Jun 2018 13:39:15 GMT
Content-Length: 0