注釈テーブルの有効化または無効化

注釈テーブルを有効または無効にするには

1. AWS マネジメントコンソール にサインインし、Amazon S3 コンソール https://console.aws.amazon.com/s3/ を開きます。

2. 左のナビゲーションペインで、[汎用バケット] を選択します。

3. 注釈テーブルを有効または無効にするメタデータテーブル設定を持つ汎用バケットを選択します。

4. バケットの詳細ページで、[メタデータ] タブを選択します。

5. [メタデータ] タブで、[編集] を選択し、[注釈テーブル設定を編集] を選択します。

6. [注釈テーブル設定を編集] ページで、[注釈テーブル] の [有効] または [無効] を選択します。

   注記

   [有効] を選択する前に、[前提条件] を確認し、満たしていることを確認してください。

   • [有効] を選択した場合は、[IAM ロール] で、次のいずれかの IAM ロール選択方法を選択します。

     • 新しい IAM ロールの作成 – Amazon S3 は、注釈テーブルに必要なアクセス許可を持つ新しい IAM ロールを作成します。

     • 既存の IAM ロールから選択 – [IAM ロール] ドロップダウンから、既存の IAM ロールを選択します。このロールには、バケットから注釈を読み取るために必要なアクセス許可が必要です。

     • IAM ロールの ARN の入力 – 必要なアクセス許可を持つ既存の IAM ロールの ARN を入力します。

     注釈テーブルの IAM ロールに必要なアクセス許可の詳細については、「Annotation table IAM role」を参照してください。

     AWS Key Management Service (AWS KMS) キー (SSE-KMS) を使用してサーバー側の暗号化でテーブルを暗号化するかどうかを選択することもできます。デフォルトでは、注釈バケットは、Amazon S3 マネージドキーによるサーバー側の暗号化 (SSE-S3) を使用して暗号化されます。

     SSE-KMS を使用する場合は、汎用バケットと同じリージョンにカスタマーマネージド KMS キーを指定する必要があります。

     重要

     メタデータテーブルの暗号化タイプは、テーブルの作成中にのみ設定できます。AWS マネージドテーブルの作成後は、暗号化設定を変更することはできません。

     • 注釈テーブルを SSE-S3 (デフォルト) で暗号化するには、[暗号化タイプを指定しない] を選択します。

     • 注釈テーブルを SSE-KMS で暗号化するには、[暗号化タイプを指定する] を選択します。[暗号化タイプ] で、[AWS Key Management Service (AWS KMS) キー (SSE-KMS) を使用したサーバー側の暗号化] を選択します。[AWS KMS キー] で、既存の KMS キーから選択するか、KMS キー ARN を入力します。KMS キーがまだない場合は、[KMS キー ARN を入力] を選択し、[KMS キーを作成する] を選択します。

   • [無効] を選択した場合は、[注釈テーブルが無効になると、テーブルは更新されなくなり、更新を再開できなくなる] チェックボックスをオンにします。

7. [Save changes] (変更の保存) をクリックします。

AWS CLI を使用して注釈テーブルを有効または無効にするには

次のコマンド例を使用する際は、user input placeholders をユーザー自身の情報に置き換えます。

1. 注釈テーブル設定を含む JSON ファイルを作成し、保存します (例: annotation-config.json)。以下は、新しい注釈テーブルを有効にするための設定例です。

   注釈テーブルを有効にする場合は、オプションで暗号化設定を指定できます。デフォルトでは、メタデータテーブルは Amazon S3 マネージドキー (SSE-S3) を使用したサーバー側の暗号化で暗号化されます。この暗号化は、SseAlgorithm を AES256 に設定することで指定できます。

   AWS Key Management Service (AWS KMS) キー (SSE-KMS) を使用したサーバー側の暗号化を使用して注釈テーブルを暗号化するには、SseAlgorithm を aws:kms に設定します。また、汎用バケットがあるリージョンと同じリージョンで、カスタマーマネージド KMS キーの ARN に KmsKeyArn を設定する必要があります。

   {
     "ConfigurationState": "ENABLED",
     "Role": "arn:aws:iam::account-id:role/annotation-table-role",
     "EncryptionConfiguration": {
       "SseAlgorithm": "aws:kms",
       "KmsKeyArn": "arn:aws:kms:us-east-2:account-id:key/key-id"
     }
   }

   注釈テーブルを初めて有効にする場合、または IAM ロールを変更する場合、Role フィールドは必須です。このロールは、バケットから注釈を読み取るためのアクセス許可を Amazon S3 メタデータに付与する必要があります。詳細については、「Annotation table IAM role」を参照してください。

   既存の注釈テーブルを無効にする場合は、次の設定を使用します。

   {
     "ConfigurationState": "DISABLED"  }
   

2. 次のコマンドを使用して、汎用バケットの注釈テーブル設定を更新します (例: amzn-s3-demo-bucket)。

   aws s3api update-bucket-metadata-annotation-table-configuration \
   --bucket amzn-s3-demo-bucket \
   --annotation-table-configuration file://./annotation-config.json \
   --region us-east-2