获取桶的跨区域复制配置
功能介绍
获取指定桶的复制配置信息。执行该配置操作前需要确保执行者拥有GetReplicationConfiguration权限。
请求消息样式
1 2 3 4 |
GET /?replication HTTP/1.1 Host: bucketname.obs.region.example.com Date: date Authorization:authorization string |
请求消息参数
该请求消息中不使用消息参数。
请求消息头
该请求使用公共消息头，具体参见表3。
请求消息元素
该请求中不使用消息元素。
响应消息样式
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
HTTP/1.1 status_code Date: date Server:OBS Content-Length: contentlength <?xml version="1.0" encoding="UTF-8"?> <ReplicationConfiguration xmlns="http://obs.example.com/doc/2006-03-01/"> <Agency>testAcy</Agency> <Rule> <ID>rule1</ID> <Status>Enabled</Status> <Prefix></Prefix> <Destination> <Bucket>exampletargetbucket</Bucket> <DeleteData>Enabled</DeleteData> </Destination> <HistoricalObjectReplication>Enabled</HistoricalObjectReplication> </Rule> </ReplicationConfiguration> |
响应消息头
该请求的响应消息使用公共消息头，具体请参考表1。
响应消息元素
在此请求返回的响应消息体中包含的配置元素如下描述。
|
名称 |
描述 |
|---|---|
|
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） |
错误响应消息
在此请求的响应中错误响应消息如下描述。
|
错误码 |
描述 |
HTTP响应码 |
SOAP错误码前缀 |
|---|---|---|---|
|
NoSuchReplicationConfiguration |
跨region复制配置不存在 |
404 not found |
Client |
请求示例
1 2 3 4 5 6 |
GET /?replication HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.region.example.com Accept: */* Date: Wed, 27 Jun 2018 13:42:40 +0000 Authorization: OBS H4IPJX0TQTHTHEBQQCEC:jGHviInfRyOkT/EpySpua1hlBuY= |
响应示例
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 |
HTTP/1.1 200 OK Server: OBS x-obs-request-id: B59500000164417B57D02F7EF8823152 x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSHu6lz4vgk5G3E32OFcIPEZZgdOEYE/ Content-Type: application/xml Date: Wed, 27 Jun 2018 13:42:39 GMT Content-Length: 337 <?xml version="1.0" encoding="utf-8"?> <ReplicationConfiguration xmlns="http://obs.example.com/doc/2006-03-01/"> <Rule> <ID>Rule-1</ID> <Status>Enabled</Status> <Prefix></Prefix> <Destination> <Bucket>dstbucket</Bucket> <DeleteData>Enabled</DeleteData> </Destination> <HistoricalObjectReplication>Enabled</HistoricalObjectReplication> </Rule> <Agency>testAcy</Agency> </ReplicationConfiguration> |
