10.7.4. S3 バケットレプリケーション API

手順

1. レプリケーションの詳細を含むレプリケーション設定ファイルを作成します。

   構文

   {
   "Role": "arn:aws:iam::account-id:role/role-name",
       "Rules": [
           {
               "ID": "String",
               "Status": "Enabled",
               "Priority": 1,
               "DeleteMarkerReplication": { "Status": "Enabled"|"Disabled" },
               "Destination": {
                   "Bucket": "BUCKET_NAME"
               }
           }
       ]
   }

   例

   [root@host01 ~]# cat replication.json
   {
       "Role": "arn:aws:iam::account-id:role/role-name",
       "Rules": [
           {
               "ID": "pipe-bkt",
               "Status": "Enabled",
               "Priority": 1,
               "DeleteMarkerReplication": { "Status": "Disabled" },
               "Destination": {
                   "Bucket": "testbucket"
               }
           }
       ]
   }

2. S3 API の put バケットレプリケーションを作成します。

   構文

   aws --endpoint-url=RADOSGW_ENDPOINT_URL s3api put-bucket-replication --bucket BUCKET_NAME --replication-configuration file://REPLICATION_CONFIIRATION_FILE.json

   例

   [root@host01 ~]# aws --endpoint-url=http://host01:80 s3api put-bucket-replication --bucket testbucket --replication-configuration file://replication.json

検証

1. sync policy get コマンドを使用して、同期ポリシーを確認します。

   構文

   radosgw-admin sync policy get --bucket BUCKET_NAME

   注記

   レプリケーションポリシーを適用すると、ルールは パイプ と呼ばれる同期ポリシールールに変換され、enabled と disabled に分類されます。

   • Enabled: パイプは有効かつアクティブであり、グループステータスは 'rgw_sync_policy_group:STATUS' に設定されています。たとえば、s3-bucket-replication:enabled です。
   • Disabled: この配下のパイプは非アクティブで、グループステータスは 'rgw_sync_policy_group:STATUS' に設定されています。たとえば、s3-bucket-replication:disabled です。

   複数のルールをレプリケーションポリシーの一部として設定できるため、各グループを正確にマッピングするために 2 つの異なるグループ (1 つは 'enabled' の状態、もう 1 つは 'allowed' の状態) があります。

   例

   [ceph: root@host01 /]# radosgw-admin sync policy get --bucket testbucket
   {
       "groups": [
           {
               "id": "s3-bucket-replication:disabled",
               "data_flow": {},
               "pipes": [],
               "status": "allowed"
           },
           {
               "id": "s3-bucket-replication:enabled",
               "data_flow": {},
               "pipes": [
                   {
                       "id": "",
                       "source": {
                           "bucket": "*",
                           "zones": [
                               "*"
                           ]
                       },
                       "dest": {
                           "bucket": "testbucket",
                           "zones": [
                               "*"
                           ]
                       },
                       "params": {
                           "source": {},
                           "dest": {},
                           "priority": 1,
                           "mode": "user",
                           "user": "s3cmd"
                       }
                   }
               ],
               "status": "enabled"
           }
       ]
   }