全部產品
Search
文件中心

Object Storage Service:GetBucketReplication

更新時間:Jun 08, 2024

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