調用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 |
ID | 字符串 | test_replication_1 | 復制規則對應的ID。 父節點:Rule 子節點:無 |
PrefixSet | 容器 | 不涉及 | 保存前綴(Prefix)的容器。每條復制規則中,最多可指定10個Prefix。 父節點:Rule 子節點:Prefix |
Prefix | 字符串 | source1 | 被復制到目標Bucket中Object的前綴(Prefix)。 父節點:PrefixSet 子節點:無 |
Action | 字符串 | PUT | 表示被同步到目標Bucket的操作。 Action允許以下操作類型,您可以指定一項或多項。
父節點:Rule 子節點:無 |
Status | 字符串 | doing | 表示復制狀態。 取值:
父節點:Rule 子節點:無 |
Destination | 容器 | 不涉及 | 保存目標Bucket信息的容器。 父節點:Rule 子節點:Bucket和Location |
Bucket | 字符串 | destbucket | 數據要復制到的目標Bucket。 父節點:Destination 子節點:無 |
Location | 字符串 | oss-cn-beijing | 目標Bucket所處的Location。 父節點:Destination 子節點:無 |
TransferType | 字符串 | oss_acc | 數據復制時使用的數據傳輸類型。僅當傳輸類型為oss_acc時,返回示例中才會包含此元素。 取值:
|
HistoricalObjectReplication | 字符串 | disabled | 是否復制歷史數據。即開啟數據復制前,是否將源Bucket中的已有的數據復制到目標Bucket。 取值:
父節點:Rule 子節點:無 |
SyncRole | 字符串 | aliyunramrole | 跨區域復制時使用的角色。僅當使用SSE-KMS加密目標對象時,返回示例中才會包含此元素。 |
RTC | 容器 | 不涉及 | 保存RTC狀態規則的容器。 父節點:Rule 子節點:Status |
Status | 字符串 | enbaled | RTC服務的狀態。僅當RTC狀態為enabling或enabled時,返回示例中才會包含此元素。 取值:
父節點:RTC 子節點:無 |
示例
請求示例
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>
<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>
錯誤碼
錯誤碼 | 狀態碼 | 說明 |
NoSuchBucket | 404 NotFound | 請求的Bucket不存在。 |
NoSuchReplicationConfiguration | 404 NotFound | 請求的Bucket沒有配置數據復制規則。 |