GetBucketReplication を呼び出して、バケットに設定されたデータレプリケーションルールを照会します - Object Storage Service

バケットに設定されたデータレプリケーションルールを照会します。

リクエスト構文

GET /?replication HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com 
Date: GMT 日付
Authorization: 署名値

応答要素

名前	型	例	説明
ReplicationConfiguration	コンテナ	該当なし	バケットのデータレプリケーションルールを格納するコンテナ。親ノード：なし子ノード：Rule
Rule	コンテナ	該当なし	レプリケーションルールを格納するコンテナ。親ノード：ReplicationConfiguration 子ノード：Destination、HistoricalObjectReplication、Status、ID、UserTaggings
ID	文字列	test_replication_1	レプリケーションルールの ID。親ノード：Rule 子ノード：なし
PrefixSet	コンテナ	該当なし	プレフィックスを格納するコンテナ。各レプリケーションルールでは、最大 10 個のプレフィックスを指定できます。親ノード：Rule 子ノード：Prefix
Prefix	文字列	source1	送信先バケットへレプリケーションされるオブジェクトのプレフィックス。親ノード：PrefixSet 子ノード：なし
Action	文字列	PUT	送信先バケットへレプリケーションされる操作。 Action では以下の操作タイプをサポートしており、1 つ以上のタイプを指定できます。 ALL（デフォルト）：PUT、DELETE、ABORT 操作が送信先バケットへレプリケーションされます。 PUT：PutObject、PostObject、AppendObject、CopyObject、PutObjectACL、InitiateMultipartUpload、UploadPart、UploadPartCopy、CompleteMultipartUpload などの書き込み操作が送信先バケットへレプリケーションされます。親ノード：Rule 子ノード：なし
Status	文字列	doing	レプリケーションのステータス。有効な値： starting：レプリケーションルールが設定された後、OSS はレプリケーションタスクの準備を行います。このフェーズでは、レプリケーションステータスは starting となります。 doing：レプリケーションルールが有効であり、データがレプリケーション中です。 closing：レプリケーションルールが削除された後、OSS はクリーンアップ処理を行います。このフェーズでは、レプリケーションステータスは closing となります。親ノード：Rule 子ノード：なし
Destination	コンテナ	該当なし	送信先バケットの情報を格納するコンテナ。親ノード：Rule 子ノード：Bucket、Location
Bucket	文字列	destbucket	データがレプリケーションされる送信先バケット。親ノード：Destination 子ノード：なし
Location	文字列	oss-cn-beijing	送信先バケットが配置されているリージョン。親ノード：Destination 子ノード：なし
TransferType	文字列	oss_acc	レプリケーションに使用されるデータ転送タイプ。この要素は、TransferType が oss_acc の場合のみ応答に含まれます。有効な値： internal（デフォルト）：標準の OSS 転送リンク。 oss_acc：転送アクセラレーションリンク。転送アクセラレーションリンクは、クロスリージョンレプリケーション（CRR）ルールでのみ利用可能です。
HistoricalObjectReplication	文字列	disabled	既存データのレプリケーションを有効にするかどうかを指定します。既存データとは、レプリケーションルールが有効になる前にソースバケットに存在していたオブジェクトを指します。有効な値： enabled（デフォルト）：既存データが送信先バケットへレプリケーションされます。 disabled：既存データはレプリケーションされません。レプリケーションルールが有効になってから書き込まれたデータのみがレプリケーションされます。親ノード：Rule 子ノード：なし
SyncRole	文字列	aliyunramrole	クロスリージョンレプリケーションに使用されるロール。この要素は、SSE-KMS 暗号化済みオブジェクトがレプリケーションされる場合にのみ応答に含まれます。
RTC	コンテナ	該当なし	レプリケーションタイムコントロール（RTC）のステータスを格納するコンテナ。親ノード：Rule 子ノード：Status
Status	文字列	有効	RTC のステータス。この要素は、RTC ステータスが enabling または enabled の場合にのみ応答に含まれます。有効な値： enabling：RTC が有効化中です。 enabled：RTC が有効です。 disabled（デフォルト）：RTC は無効です。親ノード：RTC 子ノード：なし
UserTaggings	コンテナ	該当なし	タグベースのフィルタールールを格納するコンテナ。この要素は、タグベースのフィルタールールが設定されている場合にのみ応答に含まれます。親ノード：Rule 子ノード：FilterType、UserTagging
FilterType	文字列	OR	タグフィルター方式。大文字と小文字を区別します。有効な値： AND：フィルタールールで指定されたすべてのタグに一致するオブジェクトのみをレプリケーションします。 OR：フィルタールールで指定されたいずれかのタグに一致するオブジェクトをレプリケーションします。親ノード：UserTaggings 子ノード：なし
UserTagging	コンテナ	該当なし	単一のキーと値のペアを格納するコンテナ。最大 10 個のタグを指定できます。親ノード：UserTaggings 子ノード：Key、Value
Key	文字列	key1	タグキー。最大長：128 文字。大文字と小文字を区別します。使用可能な文字：英字、数字、空白、および以下の特殊文字（+‑=._:/）。親ノード：UserTagging 子ノード：なし
Value	文字列	value1	タグ値。最大長：256 文字。大文字と小文字を区別します。使用可能な文字：英字、数字、空白、および以下の特殊文字（+‑=._:/）。親ノード：UserTagging 子ノード：なし

サンプル

リクエストのサンプル

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>
    <UserTaggings>
      <FilterType>OR</FilterType>
      <UserTagging>
        <Key>key1</Key>
        <Value>value1</Value>
      </UserTagging>
      <UserTagging>
        <Key>key2</Key>
        <Value>value2</Value>
      </UserTagging>
    </UserTaggings>
    <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>

SDK

この操作で利用可能な SDK は以下のとおりです：

コマンドラインツール ossutil

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

エラーコード

エラーコード	HTTP ステータスコード	説明
NoSuchBucket	404 NotFound	指定されたバケットが存在しません。
NoSuchReplicationConfiguration	404 NotFound	指定されたバケットに対してデータレプリケーションルールが設定されていません。