すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:GetBucketReplication

最終更新日:Feb 21, 2024

バケットに設定されているデータレプリケーション規則を照会します。

リクエスト構文

GET /? レプリケーションHTTP/1.1
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
権限付与: SignatureValue 

レスポンスパラメーター

パラメーター

データ型

説明

ReplicationConfiguration

Container

N/A

データレプリケーション設定を格納するコンテナー。

親ノード: なし

子ノード: ルール

ルール

Container

N/A

データレプリケーション規則を格納するコンテナー。

親ノード: ReplicationConfiguration

子ノード: 宛先、HistoricalObjectReplication、Status、ID

ID

String

test_replication_1

データレプリケーションルールのID。

親ノード: ルール

子ノード: なし

PrefixSet

Container

N/A

プレフィックスを格納するコンテナー。 各データレプリケーションルールには、最大10個のプレフィックスを指定できます。

親ノード: ルール

子ノード: プレフィックス

接頭辞

String

ソース1

宛先バケットにレプリケートされるオブジェクトのプレフィックス。

親ノード: PrefixSet

子ノード: なし

Action

String

PUT

宛先バケットに同期される操作。

Actionパラメーターは、次の1つ以上の操作タイプに設定できます。 デフォルト値: ALL。

  • ALL: PUT、DELETE、およびABORT操作が宛先バケットに同期されることを示します。

  • PUT: PutObject、PostObject、AppendObject、CopyObject、PutObjectACL、InitiateMultipartUpload、UploadPart、UploadPartCopy、CompleteMultipartUpload操作など、書き込み操作が宛先バケットに同期されることを示します。

親ノード: ルール

子ノード: なし

Status

String

やっている

データ複製タスクのステータス。

有効な値:

  • starting: データレプリケーションルールを設定した後、OSSはデータレプリケーションタスクを作成します。 この場合、タスクの状態は開始中です。

  • doing: データレプリケーションルールが有効になった後のデータレプリケーションタスクの状態。 この場合、タスクの状態は実行中です。

  • closing: 対応するデータレプリケーションルールが削除された後、OSSはデータレプリケーションタスクをクリアします。 この場合、タスクの状態は閉じています。

親ノード: ルール

子ノード: なし

目的地

Container

N/A

宛先バケットに関する情報を格納するコンテナー。

親ノード: ルール

子ノード: バケットと場所

バケット

String

destbucket

データがレプリケートされる宛先バケット。

親ノード: 宛先

子ノード: なし

位置

String

oss-cn-beijing

宛先バケットが配置されているリージョン。

親ノード: 宛先

子ノード: なし

TransferType

String

oss_acc

データレプリケーションでデータを転送するために使用されるデータ転送タイプ。 TransferTypeパラメーターは、リクエストでTransferTypeパラメーターの値がoss_accに設定されている場合にのみ、レスポンスに含まれます。

デフォルト値: internal。 有効な値:

  • internal: OSSのデフォルトのデータ転送リンクを使用するデータ転送タイプ。

  • oss_acc: データ送信が加速されるリンク。 CRRルールを作成する場合にのみ、TransferTypeパラメーターをoss_accに設定できます。

HistoricalObjectReplication

String

disabled

データレプリケーションを有効にする前に、ソースバケットの履歴データをターゲットバケットにレプリケートするかどうかを示します。 デフォルト値:enabled。

デフォルト値: disabled。 有効な値:

  • enabled: 履歴データが宛先バケットにレプリケートされることを示します。

  • disabled: 履歴データが宛先バケットにレプリケートされないことを示します。 ソースバケットのデータレプリケーションが有効になった後にソースバケットにアップロードされたデータのみがレプリケートされます。

親ノード: ルール

子ノード: なし

SyncRole

String

aliyunramrole

データレプリケーションに使用されるロール。 このパラメーターは、キー管理サービス (KMS) が管理する顧客マスターキー (CMK) を使用して暗号化 (SSE-KMS) を行うサーバー側暗号化 (SSE) を使用して宛先オブジェクトを暗号化する場合にのみ、レスポンスに含まれます。

RTC

Container

N/A

RTC機能のステータスを格納するコンテナー。

親ノード: ルール

子ノード: ステータス

Status

String

enbaled

RTC機能のステータス。 このパラメータは、RTC機能が有効または有効状態にある場合にのみ応答に含まれます。

デフォルト値: disabled。 有効な値:

  • 有効化

  • enabled

  • disabled

親ノード: RTC

子ノード: なし

  • リクエストの例

GET /? レプリケーションHTTP/1.1
ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
日付: 9月2015日木曜日15:39:15 GMT
承認: OSS qn6qrrqxo2oawuk53otf ****:CTkuxpLAi4XZ + WwIfNm0Fmgb **** 
  • レスポンスの例

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906 ****
日付: 9月2015日木曜日15:39:15 GMT
コンテンツ-長さ: 186
Content-Type: application/xml
接続: 閉じる
サーバー: AliyunOSS
<?xml version="1.0" ?>
<ReplicationConfiguration>
  <Rule>
    <ID>test_replication_1</ID>
    <PrefixSet>
      <プレフィックス> source1</プレフィックス>
      <Prefix> ビデオ </Prefix>
    </PrefixSet>
    <アクション> PUT</Action>
    <宛先>
      <Bucket>destbucket</Bucket>
      <Location>oss-cn-beijing</Location>
      <TransferType>oss_acc</TransferType>
    </宛先>
    <ステータス> 実行中 </ステータス>
    <HistoricalObjectReplication>enabled</HistoricalObjectReplication>
    <SyncRole>aliyunramrole</SyncRole>
    <RTC>
      <Status>enabled</Status>
    </RTC>
  </ルール>
</ReplicationConfiguration> 

エラーコード

エラーコード

HTTP ステータスコード

説明

NoSuchBucket

404 NotFound

指定されたバケットが存在しない場合に返されるエラーメッセージ。

NoSuchReplicationConfiguration

404 NotFound

指定されたバケットにデータレプリケーションルールが設定されていない場合に返されるエラーメッセージ。