调用GetBucketReplication接口获取Bucket已设置的数据复制规则 - 对象存储 OSS

调用GetBucketReplication接口获取某个存储空间（Bucket）已设置的数据复制规则。

请求语法

GET /?replication HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com 
Date: GMT Date
Authorization: SignatureValue

响应元素

名称	类型	示例值	描述
ReplicationConfiguration	容器	不涉及	Bucket复制规则的容器。父节点：无子节点：Rule
Rule	容器	不涉及	保存复制规则的容器。父节点：ReplicationConfiguration 子节点：Destination、HistoricalObjectReplication、Status、ID和UserTaggings
ID	字符串	test_replication_1	复制规则对应的ID。父节点：Rule 子节点：无
PrefixSet	容器	不涉及	保存前缀（Prefix）的容器。每条复制规则中，最多可指定10个Prefix。父节点：Rule 子节点：Prefix
Prefix	字符串	source1	被复制到目标Bucket中Object的前缀（Prefix）。父节点：PrefixSet 子节点：无
Action	字符串	PUT	表示被同步到目标Bucket的操作。 Action允许以下操作类型，您可以指定一项或多项。 ALL（默认值）：表示PUT、DELETE、ABORT操作均会被同步到目标Bucket。 PUT：表示被同步到目标Bucket的写入操作，包括PutObject、PostObject、AppendObject、CopyObject、PutObjectACL、InitiateMultipartUpload、UploadPart、UploadPartCopy、CompleteMultipartUpload。父节点：Rule 子节点：无
Status	字符串	doing	表示复制状态。取值： starting：设置数据复制规则后，OSS会为Bucket准备复制任务，此时的复制状态为starting。 doing：当数据复制规则生效后，即数据处于同步状态时，此时的复制状态为doing。 closing：删除数据复制规则后，OSS会自动完成清理工作，此时的复制状态为closing。父节点：Rule 子节点：无
Destination	容器	不涉及	保存目标Bucket信息的容器。父节点：Rule 子节点：Bucket和Location
Bucket	字符串	destbucket	数据要复制到的目标Bucket。父节点：Destination 子节点：无
Location	字符串	oss-cn-beijing	目标Bucket所处的Location。父节点：Destination 子节点：无
TransferType	字符串	oss_acc	数据复制时使用的数据传输类型。仅当传输类型为oss_acc时，返回示例中才会包含此元素。取值： internal（默认值）：OSS默认传输链路。 oss_acc：传输加速链路。只有创建跨区域复制规则时才能使用传输加速链路。
HistoricalObjectReplication	字符串	disabled	是否复制历史数据。即开启数据复制前，是否将源Bucket中的已有的数据复制到目标Bucket。取值： enabled（默认）：表示复制历史数据。 disabled：表示不复制历史数据，即仅复制数据复制规则生效后新写入的数据。父节点：Rule 子节点：无
SyncRole	字符串	aliyunramrole	跨区域复制时使用的角色。仅当使用SSE-KMS加密目标对象时，返回示例中才会包含此元素。
RTC	容器	不涉及	保存RTC状态规则的容器。父节点：Rule 子节点：Status
Status	字符串	enbaled	RTC服务的状态。仅当RTC状态为enabling或enabled时，返回示例中才会包含此元素。取值： enabling：RTC服务开启中。 enabled：RTC服务已开启。 disabled（默认值）：RTC服务已关闭。父节点：RTC 子节点：无
UserTaggings	容器	不涉及	保存标签过滤规则的容器。仅当配置了标签过滤规则时，返回结果中才会包含此元素。父节点：Rule 子节点：FilterType、UserTagging
FilterType	字符串	OR	标签过滤策略。区分大小写。取值： AND：Object中所有标签都在过滤规则设置的标签集合中时，才复制该Object。 OR：Object中任意一个标签在过滤规则设置的标签集合中时，即复制该Object。父节点：UserTaggings 子节点：无
UserTagging	容器	不涉及	保存单个标签键值对的容器。最多可指定10个标签。父节点：UserTaggings 子节点：Key、Value
Key	字符串	key1	标签键。最大长度为128个字符。区分大小写。合法字符包括字母、数字、空格以及以下符号：+‑=._:/ 父节点：UserTagging 子节点：无
Value	字符串	value1	标签值。最大长度为256个字符。区分大小写。合法字符包括字母、数字、空格以及以下符号：+‑=._:/ 父节点：UserTagging 子节点：无

示例

请求示例

GET /?replication HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com 
Date: Thu, 24 Sep 2015 15:39:15 GMT
Authorization: OSS qn6q**************:77Dv****************

返回示例

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906**** 
Date: Thu, 24 Sep 2015 15:39:15 GMT
Content-Length: 186
Content-Type: application/xml 
Connection: close
Server: AliyunOSS
<?xml version="1.0" ?>
<ReplicationConfiguration>
  <Rule>
    <ID>test_replication_1</ID>
    <PrefixSet>
      <Prefix>source1</Prefix>
      <Prefix>video</Prefix>
    </PrefixSet>
    <UserTaggings>
      <FilterType>OR</FilterType>
      <UserTagging>
        <Key>key1</Key>
        <Value>value1</Value>
      </UserTagging>
      <UserTagging>
        <Key>key2</Key>
        <Value>value2</Value>
      </UserTagging>
    </UserTaggings>
    <Action>PUT</Action>
    <Destination>
      <Bucket>destbucket</Bucket>
      <Location>oss-cn-beijing</Location>
      <TransferType>oss_acc</TransferType>
    </Destination>
    <Status>doing</Status>
    <HistoricalObjectReplication>enabled</HistoricalObjectReplication>
    <SyncRole>aliyunramrole</SyncRole>
    <RTC>
      <Status>enabled</Status>
    </RTC>
  </Rule>
</ReplicationConfiguration>

SDK

此接口所对应的各语言SDK如下：

命令行工具ossutil

GetBucketReplication接口所对应的ossutil命令，请参见get-bucket-replication。

错误码

错误码	状态码	说明
NoSuchBucket	404 NotFound	请求的Bucket不存在。
NoSuchReplicationConfiguration	404 NotFound	请求的Bucket没有配置数据复制规则。