バケットに設定されているデータレプリケーション規則を照会します。
リクエスト構文
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。
親ノード: ルール 子ノード: なし |
Status | String | やっている | データ複製タスクのステータス。 有効な値:
親ノード: ルール 子ノード: なし |
目的地 | Container | N/A | 宛先バケットに関する情報を格納するコンテナー。 親ノード: ルール 子ノード: バケットと場所 |
バケット | String | destbucket | データがレプリケートされる宛先バケット。 親ノード: 宛先 子ノード: なし |
位置 | String | oss-cn-beijing | 宛先バケットが配置されているリージョン。 親ノード: 宛先 子ノード: なし |
TransferType | String | oss_acc | データレプリケーションでデータを転送するために使用されるデータ転送タイプ。 TransferTypeパラメーターは、リクエストでTransferTypeパラメーターの値がoss_accに設定されている場合にのみ、レスポンスに含まれます。 デフォルト値: internal。 有効な値:
|
HistoricalObjectReplication | String | disabled | データレプリケーションを有効にする前に、ソースバケットの履歴データをターゲットバケットにレプリケートするかどうかを示します。 デフォルト値:enabled。 デフォルト値: disabled。 有効な値:
親ノード: ルール 子ノード: なし |
SyncRole | String | aliyunramrole | データレプリケーションに使用されるロール。 このパラメーターは、キー管理サービス (KMS) が管理する顧客マスターキー (CMK) を使用して暗号化 (SSE-KMS) を行うサーバー側暗号化 (SSE) を使用して宛先オブジェクトを暗号化する場合にのみ、レスポンスに含まれます。 |
RTC | Container | N/A | RTC機能のステータスを格納するコンテナー。 親ノード: ルール 子ノード: ステータス |
Status | String | enbaled | RTC機能のステータス。 このパラメータは、RTC機能が有効または有効状態にある場合にのみ応答に含まれます。 デフォルト値: 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 | 指定されたバケットにデータレプリケーションルールが設定されていない場合に返されるエラーメッセージ。 |