# メトリクス、イベント通知、ステータスによるレプリケーションのモニタリング
以下のメカニズムを使用して、ライブレプリケーション設定と S3 バッチレプリケーションジョブをモニタリングできます。
+ **S3 レプリケーションメトリクス** – S3 レプリケーションメトリクスを有効にすると、Amazon CloudWatch は、保留中のバイト数、保留中のオペレーション、レプリケーションレイテンシーをレプリケーションルールレベルで追跡するために使用できるメトリクスを出力します。S3 レプリケーションメトリクスは、Amazon S3 コンソールと Amazon CloudWatch コンソールから表示できます。Amazon S3 コンソールでは、ソースバケットの **[メトリクス]** タブでこれらのメトリクスを表示できます。S3 レプリケーションメトリクスの詳細については、「[S3 レプリケーションメトリクスの使用](repl-metrics.md)」を参照してください。
+ **S3 ストレージレンズメトリクス** – S3 レプリケーションメトリクスに加えて、S3 ストレージレンズダッシュボードが提供するレプリケーション関連のデータ保護メトリクスを使用できます。例えば、S3 ストレージレンズの無料のメトリクスを使用すると、ソースバケットからレプリケートされた総バイト数や、ソースバケットからレプリケートされたオブジェクトの数などのメトリクスを表示できます。
レプリケーションインスタンス全体を監査するには、S3 ストレージレンズで高度なメトリクスを有効にします。S3 ストレージレンズの高度なメトリクスを使用すると、無効なレプリケーション先を持つレプリケーションルールの数など、さまざまなタイプのレプリケーションルールの数を確認できます。
S3 ストレージレンズでのレプリケーションメトリクスの使用の詳細については、「[S3 ストレージレンズでのレプリケーションメトリクスの表示](viewing-replication-metrics-storage-lens.md)」を参照してください。
+ **S3 イベント通知** – S3 イベント通知は、オブジェクトが宛先の AWS リージョンにレプリケートされない場合や、オブジェクトが特定のしきい値内にレプリケートされない場合に、インスタンスのオブジェクトレベルで通知できます。S3 イベント通知には、`s3:Replication:OperationFailedReplication`、`s3:Replication:OperationMissedThreshold`、`s3:Replication:OperationReplicatedAfterThreshold`、および `s3:Replication:OperationNotTracked` のレプリケーションイベントタイプが用意されています。
Amazon S3 イベントは、Amazon Simple Queue Service (Amazon SQS)、Amazon Simple Notification Service (Amazon SNS)、または を通じて使用できますAWS Lambda 詳細については、「[Amazon S3 イベント通知によるレプリケーション失敗イベントの受信](replication-metrics-events.md)」を参照してください。
+ **レプリケーションステータス値** – オブジェクトのレプリケーションステータスを取得することもできます。レプリケーションステータスは、レプリケートされているオブジェクトの現在の状態を判断するのに役立ちます。レプリケート元オブジェクトのレプリケーションステータスは、 `PENDING`、`COMPLETED`または`FAILED`のいずれかを返します。レプリカのレプリケーションステータスが`REPLICA`に返されます。
S3 バッチレプリケーションジョブを作成するときにも、レプリケーションステータス値を使用することもできます。例えば、これらのステータス値を使用して、レプリケートされたことがない、またはレプリケーションに失敗したオブジェクトをレプリケートできます。
オブジェクトのレプリケーションステータスの取得の詳細については、「[レプリケーションステータス情報の取得](replication-status.md)」を参照してください。バッチレプリケーションでこれらの値を使用する方法の詳細については、「[バッチレプリケーションジョブのフィルター](s3-batch-replication-batch.md#batch-replication-filters)」を参照してください。
**Topics**
+ [
# S3 レプリケーションメトリクスの使用
](repl-metrics.md)
+ [
# S3 ストレージレンズでのレプリケーションメトリクスの表示
](viewing-replication-metrics-storage-lens.md)
+ [
# Amazon S3 イベント通知によるレプリケーション失敗イベントの受信
](replication-metrics-events.md)
+ [
# レプリケーションステータス情報の取得
](replication-status.md)
# S3 レプリケーションメトリクスの使用
S3 レプリケーションメトリクス は、レプリケーション設定のレプリケーションルールの詳細なメトリクスを提供します。レプリケーションメトリクスを使って、保留中のバイト数、保留中のオペレーション、レプリケーションに失敗したオペレーション、レプリケーションのレイテンシーを追跡すると、レプリケーションの進行状況を 1 分単位でモニタリングできます。
**注記**
S3 レプリケーションメトリクスは、Amazon CloudWatch カスタムメトリクスと同じ料金レートで請求されます。詳細については、「[Amazon CloudWatch の料金](https://aws.amazon.com/cloudwatch/pricing/)」を参照してください。
S3 レプリケーション時間コントロールを使用している場合、Amazon CloudWatch は、各レプリケーションルールで S3 RTC を有効にしてから 15 分後にレプリケーションメトリクスのレポートを開始します。
S3 Replication Time Control (S3 RTC) を有効にすると、S3 レプリケーションメトリクスが自動的にオンになります。[ルールを作成または編集するときに](replication-walkthrough1.md)、S3 RTC とは独立して S3 レプリケーションメトリクスを有効にすることもできます。S3 RTC には、サービスレベルアグリーメント (SLA) やしきい値の欠落に関する通知など、その他の機能が含まれています。詳細については、「[S3 Replication Time Control (S3 RTC)を使用してコンプライアンス要件を満たす](replication-time-control.md)」を参照してください。
S3 レプリケーションメトリクスが有効になっている場合、Amazon S3 は次のメトリクスを Amazon CloudWatch に発行します。CloudWatch メトリクスは、ベストエフォートで配信されます。
| メトリクス名 | メトリクスの説明 | このメトリクスはどのオブジェクトに適用されますか。 | このメトリクスはどのリージョンで発行されていますか。 | レプリケート先バケットが削除された場合でも、このメトリクスは発行されますか。 | レプリケーションが行われない場合、このメトリクスは引き続き発行されますか。 |
| --- | --- | --- | --- | --- | --- |
| **レプリケーション保留中のバイト数** | 特定のレプリケーションルールについて、レプリケーションが保留中のオブジェクトの合計バイト数。 | このメトリクスは、S3 クロスリージョンレプリケーション (S3 CRR) または S3 同一リージョンレプリケーション (S3 SRR) でレプリケートされた新しいオブジェクトにのみ適用されます。 | このメトリクスは、レプリケート先バケットのリージョンで発行されます。 | いいえ | あり |
| **レプリケーションレイテンシー** | 特定のレプリケーションルールについて、レプリケート先バケットがレプリケート元バケットより遅れる最大秒数。 | このメトリクスは、S3 CRR または S3 SRR でレプリケートされた新しいオブジェクトにのみ適用されます。 | このメトリクスは、レプリケート先バケットのリージョンで発行されます。 | いいえ | あり |
| **レプリケーション保留中のオペレーション** | 特定のレプリケーションルールについて、レプリケーションが保留中のオペレーションの数。このメトリクスは、オブジェクト、削除マーカー、タグ、アクセスコントロールリスト (ACL)、S3 オブジェクトロックに関連するオペレーションを追跡します。 | このメトリクスは、S3 CRR または S3 SRR でレプリケートされた新しいオブジェクトにのみ適用されます。 | このメトリクスは、レプリケート先バケットのリージョンで発行されます。 | いいえ | あり |
| **オペレーション失敗レプリケーション** | 特定のレプリケーションルールについて、レプリケーションに失敗したオペレーションの数。このメトリクスは、オブジェクト、削除マーカー、タグ、アクセスコントロールリスト (ACL)、Object Lockに関連するオペレーションを追跡します。 **[レプリケーションに失敗したオペレーション]** は、S3 レプリケーションの失敗を 1 分間隔で集計して追跡します。レプリケーションに失敗した特定のオブジェクトとその失敗理由を特定するには、Amazon S3 イベント通知で `OperationFailedReplication` イベントをサブスクライブしてください。詳細については、「[Amazon S3 イベント通知によるレプリケーション失敗イベントの受信](replication-metrics-events.md)」を参照してください。 | このメトリクスは S3 CRR または S3 SRR でレプリケートされる新しいオブジェクトと、S3 バッチレプリケーションでレプリケートされる既存のオブジェクトの両方に適用されます。 S3 バッチレプリケーションジョブがまったく実行されなかった場合、メトリクスは Amazon CloudWatch に送信されません。例えば、S3 Batch レプリケーションジョブを実行するために必要なアクセス許可がない場合、またはレプリケーション設定のタグまたはプレフィックスが一致しない場合、ジョブは実行されません。 | このメトリクスは、ソースバケットのリージョンで公開されます。 | はい | なし |
CloudWatch でこれらのメトリクスを利用する方法については、「[CloudWatch の S3 レプリケーションメトリクス](metrics-dimensions.md#s3-cloudwatch-replication-metrics)」を参照してください。
## S3 レプリケーションメトリクスの有効化
S3 レプリケーションメトリクスは、新規または既存のレプリケーションルールを使用して開始できます。レプリケーションルールの作成方法の詳細については、「[同じアカウントでのバケットのレプリケーションの設定](replication-walkthrough1.md)」を参照してください。レプリケーションルールを S3 バケット全体に適用するか、特定のプレフィックスやタグを持つ Amazon S3 オブジェクトに適用するかを選択できます。
このトピックでは、ソースバケットとレプリケーション先バケットが同じまたは異なる AWS アカウント で所有されている場合に、レプリケーション設定で S3 レプリケーションメトリクスを有効にする手順について説明します。
AWS Command Line Interface (AWS CLI) を使用してレプリケーションメトリクスを有効にするには、`Metrics` が有効になっているレプリケート元バケットにレプリケーション設定を追加する必要があります。この設定例では、`Tax` というプレフィックスの下にあるオブジェクトがレプリケート先バケットである `amzn-s3-demo-bucket` にレプリケートされて、それらのオブジェクトのメトリクスが生成されます。
```
{
"Rules": [
{
"Status": "Enabled",
"Filter": {
"Prefix": "Tax"
},
"Destination": {
"Bucket": "arn:aws:s3:::amzn-s3-demo-bucket",
"Metrics": {
"Status": "Enabled"
}
},
"Priority": 1
}
],
"Role": "IAM-Role-ARN"
}
```
## レプリケーションメトリクスの表示
S3 レプリケーションメトリクスは、Amazon S3 コンソールのソース汎用バケットの **[メトリクス]** タブで表示できます。これらの Amazon CloudWatch メトリクスは、Amazon CloudWatch コンソールでも使用できます。S3 レプリケーションメトリクスを有効にすると、Amazon CloudWatch は、保留中のバイト数、保留中のオペレーション、レプリケーションレイテンシーをレプリケーションルールレベルで追跡するために使用できるメトリクスを出力します。
Amazon S3 コンソールまたは Amazon S3 REST API を使用して S3 Replication Time Control (S3 RTC) でレプリケーションを有効にすると、S3 レプリケーションメトリクスが自動的にオンになります。[ルールを作成または編集するときに](replication-walkthrough1.md)、S3 RTC とは独立して S3 レプリケーションメトリクスを有効にすることもできます。
S3 レプリケーション時間コントロールを使用している場合、Amazon CloudWatch は、各レプリケーションルールで S3 RTC を有効にしてから 15 分後にレプリケーションメトリクスのレポートを開始します。詳細については、「[S3 レプリケーションメトリクスの使用](#repl-metrics)」を参照してください。
レプリケーションメトリクスは、レプリケーション設定のルール ID を追跡します。レプリケーションルール ID は、プレフィックス、タグ、またはその両方の組み合わせに固有です。
Amazon S3 の CloudWatch メトリクスの詳細については、「[Amazon CloudWatch によるメトリクスのモニタリング](cloudwatch-monitoring.md)」を参照してください。
**前提条件**
S3 レプリケーションメトリクスが有効になっているレプリケーションルールを作成します。詳細については、「[S3 レプリケーションメトリクスの有効化](#enabling-replication-metrics)」を参照してください。
**レプリケート元バケットの **[メトリクス]** タブで S3 レプリケーションメトリクスを表示するには**
1. AWS マネジメントコンソール にサインインし、Amazon S3 コンソール [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) を開きます。
1. 左のナビゲーションペインで、**[汎用バケット]** を選択します。
1. バケットリストで、レプリケーションメトリクスを取得するオブジェクトが含まれているソースバケットの名前を選択します。
1. **[メトリクス]** タブをクリックします。
1. **[レプリケーションメトリクス]** で、メトリクスを表示するレプリケーションルールを選択します。
1. **[グラフを表示]** を選択します。
Amazon S3 には、選択したルールの **[レプリケーションレイテンシー]**、**[レプリケーション保留中のバイト数]**、**[レプリケーションを保留中のオペをレーション]**、および **[レプリケーションに失敗したオペレーション]** のグラフが表示されます。
# S3 ストレージレンズでのレプリケーションメトリクスの表示
[S3 レプリケーションメトリクスに加えて](repl-metrics.md)、S3 ストレージレンズが提供するレプリケーション関連のデータ保護メトリクスを使用できます。S3 ストレージレンズは、オブジェクトストレージの使用状況とアクティビティを組織全体で可視化するために使用できるクラウドストレージの分析機能です。詳細については、「[Using S3 Storage Lens to protect your data](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-data-protection.html#storage-lens-data-protection-replication-rule)」(S3 ストレージレンズを使用してデータを保護する) を参照してください。
S3 ストレージレンズには、無料のメトリクスと、追加料金でアップグレードできるアドバンストメトリクスとレコメンデーションの 2 つの階層のメトリクスがあります。アドバンストメトリクスとレコメンデーションをご利用になれば、ストレージに関するインサイトが得られる追加のメトリクスや機能にアクセスできます。S3 Storage Lens の料金の詳細については、「[Amazon S3 の料金](https://aws.amazon.com/s3/pricing)」を参照してください。
S3 ストレージレンズで無料のメトリクスを使用すると、ソースバケットからレプリケートされた総バイト数や、ソースバケットからレプリケートされたオブジェクトの数などのメトリクスを表示できます。
レプリケーションインスタンス全体を監査するには、S3 ストレージレンズで高度なメトリクスを有効にします。S3 ストレージレンズの高度なメトリクスを使用すると、無効なレプリケーション先を持つレプリケーションルールの数など、さまざまなタイプのレプリケーションルールの数を確認できます。
各階層にあるレプリケーションメトリクスを含む S3 ストレージレンズメトリクスの完全なリストについては、「[S3 ストレージレンズのメトリクスに関する用語集](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_metrics_glossary.html?icmpid=docs_s3_user_guide_replication.html)」を参照してください。
**前提条件**
[ライブレプリケーション設定](replication-how-setup.md)または [S3 バッチレプリケーションジョブ](s3-batch-replication-batch.md)を作成します。
**Amazon S3 ストレージレンズでレプリケーションメトリクスを表示するには**
1. S3 ストレージレンズダッシュボードを作成します。手順については、「[S3 コンソールの使用](storage_lens_creating_dashboard.md#storage_lens_console_creating)」を参照してください。
1. (オプション) ダッシュボードの設定中に、すべての S3 ストレージレンズレプリケーションメトリクスを表示するには、**[高度なメトリクスとレコメンデーション]** を選択し、**[高度なデータ保護メトリクス]** を選択します。メトリクスの完全なリストについては、「[Amazon S3 Storage Lens のメトリクスに関する用語集](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_metrics_glossary.html?icmpid=docs_s3_user_guide_replication.html)」を参照してください。
高度なメトリクスとレコメンデーションを有効にすると、レプリケーション設定に関する詳細なインサイトを得ることができます。例えば、S3 ストレージレンズのレプリケーションルール数メトリクスを使用して、レプリケーション用に設定されているバケットに関する詳細な情報を取得できます。この情報には、バケット内とリージョン内およびバケット間とリージョン間のレプリケーションルールが含まれます。詳細については、「[各バケットのレプリケーションルールの総数を数える](storage-lens-data-protection.md#storage-lens-data-protection-replication-rule)」を参照してください。
1. ダッシュボードを作成したら、ダッシュボードを開き、**[バケット]** タブを選択します。
1. **[Buckets]** (バケット) セクションまで下にスクロールします。**[Metrics categories]** (メトリクスのカテゴリ) で、**[Data protection]** (データ保護) を選択します。次に、**[Summary]** (概要) を選択解除します。
1. **[バケット]** リストをフィルタリングしてレプリケーションメトリクスのみを表示するには、設定アイコン (![\[The preferences icon in the S3 Storage Lens dashboard.\]](http://docs.aws.amazon.com/ja_jp/AmazonS3/latest/userguide/images/preferences.png)) を選択します。
1. レプリケーションメトリクスだけが選択された状態になるまで、他のすべてのデータ保護メトリクスを選択解除します。
1. (オプション) **[Page size]** (ページサイズ) で、リストに表示するバケットの数を選択します。
1. [**続行**] をクリックしてください。
# Amazon S3 イベント通知によるレプリケーション失敗イベントの受信
レプリケーション設定で S3 レプリケーションメトリクスを有効にしている場合は、Amazon S3 イベント通知を設定して、オブジェクトが宛先 AWS リージョンにレプリケートされない場合に通知を受けることができます。レプリケーション設定で S3 Replication Time Control (S3 RTC) を有効にしている場合、レプリケーションの 15 分間の S3 RTC しきい値内にオブジェクトがレプリケートされない場合にも通知を受け取ることができます。
次の `Replication` イベントタイプを使用すると、保留中のバイト数、保留中のオペレーション、およびレプリケーションのレイテンシーを追跡すると、レプリケーションイベントの進行状況を 1 分単位でモニタリングできます。S3 レプリケーションメトリクスの詳細については、「[S3 レプリケーションメトリクスの使用](repl-metrics.md)」を参照してください。
+ −`s3:Replication:OperationFailedReplication`イベントタイプは、レプリケーションのターゲットであったオブジェクトがレプリケートに失敗したときに通知を受け取ります。
+ `s3:Replication:OperationMissedThreshold` イベントタイプは、S3 RTC を使用するレプリケーションの対象であったオブジェクトがレプリケーションの 15 分の閾値を超えたときに通知します。
+ `s3:Replication:OperationReplicatedAfterThreshold` イベントタイプは、S3 RTC を使用するレプリケーションの対象であったオブジェクトが 15 分の閾値を超えてレプリケートされたときに通知します。
+ `s3:Replication:OperationNotTracked` イベントタイプは、ライブレプリケーションの対象であったオブジェクト (同一リージョンレプリケーション [SRR] またはクロスリージョンレプリケーション [CRR]) がレプリケーションメトリクスによって追跡されなくなったときに通知します。
サポートされているすべてのレプリケーションイベントタイプの詳細な説明については、「[SQS、SNS、および Lambda でサポートされているイベントタイプ](notification-how-to-event-types-and-destinations.md#supported-notification-event-types)」を参照してください。
S3 イベント通知によってキャプチャされた失敗コードのリストについては、「[Amazon S3 レプリケーションの失敗の理由](#replication-failure-codes)」を参照してください。
S3 イベント通知は、Amazon Simple Queue Service (Amazon SQS)、Amazon Simple Notification Service (Amazon SNS)、または AWS Lambda を使用して受信できます。詳細については、「[Amazon S3 イベント通知](EventNotifications.md)」を参照してください。
Amazon S3 イベント通知を設定する手順については、[Enabling event notifications](how-to-enable-disable-notification-intro.md) を参照してください。
**注記**
イベント通知を有効にするだけでなく、S3 レプリケーションメトリクスも有効にしてください。詳細については、「[S3 レプリケーションメトリクスの有効化](repl-metrics.md#enabling-replication-metrics)」を参照してください。
次は Amazon S3 が `s3:Replication:OperationFailedReplication` イベントを発行するために送信するメッセージの例です。詳細については、「[イベントメッセージの構造](notification-content-structure.md)」を参照してください。
```
{
"Records": [
{
"eventVersion": "2.2",
"eventSource": "aws:s3",
"awsRegion": "us-east-1",
"eventTime": "2024-09-05T21:04:32.527Z",
"eventName": "Replication:OperationFailedReplication",
"userIdentity": {
"principalId": "s3.amazonaws.com"
},
"requestParameters": {
"sourceIPAddress": "s3.amazonaws.com"
},
"responseElements": {
"x-amz-request-id": "123bf045-2b4b-4ca8-a211-c34a63c59426",
"x-amz-id-2": "12VAWNDIHnwJsRhTccqQTeAPoXQmRt22KkewMV8G3XZihAuf9CLDdmkApgZzudaIe2KlLfDqGS0="
},
"s3": {
"s3SchemaVersion": "1.0",
"configurationId": "ReplicationEventName",
"bucket": {
"name": "amzn-s3-demo-bucket1",
"ownerIdentity": {
"principalId": "111122223333"
},
"arn": "arn:aws:s3:::amzn-s3-demo-bucket1"
},
"object": {
"key": "replication-object-put-test.png",
"size": 520080,
"eTag": "e12345ca7e88a38428305d3ff7fcb99f",
"versionId": "abcdeH0Xp66ep__QDjR76LK7Gc9X4wKO",
"sequencer": "0066DA1CBF104C0D51"
}
},
"replicationEventData": {
"replicationRuleId": "notification-test-replication-rule",
"destinationBucket": "arn:aws:s3:::amzn-s3-demo-bucket2",
"s3Operation": "OBJECT_PUT",
"requestTime": "2024-09-05T21:03:59.168Z",
"failureReason": "AssumeRoleNotPermitted"
}
}
]
}
```
## Amazon S3 レプリケーションの失敗の理由
次の表は、Amazon S3 レプリケーションが失敗した理由を示しています。Amazon S3 イベント通知で `s3:Replication:OperationFailedReplication` イベントを受信し、`failureReason` 値を見ると、これらの理由を確認できます。
失敗の理由は、S3 バッチレプリケーション完了レポートでも確認できます。詳細については、「[バッチレプリケーション完了レポート](s3-batch-replication-batch.md#batch-replication-completion-report)」を参照してください。
| レプリケーションの失敗の理由 | 説明 |
| --- | --- |
| `AssumeRoleNotPermitted` | Amazon S3 は、レプリケーション設定またはバッチオペレーションジョブで指定された AWS Identity and Access Management (IAM) ロールを引き受けることができません。 |
| `DstBucketInvalidRegion` | 宛先バケットがバッチオペレーションジョブで指定されたのと同じ AWS リージョンにありません。このエラーはバッチレプリケーションに固有のものです。 |
| `DstBucketNotFound` | Amazon S3 は、レプリケーション設定で指定されたレプリケート先バケットを見つけることができません。 |
| `DstBucketObjectLockConfigMissing` | オブジェクトロックが有効になっているレプリケート元バケットからオブジェクトをレプリケートするには、レプリケート先バケットでもオブジェクトロックが有効になっている必要があります。このエラーは、レプリケート先バケットでオブジェクトロックが有効になっていない可能性があることを示しています。詳細については、「[オブジェクトロックの考慮事項](object-lock-managing.md)」を参照してください。 |
| `DstBucketUnversioned` | S3 レプリケート先バケットでバージョニングが有効になっていません。S3 レプリケーションでオブジェクトをレプリケートするには、レプリケート先バケットのバージョニングを有効にします。 |
| `DstDelObjNotPermitted` | Amazon S3 は、レプリケート先バケットに削除マーカーをレプリケートできません。レプリケート先バケットに対する `s3:ReplicateDelete` 権限がない可能性があります。 |
| `DstKmsKeyInvalidState` | レプリケート先バケットの AWS Key Management Service (AWS KMS) キーが無効な状態です。必要な AWS KMS キーを確認して有効にします。AWS KMS キーの管理について詳しくは、*AWS Key Management Service デベロッパーガイド*の「[AWS KMS キーのキーステータス](https://docs.aws.amazon.com/kms/latest/developerguide/key-state.html)」を参照してください。 |
| `DstKmsKeyNotFound` | レプリケーション設定でレプリケート先バケットに設定されている AWS KMS キーは存在しません。 |
| `DstMultipartCompleteNotPermitted` | Amazon S3 は、レプリケート先バケットでオブジェクトのマルチパートアップロードを完了できません。レプリケート先バケットに対する `s3:ReplicateObject` 権限がない可能性があります。 |
| `DstMultipartInitNotPermitted` | Amazon S3 は、レプリケート先バケットへのオブジェクトのマルチパートアップロードを開始できません。レプリケート先バケットに対する `s3:ReplicateObject` 権限がない可能性があります。 |
| `DstMultipartUploadNotPermitted` | Amazon S3 は、レプリケート先バケットにマルチパートアップロードオブジェクトをアップロードできません。レプリケート先バケットに対する `s3:ReplicateObject` 権限がない可能性があります。 |
| `DstObjectHardDeleted` | S3 バッチレプリケーションでは、レプリケート先バケットからオブジェクトのバージョン ID で削除されたオブジェクトの再レプリケーションはサポートされません。このエラーはバッチレプリケーションに固有のものです。 |
| `DstPutAclNotPermitted` | Amazon S3 は、レプリケート先バケットにオブジェクトアクセスコントロールリスト (ACL) をレプリケートできません。レプリケート先バケットに対する `s3:ReplicateObject` 権限がない可能性があります。 |
| `DstPutLegalHoldNotPermitted` | イミュータブルなオブジェクトをレプリケートしている際は、Amazon S3 ではレプリケート先オブジェクトに Object Lock のリーガルホールドを設定できません。レプリケート先バケットに対する `s3:PutObjectLegalHold` 権限がない可能性があります。詳細については、「[リーガルホールド](object-lock.md#object-lock-legal-holds)」を参照してください。 |
| `DstPutObjectNotPermitted` | Amazon S3 は、レプリケート先バケットにオブジェクトをレプリケートできません。これは、レプリケート先バケットに必要なアクセス許可 (`s3:ReplicateObject` または `s3:ObjectOwnerOverrideToBucketOwner` アクセス許可) がない場合、または AWS KMS キーポリシーによってソースのレプリケーションロールが宛先バケットで AWS KMS キー (`kms:Decrypt` および `kms:GenerateDataKey*` アクション) を使用することが許可されていない場合に発生する可能性があります。 |
| `DstPutRetentionNotPermitted` | イミュータブルなオブジェクトをレプリケートしている際は、Amazon S3 では送信先オブジェクトに保持期間を設定することができません。レプリケート先バケットに対する `s3:PutObjectRetention` 権限がない可能性があります。 |
| `DstPutTaggingNotPermitted` | Amazon S3 は、レプリケート先バケットにオブジェクトタグをレプリケートできません。レプリケート先バケットに対する `s3:ReplicateObject` 権限がない可能性があります。 |
| `DstVersionNotFound ` | Amazon S3 は、メタデータをレプリケートする必要があるレプリケート先バケットで必要なオブジェクトバージョンを見つけることができません。 |
| `InitiateReplicationNotPermitted` | Amazon S3 は、オブジェクトのレプリケーションを開始できません。バッチオペレーションジョブに対する `s3:InitiateReplication` 権限がない可能性があります。このエラーはバッチレプリケーションに固有のものです。 |
| `SrcBucketInvalidRegion` | レプリケート元バケットがバッチオペレーションジョブで指定されたのと同じ AWS リージョンにありません。このエラーはバッチレプリケーションに固有のものです。 |
| `SrcBucketNotFound` | Amazon S3 はレプリケート元バケットを見つけることができません。 |
| `SrcBucketReplicationConfigMissing` | Amazon S3 はソースバケットのレプリケーション設定を見つけることができませんでした。 |
| `SrcGetAclNotPermitted` | Amazon S3 は、レプリケート元バケットにあるオブジェクトにアクセスしてレプリケートを行うことができません。レプリケート元バケットオブジェクトに対する `s3:GetObjectVersionAcl` 権限がない可能性があります。 ソースバケットのオブジェクトは、バケット所有者が所有している必要があります。ACL が有効になっている場合は、[オブジェクト所有権] が [希望するバケット所有者] または [オブジェクトライター] に設定されているかどうかを確認してください。オブジェクト所有権が [希望するバケット所有者] に設定されている場合、バケット所有者がオブジェクト所有者になるためには、ソースバケットオブジェクトに `bucket-owner-full-control` ACL が必要です。ソースアカウントは、オブジェクト所有権を [バケット所有者の強制] に設定して、ACL を無効にすることで、バケット内のすべてのオブジェクトの所有権を取得できます。 |
| `SrcGetLegalHoldNotPermitted` | Amazon S3 は S3 オブジェクトロックのリーガルホールド情報にアクセスできません。 |
| `SrcGetObjectNotPermitted` | Amazon S3 は、レプリケート元バケットにあるオブジェクトにアクセスしてレプリケートを行うことができません。レプリケート元バケットに対する `s3:GetObjectVersionForReplication` 権限がない可能性があります。 |
| `SrcGetRetentionNotPermitted` | Amazon S3 は S3 オブジェクトロックの保持期間情報にアクセスできません。 |
| `SrcGetTaggingNotPermitted` | Amazon S3 はレプリケート元バケットのオブジェクトタグ情報にアクセスできません。レプリケート元バケットに対する `s3:GetObjectVersionTagging` 権限がない可能性があります。 |
| `SrcHeadObjectNotPermitted` | Amazon S3 はレプリケート元バケットからオブジェクトメタデータを取得できません。レプリケート元バケットに対する `s3:GetObjectVersionForReplication` 権限がない可能性があります。 |
| `SrcKeyNotFound` | Amazon S3 は、レプリケートするソースオブジェクトキーを見つけることができません。ソースオブジェクトはレプリケーションが完了する前に削除された可能性があります。 |
| `SrcKmsKeyInvalidState` | レプリケート元バケットの AWS KMS キーは有効な状態ではありません。必要な AWS KMS キーを確認して有効にします。AWS KMS キーの管理について詳しくは、*AWS Key Management Service デベロッパーガイド*の「[AWS KMS キーのキーステータス](https://docs.aws.amazon.com/kms/latest/developerguide/key-state.html)」を参照してください。 |
| `SrcObjectNotEligible` | 一部のオブジェクトはレプリケーションの対象外です。これは、オブジェクトのストレージクラスが原因であるか、オブジェクトタグがレプリケーション構成と一致しないことが原因である可能性があります。 |
| `SrcObjectNotFound` | ソースオブジェクトが存在しません。 |
| `SrcReplicationNotPending` | Amazon S3 はすでにこのオブジェクトをレプリケートしています。このオブジェクトはもう保留中レプリケーションではなくなっています。 |
| `SrcVersionNotFound` | Amazon S3 は、レプリケートするソースオブジェクトバージョンを見つけることができません。ソースオブジェクトバージョンはレプリケーションが完了する前に削除された可能性があります。 |
### 関連トピック
[ライブレプリケーションのアクセス許可の設定](setting-repl-config-perm-overview.md)
[レプリケーションのトラブルシューティング](replication-troubleshoot.md)
# レプリケーションステータス情報の取得
レプリケーションステータスは、レプリケートされるオブジェクトの現在の状態を判断するのに役立ちます。レプリケート元オブジェクトのレプリケーションステータスは、 `PENDING`、`COMPLETED`または`FAILED`のいずれかを返します。レプリカのレプリケーションステータスが`REPLICA`に返されます。
S3 バッチレプリケーションジョブを作成するときにも、レプリケーションステータス値を使用することもできます。例えば、これらのステータス値を使用して、レプリケートされたことがない、またはレプリケーションに失敗したオブジェクトをレプリケートできます。バッチレプリケーションでこれらの値を使用する方法の詳細については、「[バッチレプリケーションジョブでのレプリケーションステータス情報の使用](#replication-status-batch-replication)」を参照してください。
**Topics**
+ [
## レプリケーションステータスの概要
](#replication-status-overview)
+ [
## 複数のレプリケート先バケットにレプリケートする場合のレプリケーションステータス
](#replication-status-multiple-destinations)
+ [
## Amazon S3 レプリカ変更の同期が有効になっている場合のレプリケーションステータス
](#replication-status-replica-mod-syn)
+ [
## バッチレプリケーションジョブでのレプリケーションステータス情報の使用
](#replication-status-batch-replication)
+ [
## レプリケーションステータスの検索
](#replication-status-usage)
## レプリケーションステータスの概要
レプリケーションには、レプリケーションを設定するレプリケート元バケットと、Amazon S3 がオブジェクトをレプリケートする 1 つ以上のレプリケート先バケットがあります。これらのバケットからオブジェクト (`GetObject` を使用) またはオブジェクトメタデータ (`HeadObject` を使用) をリクエストすると、Amazon S3 はレスポンスとして `x-amz-replication-status` ヘッダーを返します。
+ レプリケート元バケットのオブジェクトをリクエストする場合、リクエストしたオブジェクトがレプリケーション対象であると、Amazon S3 は `x-amz-replication-status` ヘッダーを返します。
たとえば、レプリケーション設定でオブジェクトプレフィックス `TaxDocs` を指定して、キー名のプレフィックス `TaxDocs` が付いたオブジェクトのみをレプリケートするように Amazon S3 に指示しているとします。このキー名のプレフィックスを持つ、アップロードしたすべてのオブジェクト (`TaxDocs/document1.pdf` など) がレプリケートされます。このキー名のプレフィックスが付いたオブジェクトのリクエストでは、Amazon S3 が、オブジェクトのレプリケーション状態が `x-amz-replication-status`、`PENDING`、または `COMPLETED` の値のいずれかの `FAILED` ヘッダーを返します。
**注記**
オブジェクトをアップロードした後で、オブジェクトのレプリケーションに失敗した場合、レプリケーションを再試行できません。オブジェクトを再度アップロードするか、S3 バッチレプリケーションを使用して失敗したオブジェクトをレプリケートする必要があります。バッチレプリケーションの使用の詳細については、「[バッチレプリケーションを使用した既存のオブジェクトのレプリケーション](s3-batch-replication-batch.md)」を参照してください。
レプリケーションロールの許可、AWS Key Management Service (AWS KMS) 許可、またはバケットの許可がないなどの問題がある場合、オブジェクトは `FAILED` ステータスに移行します。バケットやリージョンが使用できないなどの一時的な障害が発生した場合、レプリケーションのステータスは `FAILED` にはならず、`PENDING` のままになります。リソースがオンラインに戻ると、Amazon S3 はこれらのオブジェクトのレプリケーションを再開します。
+ レプリケート先バケットからオブジェクトをリクエストした場合、リクエストされたオブジェクトが Amazon S3 によって作成されたレプリカであるときに、Amazon S3 は値が`x-amz-replication-status`である`REPLICA`ヘッダーを返します。
**注記**
レプリケーションが有効になっているレプリケート元バケットからオブジェクトを削除する前に、削除する前にオブジェクトのレプリケーションステータスをチェックして、そのオブジェクトがレプリケートされていることを確認します。
レプリケート元バケットで S3 ライフサイクル設定が有効である場合、Amazon S3 は、オブジェクトのステータスが `COMPLETED` または `FAILED` になるまでライフサイクルアクションを停止します。
## 複数のレプリケート先バケットにレプリケートする場合のレプリケーションステータス
オブジェクトを複数のレプリケート先バケットにレプリケートした場合、`x-amz-replication-status`ヘッダーの動作はそれぞれ異なります。レプリケート元オブジェクトのヘッダーは、すべてのレプリケート先へのレプリケーションが成功した場合のみ、`COMPLETED` の値を返します。すべてのレプリケート先に対してレプリケーションが完了するまで、ヘッダーは`PENDING`の値のままになります。1 つ以上のレプリケート先がレプリケーションに失敗すると、ヘッダーは`FAILED`を返します。
## Amazon S3 レプリカ変更の同期が有効になっている場合のレプリケーションステータス
レプリケーションルールが Amazon S3 レプリカの変更を有効にすると、レプリカは `REPLICA` 以外のステータスをレポートできます。メタデータの変更がレプリケート中の場合は、`x-amz-replication-status` ヘッダーは `PENDING` を返します。レプリカ変更の同期がメタデータのレプリケートに失敗した場合、ヘッダーは `FAILED` を返します。メタデータが正しくレプリケートされると、レプリカはヘッダー `REPLICA` を返します。
## バッチレプリケーションジョブでのレプリケーションステータス情報の使用
バッチレプリケーションジョブを作成するときに、オプションで、オブジェクトの作成日やレプリケーションステータスなどの追加のフィルターを指定して、ジョブのスコープを縮小できます。
オブジェクトのレプリケーションは、`ObjectReplicationStatuses` 値を基に、以下の値を 1 つ以上指定することでフィルターできます。
+ `"NONE"` - Simple Storage Service (Amazon S3) がこれまでオブジェクトのレプリケートを試みたことがないことを示します。
+ `"FAILED"` - Amazon S3 が以前にオブジェクトのレプリケートを試みたがオブジェクトのレプリケーションに失敗したことを示します。
+ `"COMPLETED"` - Simple Storage Service (Amazon S3) が以前にオブジェクトを正常にレプリケートしたことを示します。
+ `"REPLICA"` - Amazon S3 が別のソースからレプリケートしたレプリカオブジェクトであることを示します。
バッチレプリケーションでこれらのレプリケーションステータス値を使用する方法の詳細については、「[バッチレプリケーションジョブのフィルター](s3-batch-replication-batch.md#batch-replication-filters)」を参照してください。
## レプリケーションステータスの検索
バケット内のオブジェクトのレプリケーションステータスを取得するには、Amazon S3 インベントリツールを使用できます。Amazon S3 は、インベントリ設定で指定したレプリケート先バケットに CSV ファイルを送信します。Amazon Athena を使用して、インベントリレポートのレプリケーションステータスをクエリすることもできます。Amazon S3 インベントリのさらなる詳細については、[S3 インベントリを使用したデータのカタログ化と分析](storage-inventory.md) を参照してください。
オブジェクトのレプリケーションステータスは、Amazon S3 コンソール、AWS Command Line Interface (AWS CLI)、または AWS SDK で確認できます。
### S3 コンソールの使用
S3 コンソールでは、オブジェクトの詳細ページで、オブジェクトのレプリケーションステータスを確認できます。
1. AWS マネジメントコンソール にサインインし、Amazon S3 コンソール [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) を開きます。
1. 左側のナビゲーションペインで、**[バケット]** を選択します。
1. **[汎用バケット]** リストで、レプリケーションソースバケットの名前を選択します。
1. [**オブジェクト**] リストで、オブジェクト名を選択します。オブジェクトの詳細ページが表示されます。
1. **[プロパティ]** タブで、**[オブジェクト管理の概要]** セクションまでスクロールします。**[管理設定]** で、**[レプリケーションステータス]** の [値] を確認します。
### の使用AWS CLI
次の例に示すように、AWS Command Line Interface (AWS CLI) `head-object` コマンドを使用して、オブジェクトのメタデータを取得します。`amzn-s3-demo-source-bucket1` をレプリケーションソースバケットの名前に置き換え、その他の `user input placeholders` を独自の情報に置き換えます。
```
aws s3api head-object --bucket amzn-s3-demo-source-bucket1 --key object-key --version-id object-version-id
```
このコマンドは、以下のレスポンス例に示すように、`ReplicationStatus` を含むオブジェクトメタデータを返します。
```
{
"AcceptRanges":"bytes",
"ContentType":"image/jpeg",
"LastModified":"Mon, 23 Mar 2015 21:02:29 GMT",
"ContentLength":3191,
"ReplicationStatus":"COMPLETED",
"VersionId":"jfnW.HIMOfYiD_9rGbSkmroXsFj3fqZ.",
"ETag":"\"6805f2cfc46c0f04559748bb039d69ae\"",
"Metadata":{
}
}
```
### AWS SDK の使用
次のコードフラグメントは、それぞれ AWS SDK for Java および AWS SDK for .NET を使用してレプリケーションステータスを取得します。
------
#### [ Java ]
```
GetObjectMetadataRequest metadataRequest = new GetObjectMetadataRequest(bucketName, key);
ObjectMetadata metadata = s3Client.getObjectMetadata(metadataRequest);
System.out.println("Replication Status : " + metadata.getRawMetadataValue(Headers.OBJECT_REPLICATION_STATUS));
```
------
#### [ .NET ]
```
GetObjectMetadataRequest getmetadataRequest = new GetObjectMetadataRequest
{
BucketName = sourceBucket,
Key = objectKey
};
GetObjectMetadataResponse getmetadataResponse = client.GetObjectMetadata(getmetadataRequest);
Console.WriteLine("Object replication status: {0}", getmetadataResponse.ReplicationStatus);
```
------