设置桶的跨集群复制配置
功能介绍
跨集群复制是指跨不同集群中的桶自动、异步地复制对象。通过激活跨集群复制,OBS可将新创建的对象及修改的对象从一个源桶复制到相同区域、不同集群中的目标桶。
![](https://support.huaweicloud.com/intl/zh-cn/tr-central-201-api-obs/public_sys-resources/note_3.0-zh-cn.png)
如果已经设置过桶的跨集群或跨区域复制配置,再次设置将会覆盖已有的复制策略。
设置桶的跨集群复制,需要满足以下两个要求:
请求消息样式
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
PUT /?replication HTTP/1.1 Host: bucketname.obs.region.example.com x-obs-date: date Content-MD5: l/Z8mfSX+VyV8k5EhIQz5Q== 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> </Destination> </Rule> </ReplicationConfiguration> |
请求消息参数
该请求消息中不使用消息参数。
请求消息头
该请求使用的消息头如下所示。
名称 |
描述 |
是否必选 |
---|---|---|
Content-MD5 |
按照RFC 1864标准计算出消息体的MD5摘要字符串,即消息体128-bit MD5值经过base64编码后得到的字符串。 |
是 |
请求消息元素
在此请求中,需要在请求的消息体中配置桶的复制配置,通知的配置信息以XML格式上传。具体的配置元素如下描述。
名称 |
描述 |
是否必须 |
---|---|---|
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 |
否 |
HistoricalObjectReplication |
历史对象复制关键字,如果为Enabled,会复制符合这条规则的历史对象。 类型:String 父节点:Rule 有效值:Enabled,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 |