GetBucketReplication - Object Storage Service

調用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允許以下操作類型，您可以指定一項或多項。 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 子節點：無

樣本

請求樣本

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