文档首页/对象存储服务 OBS/API参考/桶API/桶的跨区域复制/获取桶的跨区域复制配置-GetBucketReplication
更新时间：2026-03-30 GMT+08:00
查看PDF
分享

获取桶的跨区域复制配置-GetBucketReplication

功能介绍

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

授权信息

您必须是桶拥有者或拥有获取桶的跨区域复制配置的权限，才能调用本接口，建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。

  • 如果使用IAM授权，那么请在“角色与策略授权”、“身份策略授权”两种IAM授权方式中选择一种，并配置相应权限：
    • 如果使用角色与策略授权（旧版IAM，即IAM v3接口），需具备obs:bucket:GetReplicationConfiguration权限，授权操作请参见创建IAM自定义策略。
    • 如果使用身份策略授权（新版IAM，即IAM v5接口），如下表所示，需具备obs:bucket:getReplicationConfiguration权限，授权操作请参见创建IAM自定义身份策略。

      授权项

      Action

      访问级别

      Access Level

      资源类型（*为必须）

      Resource Type (*: required)

      条件键

      Condition Key

      别名

      Alias

      依赖的授权项

      Dependencies

      obs:bucket:getReplicationConfiguration

      Read

      bucket *

      -

      -

      -

      • obs:EpochTime
      • obs:SourceIp
      • obs:TlsVersion
      • obs:CustomDomain
  • 如果使用桶策略进行授权，需具备obs:bucket: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
22
23
24
25
26
27
28
29
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> 
        <Filter>
            <Not>
                <Tag>
                    <Key>key1</Key>
                    <Value>value1</Value>
                </Tag>
            </Not>
        </Filter>
      <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：不复制符合跨区域复制规则的历史对象

Filter

Container

参数解释：

支持传入标签，实现复制指定过滤条件的对象。

取值范围：

And、Not、Tag三选一

默认取值：

无

表3 Destination参数说明

参数

参数类型

描述

Bucket

String

参数解释：

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

取值范围：

长度为3~63的字符串。

StorageClass

String

参数解释：

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

取值范围：

  • STANDARD：标准存储
  • WARM：低频访问存储
  • COLD：归档存储
  • DEEP_ARCHIVE：深度归档存储

DeleteData

String

参数解释：

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

取值范围：

  • Enabled：源桶的对象删除操作会同步到目标端。
  • Disabled：源桶的对象删除操作不会同步到目标端。
表4 Filter参数说明

名称

参数类型

描述

And

Container

参数解释：

并列条件，条件同时满足才复制

取值范围：

Tag

Not

Container

参数解释：

指定条件不复制。

取值范围：

Tag

Tag

Container

参数解释：

指定标签的对象才能被复制。

取值范围：

不涉及

Key

String

参数解释：

标签的键

取值范围：

不涉及

Value

String

参数解释：

标签的值

取值范围：

不涉及

错误响应消息

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

表5 桶的错误响应元素

错误码

描述

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
25
26
27
28
29
30
31
32
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>
    <Filter>
          <Not>
              <Tag>
                  <Key>key1</Key>
                  <Value>value1</Value>
              </Tag>
          </Not>
    </Filter>
    <Destination> 
      <Bucket>dstbucket</Bucket>  
      <StorageClass>STANDARD</StorageClass> 
      <DeleteData>Enabled</DeleteData>
    </Destination>
    <HistoricalObjectReplication>Enabled</HistoricalObjectReplication> 
  </Rule>  
  <Agency>testAcy</Agency> 
</ReplicationConfiguration>

相关文档

父主题： 桶的跨区域复制

相关文档