GetBucketReplication を使用したデータレプリケーション規則の取得 - OSS

バケットに構成されているデータレプリケーションルールを照会します。

リクエスト構文

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

レスポンスパラメータ

パラメータ	タイプ	例	説明
ReplicationConfiguration	コンテナ	N/A	データレプリケーション構成を格納するコンテナ。親ノード：なし子ノード：Rule
Rule	コンテナ	N/A	データレプリケーションルールを格納するコンテナ。親ノード：ReplicationConfiguration 子ノード：Destination、HistoricalObjectReplication、Status、および ID
ID	文字列	test_replication_1	データレプリケーションルールの ID。親ノード：Rule 子ノード：なし
PrefixSet	コンテナ	N/A	プレフィックスを格納するコンテナ。各データレプリケーションルールには、最大 10 個のプレフィックスを指定できます。親ノード：Rule 子ノード：Prefix
Prefix	文字列	source1	宛先バケットにレプリケートされるオブジェクトのプレフィックス。親ノード：PrefixSet 子ノード：なし
Action	文字列	PUT	宛先バケットに同期される操作。 Action パラメータには、次の操作タイプの 1 つ以上を設定できます。デフォルト値：ALL。 ALL：PUT、DELETE、および ABORT 操作が宛先バケットに同期されることを示します。 PUT：書き込み操作が宛先バケットに同期されることを示します。PutObject、PostObject、AppendObject、CopyObject、PutObjectACL、InitiateMultipartUpload、UploadPart、UploadPartCopy、および CompleteMultipartUpload 操作が含まれます。親ノード：Rule 子ノード：なし
Status	文字列	doing	データレプリケーショスクのステータス。有効な値： starting：データレプリケーションルールが構成された後、OSS はデータレプリケーショスクを作成します。この場合、タスクの状態は starting です。 doing：データレプリケーションルールが有効になった後のデータレプリケーショスクの状態。この場合、タスクの状態は doing です。 closing：対応するデータレプリケーションルールが削除された後、OSS はデータレプリケーショスクをクリアします。この場合、タスクの状態は closing です。親ノード：Rule 子ノード：なし
Destination	コンテナ	N/A	宛先バケットに関する情報を格納するコンテナ。親ノード：Rule 子ノード：Bucket および Location
Bucket	文字列	destbucket	データがレプリケートされる宛先バケット。親ノード：Destination 子ノード：なし
Location	文字列	oss-cn-beijing	宛先バケットが配置されているリージョン。親ノード：Destination 子ノード：なし
TransferType	文字列	oss_acc	データレプリケーションでデータ転送に使用されるデータ転送タイプ。TransferType パラメータは、リクエストで TransferType パラメータの値が oss_acc に設定されている場合にのみ、レスポンスに含まれます。デフォルト値：internal。有効な値： internal：OSS のデフォルトのデータ転送リンクを使用するデータ転送タイプ。 oss_acc：データ転送が高速化されるリンク。CRR ルールを作成する場合にのみ、TransferType パラメータを oss_acc に設定できます。
HistoricalObjectReplication	文字列	disabled	データレプリケーションが有効になる前に、ソースバケットの既存データが宛先バケットにレプリケートされるかどうかを示します。デフォルト値：enabled。デフォルト値：disabled。有効な値： enabled：既存データが宛先バケットにレプリケートされることを示します。 disabled：既存データが宛先バケットにレプリケートされないことを示します。ソースバケットのデータレプリケーションが有効になった後にソースバケットにアップロードされたデータのみがレプリケートされます。親ノード：Rule 子ノード：なし
SyncRole	文字列	aliyunramrole	データレプリケーションに使用されるロール。このパラメータは、宛先オブジェクトが Key Management Service ( KMS ) で管理されるカスタマーマスターキー ( CMK ) を使用したサーバ側暗号化 ( SSE ) ( SSE - KMS ) によって暗号化されている場合にのみ、レスポンスに含まれます。
RTC	コンテナ	N/A	RTC 機能のステータスを格納するコンテナ。親ノード：Rule 子ノード：Status
Status	文字列	enbaled	RTC 機能のステータス。このパラメータは、RTC 機能が enabling または enabled 状態の場合にのみ、レスポンスに含まれます。デフォルト値：disabled。有効な値： 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>

OSS SDK

以下のプログラミング言語の OSS SDK を使用して GetBucketReplication を呼び出すことができます。

ossutil

GetBucketReplication 操作に対応する ossutil コマンドについては、「get-bucket-replication」をご参照ください。

エラーコード

エラーコード	HTTP ステータスコード	説明
NoSuchBucket	404 NotFound	指定されたバケットが存在しないために返されるエラーメッセージ。
NoSuchReplicationConfiguration	404 NotFound	指定されたバケットにデータレプリケーションルールが構成されていないために返されるエラーメッセージ。