设置桶的跨区域复制配置
功能介绍
跨区域复制是指跨不同区域中的桶自动、异步地复制对象。通过激活跨区域复制,OBS可将新创建的对象及修改的对象从一个源桶复制到不同区域中的目标桶。
设置桶的跨区域复制,需要满足以下两个要求:
- 要求源桶和目标桶多版本状态保持一致,否则不能设置replication。如何设置桶的多版本,请参见设置桶的多版本状态。
- 源桶的拥有者和代理人(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 21 |
PUT /?replication HTTP/1.1 Host: bucketname.obs.cn-north-4.myhuaweicloud.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> <StorageClass>STANDARD</StorageClass> <DeleteData>Enabled</DeleteData> </Destination> <HistoricalObjectReplication>Enabled</HistoricalObjectReplication> </Rule> </ReplicationConfiguration> |
请求消息参数
该请求消息中不使用消息参数。
请求消息头
该请求使用的消息头如下所示。
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
Content-MD5 |
是 |
string |
参数解释: 按照RFC 1864标准计算出消息体的MD5摘要字符串,即消息体128bit MD5值经过base64编码后得到的字符串。如何计算Content-MD5可参考Java中Content-MD5的计算方法示例。 取值范围: 不涉及 默认取值: 不涉及 |
请求消息元素
在此请求中,需要在请求的消息体中配置桶的复制配置,通知的配置信息(请求body)以XML格式上传。具体的配置元素如下描述。
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
ReplicationConfiguration |
是 |
Container |
参数解释: 跨区域复制规则的容器。ReplicationConfiguration是Rule和Agency的父节点。 约束限制:
取值范围: 不涉及 默认取值: 不涉及 |
Rule |
是 |
Container |
参数解释: 一条特定跨区域复制规则信息的容器。 约束限制: 一个桶上可以配置1~100条跨区域复制规则。 取值范围: 请详见Rule参数说明。 默认取值: 不涉及 |
Agency |
是 |
String |
参数解释: 用户创建用于跨区域复制的委托的名称。 约束限制: 不涉及 取值范围: 长度为0~64的字符串。 默认取值: 不涉及 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
ID |
否 |
String |
参数解释: 跨区域复制规则的规则ID。 约束限制: 规则ID不能重复。 取值范围: 长度为0~255的字符串。 默认取值: 不涉及 |
Status |
是 |
String |
参数解释: 是否启用此跨区域复制规则。 约束限制: 不涉及 取值范围:
默认取值: 不涉及 |
Prefix |
是 |
String |
参数解释: 对象名的前缀。适配于一个或者多个对象。 约束限制:
取值范围: 经过UTF-8编码的长度大于0且不超过1024的字符序列。 默认取值: 不涉及 |
Destination |
是 |
Container |
参数解释: 目标桶信息的容器。 约束限制: 不涉及 取值范围: 请详见Destination参数说明。 默认取值: 不涉及 |
HistoricalObjectReplication |
否 |
String |
参数解释: 是否复制符合跨区域复制规则的历史对象。 约束限制: 不涉及 取值范围:
默认取值: 如果不设置,则默认为Disabled。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
Bucket |
是 |
String |
参数解释: 跨区域复制目标桶的桶名,该桶用于存储被跨区域复制规则标识的对象副本。 约束限制: 如果在跨区域复制配置中有多条规则,这些规则必须都要标识同一个桶作为目标桶。 取值范围: 长度为3~63的字符串。 默认取值: 不涉及 |
StorageClass |
否 |
String |
参数解释: 表示复制到目标桶的对象将被修改成的目标存储类别。 约束限制: 不涉及 取值范围:
默认取值: 不涉及 |
DeleteData |
否 |
String |
参数解释: 源桶的对象删除后是否通过跨区域复制操作同步删除目标桶中的同名对象。 约束限制: 不涉及 取值范围:
默认取值: 如果不设置,则默认为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 23 |
PUT /?replication HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.cn-north-4.myhuaweicloud.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> <StorageClass>STANDARD</StorageClass> <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 |