文档首页/ 对象存储服务 OBS/ API参考/ API/ 桶的高级配置/ 获取桶的跨区域复制配置
更新时间：2025-08-13 GMT+08:00
分享

获取桶的跨区域复制配置

功能介绍

获取指定桶的复制配置信息。执行该配置操作前需要确保执行者拥有GetReplicationConfiguration权限。

请求消息样式

1
2
3
4
 
GET /?replication HTTP/1.1 
Host: bucketname.obs.cn-north-4.myhuaweicloud.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
21
 
HTTP/1.1 status_code 
Date: date 
Server:OBS 
Content-Length: contentlength 

<?xml version="1.0" encoding="UTF-8"?> 
<ReplicationConfiguration xmlns="http://obs.cn-north-4.myhuaweicloud.com/doc/2006-03-01/">
 
  <Agency>testAcy</Agency>
  <Rule> 
      <ID>rule1</ID> 
      <Status>Enabled</Status> 
      <Prefix></Prefix> 
      <Destination> 
         <Bucket>exampletargetbucket</Bucket> 
         <StorageClass>WARM</StorageClass> 
         <DeleteData>Enabled</DeleteData>
      </Destination> 
      <HistoricalObjectReplication>Enabled</HistoricalObjectReplication>
  </Rule> 
</ReplicationConfiguration>

响应消息头

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

响应消息元素

在此请求返回的响应消息体中包含的配置元素如下描述。

表1 获取桶的复制配置元素

参数

参数类型

描述

ReplicationConfiguration

Container

参数解释：

跨区域复制规则的容器。ReplicationConfiguration是Rule和Agency的父节点。

取值范围：

不涉及

Rule

Container

参数解释：

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

取值范围：

请详见Rule参数说明。

Agency

String

参数解释：

用户创建的委托名字。

取值范围：

长度为0~64的字符串。
表2 Rule参数说明

参数

参数类型

描述

ID

String

参数解释：

跨区域复制规则的规则ID。

取值范围：

长度为0~255的字符串。

Status

String

参数解释：

是否启用跨区域复制规则。

取值范围：

  • Enabled：启用规则
  • Disabled：未启用规则

Prefix

String

参数解释：

对象名的前缀。

取值范围：

经过UTF-8编码的长度大于0且不超过1024的字符序列，规则之间前缀的字符不支持重叠。例如用户配置了两条规则，规则1的前缀为object，规则2的前缀是obj，则这两条规则就有个重叠的前缀obj。

Destination

Container

参数解释：

目标桶信息的容器。

取值范围：

请详见Destination参数说明。

HistoricalObjectReplication

String

参数解释：

是否复制符合跨区域复制规则的历史对象。

取值范围：

  • Enabled：复制符合跨区域复制规则的历史对象
  • Disabled：不复制符合跨区域复制规则的历史对象
表3 Destination参数说明

参数

参数类型

描述

Bucket

String

参数解释：

存储被跨区域复制规则标识的对象副本的桶名称。

取值范围：

长度为3~63的字符串。

StorageClass

String

参数解释：

表示复制到目标桶的对象将被修改成的目标存储类别。

取值范围：

  • STANDARD：标准存储
  • WARM：低频访问存储
  • COLD：归档存储
  • DEEP_ARCHIVE：深度归档存储（受限公测）

DeleteData

String

参数解释：

源桶的对象删除后是否通过跨区域复制操作同步删除目标桶中的同名对象。

取值范围：

  • Enabled：源桶的对象删除操作会同步到目标端。
  • Disabled：源桶的对象删除操作不会同步到目标端。

错误响应消息

在此请求的响应中错误响应消息如下描述。

表4 桶的错误响应元素

错误码

描述

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.cn-north-4.myhuaweicloud.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
23
24
 
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.cn-north-4.myhuaweicloud.com/doc/2006-03-01/">
 
  <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>  
  <Agency>testAcy</Agency> 
</ReplicationConfiguration>
父主题： 桶的高级配置

相关文档