Amazon S3 レプリケーションの除外と Multi-Region key resolution を試してみた

Amazon S3 レプリケーションの除外と Multi-Region key resolution を試してみた

Amazon S3 レプリケーションの除外と Multi-Region key resolution を、東京からバージニア北部への複製で試しました。プレフィックスの除外は、Filter の Not で指定できました。別々のマルチリージョンキーで暗号化したオブジェクトは、1つのルールで複製されました。
2026.11.20

はじめに

2026年11月18日に、Amazon S3 レプリケーションへ除外と Multi-Region key resolution が追加されました。

https://aws.amazon.com/jp/about-aws/whats-new/2026/11/amazon-s3-replication-exclusions-multi-region-key-resolution/

除外を使うと、指定したプレフィックスやタグを持つオブジェクトを複製対象から外せます。

Multi-Region key resolution は、送信元のキーに対応する、宛先リージョンのマルチリージョンキーでレプリカを暗号化する機能です。

この記事では、プレフィックスの除外と、マルチリージョンキーで暗号化したオブジェクトの複製を確かめました。

検証環境

構成

送信元は東京、宛先はバージニア北部で、どちらもバージョニングを有効にしています。

Not と UseSourceMultiRegionKey は、AWS CLI 2.41.1 以降で使えます。

確認コマンド

結果は次の2つのコマンドで確認しました。以降の表のステータスは head-object、宛先の有無は list-objects-v2 の結果です。

aws s3api head-object --bucket <SOURCE_BUCKET> --key <KEY> --region ap-northeast-1 --query 'ReplicationStatus' --output text
aws s3api list-objects-v2 --bucket <DEST_BUCKET> --region us-east-1 --query 'Contents[].Key'

除外されたオブジェクトの head-object 応答には ReplicationStatus の項目がありません。そのため --output text では None と表示されます。

除外

プレフィックスの除外

Filter 直下に Not を置くと、バケット全体からプレフィックス logs/ だけを外せます。

replication.json
{
  "Role": "arn:aws:iam::<ACCOUNT_ID>:role/<ROLE_NAME>",
  "Rules": [
    {
      "ID": "all-except-logs",
      "Status": "Enabled",
      "Priority": 1,
      "Filter": { "Not": { "Prefix": "logs/" } },
      "DeleteMarkerReplication": { "Status": "Disabled" },
      "Destination": { "Bucket": "arn:aws:s3:::<DEST_BUCKET>" }
    }
  ]
}
aws s3api put-bucket-replication --bucket <SOURCE_BUCKET> --region ap-northeast-1 --replication-configuration file://replication.json

app/a.txt、logs/a.log、root.txt を書き込んだ結果です。

キー ReplicationStatus 宛先
app/a.txt COMPLETED あり
logs/a.log 項目なし なし
root.txt COMPLETED あり

And や Or を使った複数条件と、タグでの除外については、AWS CLI リファレンスを参照してください。

https://docs.aws.amazon.com/cli/latest/reference/s3api/put-bucket-replication.html

Multi-Region key resolution

設定

テナント(顧客)ごとに別のキーで暗号化する構成を想定します。マルチリージョンキー2つ(tenant-a、tenant-b)を東京に作成し、それぞれのレプリカキーをバージニア北部に作成します。

for t in a b; do
  ID=$(aws kms create-key --region ap-northeast-1 --multi-region --description "tenant-$t" --query KeyMetadata.KeyId --output text)
  echo "tenant-$t $ID"
  aws kms replicate-key --region ap-northeast-1 --key-id "$ID" --replica-region us-east-1 --query ReplicaKeyMetadata.KeyId --output text
done

レプリケーション設定は1ルールです。KMS で暗号化されたオブジェクトを対象にする SseKmsEncryptedObjects と、UseSourceMultiRegionKey を有効にします。

replication.json
{
  "Role": "arn:aws:iam::<ACCOUNT_ID>:role/<ROLE_NAME>",
  "Rules": [
    {
      "ID": "all-kms-objects-mrk",
      "Status": "Enabled",
      "Priority": 1,
      "Filter": { "Prefix": "" },
      "DeleteMarkerReplication": { "Status": "Disabled" },
      "SourceSelectionCriteria": { "SseKmsEncryptedObjects": { "Status": "Enabled" } },
      "Destination": {
        "Bucket": "arn:aws:s3:::<DEST_BUCKET>",
        "EncryptionConfiguration": { "UseSourceMultiRegionKey": { "Status": "Enabled" } }
      }
    }
  ]
}
aws s3api put-bucket-replication --bucket <SOURCE_BUCKET> --region ap-northeast-1 --replication-configuration file://replication.json

レプリケーションロールには、送信元キーに対する kms:Decrypt と、宛先キーに対する kms:Encrypt、kms:GenerateDataKey を許可します。S3 の権限を持つロールは作成済みの前提で、KMS の権限を足します。

ロールの KMS 権限(role-kms-policy.json)
role-kms-policy.json
{
  "Version": "2012-10-17",
  "Statement": [
    {"Effect": "Allow", "Action": ["kms:Decrypt"],
     "Resource": [
       "arn:aws:kms:ap-northeast-1:<ACCOUNT_ID>:key/<KEY_ID_A>", "arn:aws:kms:ap-northeast-1:<ACCOUNT_ID>:key/<KEY_ID_B>"]},
    {"Effect": "Allow", "Action": ["kms:Encrypt", "kms:GenerateDataKey"],
     "Resource": [
       "arn:aws:kms:us-east-1:<ACCOUNT_ID>:key/<KEY_ID_A>", "arn:aws:kms:us-east-1:<ACCOUNT_ID>:key/<KEY_ID_B>"]}
  ]
}
aws iam put-role-policy --role-name <ROLE_NAME> --policy-name kms-replication --policy-document file://role-kms-policy.json

複製結果

tenant-a、tenant-b のマルチリージョンキーを指定して、オブジェクトを書き込みました。tenant-a の例です。

aws s3api put-object --bucket <SOURCE_BUCKET> --key tenant-a/doc.txt --body <FILE> --region ap-northeast-1 --server-side-encryption aws:kms --ssekms-key-id <KEY_ID_A>

どちらのオブジェクトも COMPLETED になりました。

tenant-a のオブジェクトを、送信元と宛先で比べた結果です。

aws s3api head-object --bucket <SOURCE_BUCKET> --key tenant-a/doc.txt --region ap-northeast-1 --query '{ServerSideEncryption:ServerSideEncryption,SSEKMSKeyId:SSEKMSKeyId,ReplicationStatus:ReplicationStatus}'
aws s3api head-object --bucket <DEST_BUCKET> --key tenant-a/doc.txt --region us-east-1 --query '{ServerSideEncryption:ServerSideEncryption,SSEKMSKeyId:SSEKMSKeyId,ReplicationStatus:ReplicationStatus}'

送信元の応答です。

{
    "ServerSideEncryption": "aws:kms",
    "SSEKMSKeyId": "arn:aws:kms:ap-northeast-1:<ACCOUNT_ID>:key/<KEY_ID_A>",
    "ReplicationStatus": "COMPLETED"
}

宛先の応答です。

{
    "ServerSideEncryption": "aws:kms",
    "SSEKMSKeyId": "arn:aws:kms:us-east-1:<ACCOUNT_ID>:key/<KEY_ID_A>",
    "ReplicationStatus": "REPLICA"
}

送信元のオブジェクトは東京のキーで、レプリカは宛先リージョン(us-east-1)のレプリカキーで暗号化されていました。

まとめ

除外では、Filter に Not を置くと、プレフィックスを複製対象から外せます。複製しないオブジェクトがある場合に、レプリケーションルールを簡潔に書けるようになりました。

KMS キーで暗号化したオブジェクトの複製は、従来はキーごとにルールが必要でした。Multi-Region key resolution により、テナントごとのマルチリージョンキーで暗号化したオブジェクトは、1つのルールで複製できるようになりました。

特にテナント数が多い場合や、一部のパスを外すためにルールが増えて管理が負担になっていた場合は、ぜひ試してみてください。

この記事をシェアする

AWSのお困り事はクラスメソッドへ

関連記事