調用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沒有配置資料複製規則。 |