# バッチレプリケーションを使用した既存のオブジェクトのレプリケーション
S3 バッチレプリケーションは、Amazon S3 バケット間で新しいオブジェクトを継続的かつ自動的にレプリケートするライブレプリケーションとは異なります。代わりに、S3 バッチレプリケーションは既存のオブジェクトでオンデマンドで実行されます。S3 バッチレプリケーションを使用して、次のタイプのオブジェクトをレプリケートできます。
+ レプリケーション設定が実行される前に存在していたオブジェクト
+ 以前にレプリケートされたオブジェクト
+ レプリケーションに失敗したオブジェクト
バッチオペレーションジョブを使用して、これらのオブジェクトをオンデマンドでレプリケートできます。
バッチレプリケーションを開始するには、次の操作を行います。
+ **新しいレプリケーションルールまたはレプリケート先のバッチレプリケーションを開始する** — 1 回限りのバッチレプリケーションジョブは、新しいレプリケーション設定で最初のルールを作成する場合や、Amazon S3 を介して既存の設定に新しいレプリケート先バケットを追加する場合に作成できます。
+ **既存のレプリケーション設定のバッチレプリケーションを開始する** — S3 バッチオペレーションを使用して、Amazon S3 コンソール、AWS Command Line Interface (AWS CLI)、AWS SDK、または Amazon S3 REST API を介し、新しいバッチレプリケーションジョブを作成できます。
バッチレプリケーションジョブが終了すると、完了レポートが表示されます。このレポートを使用してジョブを検査する方法の詳細については、「[ジョブステータスと完了レポートの追跡](batch-ops-job-status.md)」を参照してください。
## S3 バッチレプリケーションに関する考慮事項
S3 バッチレプリケーションを使用する前に、次の考慮事項のリストを確認してください。
+ レプリケート元バケットには既存のレプリケーション設定が必要です。レプリケーションを有効にするには、「[ライブレプリケーションの設定の概要](replication-how-setup.md)」と「[ライブレプリケーションの設定例](replication-example-walkthroughs.md)」を参照してください。
+ バケットで S3 ライフサイクルが設定されている場合は、バッチレプリケーションジョブがアクティブな際には、ライフサイクルルールを無効にすることをお勧めします。これは、レプリケート元バケットとレプリケート先バケットの間で等価性を確保するのに役立ちます。これを行わない場合、これらのバケットが分岐し、レプリケート先バケットがレプリケート元バケットの完全なレプリカではなくなる可能性があります。たとえば、次のシナリオを考えてみます。
+ レプリケート元バケットには、オブジェクトとそのオブジェクトの削除マーカーの複数のバージョンがあります。
+ レプリケート元とレプリケート先のバケットには、期限切れの削除マーカーを削除するライフサイクル設定が設定されています。
このシナリオでは、バッチレプリケーションにより、オブジェクトのバージョンがレプリケートされる前に、レプリケート先バケットに削除マーカーがレプリケートされることがあります。その場合、オブジェクトのバージョンがレプリケートされる前に、ライフサイクル設定で削除マーカーの有効期限が切れ、削除マーカーがレプリケート先バケットから削除される可能性があります。
+ バッチオペレーションジョブを実行するために指定する AWS Identity and Access Management IAM ロールには、基になるバッチレプリケーションを実行する権限が必要です。IAM ロールの作成の詳細については、「[S3 バッチレプリケーション用の IAM ロールの設定](s3-batch-replication-policies.md)」を参照してください。
+ バッチレプリケーションには、Amazon S3 で生成できるマニフェストが必要です。生成されたマニフェストは、レプリケーション元バケットと同じ AWS リージョンに保存されている必要があります。マニフェストを生成しない場合は、レプリケートするオブジェクトを含む Amazon S3 インベントリレポートまたは CSV ファイルを指定できます。詳細については、「[バッチレプリケーションジョブのマニフェストの指定](#batch-replication-manifest)」を参照してください。
+ バッチレプリケーションでは、レプリケート先バケットからオブジェクトのバージョン ID を指定することで削除されたオブジェクトの再レプリケーションはサポートされません。これらのオブジェクトを再レプリケートするには、バッチコピージョブを使用してソースオブジェクトを所定の場所でコピーします。これらのオブジェクトを所定の場所でコピーすると、レプリケート元バケットにオブジェクトの新しいバージョンが作成され、レプリケート先バケットへのレプリケーションが自動的に開始されます。レプリケート先バケットを削除して再作成しても、レプリケーションは開始されません。
バッチコピーの詳細については、「[バッチ操作を使用してオブジェクトをコピーする例](batch-ops-examples-copy.md)」を参照してください。
+ レプリケート元バケットでレプリケーションルールを使用している場合は、[レプリケーション設定を更新して](https://docs.aws.amazon.com/AmazonS3/latest/userguide/replication-walkthrough-2.html)、レプリケーションルールにアタッチされている IAM ロールに、オブジェクトをレプリケートするための適切な権限を付与してください。この IAM ロールには、ソースバケットとレプリケート先バケットの両方でレプリケーションを実行する権限が必要です。
+ 短期間に同じバケットに対して複数のバッチレプリケーションジョブを送信すると、Amazon S3 はそれらのジョブを同時に実行します。
+ 2 つの異なるバケットに対して複数の Batch レプリケーションジョブを送信する場合、Amazon S3 がすべてのジョブを同時に実行するわけではないことに注意してください。アカウントで一度に実行できるバッチレプリケーションジョブの数を超えると、Amazon S3 は優先度の低いジョブを一時停止して優先度の高いジョブを処理します。優先度の高いジョブが完了すると、一時停止していたジョブは再びアクティブになります。
+ バッチオペレーションは、S3 Glacier Flexible Retrieval ストレージクラスと S3 Glacier Deep Archive ストレージクラスに保存されたオブジェクトに対してはサポートされていません。
+ アーカイブアクセスまたはディープアーカイブアクセスのストレージ階層に保存されている S3 Intelligent-Tiering オブジェクトのバッチレプリケーションを行うには、まず[復元](https://docs.aws.amazon.com/AmazonS3/latest/userguide/intelligent-tiering-managing.html#restore-data-from-int-tier-archive)リクエストを開始し、オブジェクトが高頻度アクセス階層に移動されるまで待つ必要があります。
+ 1 つのバッチレプリケーションジョブで、最大 200 億個のオブジェクトを持つマニフェストをサポートできます。
+ S3 バッチレプリケーションを使用してデータセットをリージョン間でレプリケートし、オブジェクトのサーバー側の暗号化タイプを SSE-S3 から SSE-KMS に更新したことがある場合は、追加のアクセス許可が必要になる場合があります。ソースリージョンバケットでは、`kms:decrypt` アクセス許可が必要です。次に、レプリケート先リージョンのバケットの `kms:decrypt` および `kms:encrypt` アクセス許可が必要です。詳細については、「[暗号化オブジェクトのレプリケート](replication-config-for-kms-objects.md)」を参照してください。
## バッチレプリケーションジョブのマニフェストの指定
マニフェストは、Amazon S3 が動作するオブジェクトキーを含む Amazon S3 オブジェクトです。バッチレプリケーションジョブを作成する場合は、ユーザー生成のマニフェストを指定するか、レプリケーション設定に基づいて Amazon S3 でマニフェストを生成させる必要があります。
ユーザーが作成したマニフェストを提供する場合は、Amazon S3 インベントリレポートまたは CSV ファイルの形式である必要があります。マニフェスト内のオブジェクトがバージョニング対応のバケット内にある場合は、そのオブジェクトのバージョン ID を指定する必要があります。マニフェストで指定されたバージョン ID を持つオブジェクトのみがレプリケートされます。マニフェストの指定の詳細については、「[マニフェストの指定](batch-ops-create-job.md#specify-batchjob-manifest)」を参照してください。
Amazon S3 がユーザーに代わってマニフェストファイルを生成するように選択した場合、リストされるオブジェクトでは、レプリケート元バケットのレプリケーション設定と同じレプリケート元バケット、プレフィックス、タグを使用します。生成されたマニフェストでは、Amazon S3 はオブジェクトの適格なバージョンをすべてレプリケートします。
**注記**
Amazon S3 によるマニフェストの生成を選択する場合は、マニフェストがレプリケーション元バケットと同じ AWS リージョンに保存されている必要があります。
## バッチレプリケーションジョブのフィルター
バッチレプリケーションジョブを作成するときに、オプションで、オブジェクトの作成日やレプリケーションステータスなどの追加のフィルターを指定して、ジョブのスコープを縮小できます。
オブジェクトのレプリケーションは、`ObjectReplicationStatuses` 値を基に、以下の値を 1 つ以上指定することでフィルターできます。
+ `"NONE"` - Simple Storage Service (Amazon S3) がこれまでオブジェクトのレプリケートを試みたことがないことを示します。
+ `"FAILED"` - Amazon S3 が以前にオブジェクトのレプリケートを試みたがオブジェクトのレプリケーションに失敗したことを示します。
+ `"COMPLETED"` - Simple Storage Service (Amazon S3) が以前にオブジェクトを正常にレプリケートしたことを示します。
+ `"REPLICA"` - このオブジェクトが Amazon S3 が別のレプリケート元バケットからレプリケートしたレプリカであることを示します。
レプリケーションステータスの詳細については、「[レプリケーションステータス情報の取得](replication-status.md)」を参照してください。
バッチレプリケーションジョブをフィルターしない場合、バッチオペレーションは、デフォルトでレプリケートされない特定のオブジェクトを除き、レプリケーション設定のルールに一致するマニフェスト内のすべてのオブジェクト (`ObjectReplicationStatus` に関係なく) のレプリケーションを試みます。詳細については、[レプリケーション設定でレプリケートされないものは何ですか?](replication-what-is-isnot-replicated.md#replication-what-is-not-replicated)を参照してください。
目標によっては、以下の 1 つまたは複数の値に `ObjectReplicationStatuses` を設定する場合があります。
+ レプリケートされたことがない既存のオブジェクトのみをレプリケートするには、`"NONE"` のみを含めます。
+ 以前にレプリケートに失敗したオブジェクトのレプリケートのみを再試行するには、`"FAILED"` のみを含めます。
+ 既存のオブジェクトをレプリケートし、以前にレプリケートに失敗したオブジェクトのレプリケーションを再試行するには、`"NONE"` と `"FAILED"` の両方を含めます。
+ 別のレプリケート先にレプリケートされたオブジェクトをレプリケート先バケットにバックフィルするには、`"COMPLETED"` を含めます。
+ 以前にレプリケートオブジェクトをレプリケートするには、`"REPLICA"` を含めます。
## バッチレプリケーション完了レポート
バッチレプリケーションジョブを作成するときに、CSV 完了レポートをリクエストできます。このレポートには、オブジェクト、レプリケーションの成功コードまたは失敗コード、出力、および説明が表示されます。ジョブの追跡と完了レポートの追跡については、「[完了レポート](batch-ops-job-status.md#batch-ops-completion-report)」を参照してください。
レプリケーション失敗コードのリストと説明については、「[Amazon S3 レプリケーションの失敗の理由](replication-metrics-events.md#replication-failure-codes)」を参照してください。
バッチレプリケーションのトラブルシューティングについては、「[バッチレプリケーションエラー](replication-troubleshoot.md#troubleshoot-batch-replication-errors)」を参照してください。
## バッチレプリケーションの使用開始
バッチレプリケーションの使用方法の詳細については、「[チュートリアル: S3 バッチレプリケーションによる Amazon S3 バケット内の既存のオブジェクトのレプリケーション](https://aws.amazon.com/getting-started/hands-on/replicate-existing-objects-with-amazon-s3-batch-replication/)」を参照してください。
# S3 バッチレプリケーション用の IAM ロールの設定
Amazon S3 バッチレプリケーションはバッチオペレーションジョブの一種であるため、AWS Identity and Access Management (IAM) ロールを作成し、ユーザーに代わってアクションを実行するためのバッチオペレーション許可を付与する必要があります。また、バッチレプリケーション IAM ポリシーをバッチオペレーション IAM ロールにアタッチする必要があります。
次の手順を使用して、バッチレプリケーションジョブを開始するバッチオペレーションの許可を与えるポリシーと IAM ロールを作成します。
**バッチレプリケーションのポリシーを作成するには**
1. AWS マネジメントコンソール にサインインして、IAM コンソール [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) を開きます。
1. **[アクセス管理]** で、**[ポリシー]** を選択します。
1. [**Create policy**] (ポリシーの作成) を選択します。
1. **[アクセス許可の指定]** ページで、**[JSON]** を選択します。
1. マニフェストが Amazon S3 によって生成されるか、独自のマニフェストを提供するかに応じて、次のいずれかのポリシーを挿入します。マニフェストの詳細については、「[バッチレプリケーションジョブのマニフェストの指定](s3-batch-replication-batch.md#batch-replication-manifest)」を参照してください。
これらのポリシーを使用する前に、次のポリシーの `user input placeholders` をレプリケーション元バケット、マニフェストバケット、および完了レポートバケットの名前に置き換えます。
**注記**
バッチレプリケーションの IAM ロールには、マニフェストを生成するか提供するかに応じて異なるアクセス許可が必要です。そのため、次の例から適切なポリシーを選択してください。
**AmazonS3 で生成されたマニフェストを使用して保存する場合のポリシー**
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"s3:InitiateReplication"
],
"Effect": "Allow",
"Resource": [
"arn:aws:s3:::amzn-s3-demo-source-bucket/*"
]
},
{
"Action": [
"s3:GetReplicationConfiguration",
"s3:PutInventoryConfiguration"
],
"Effect": "Allow",
"Resource": [
"arn:aws:s3:::amzn-s3-demo-source-bucket"
]
},
{
"Action": [
"s3:GetObject",
"s3:GetObjectVersion"
],
"Effect": "Allow",
"Resource": [
"arn:aws:s3:::amzn-s3-demo-manifest-bucket/*"
]
},
{
"Effect": "Allow",
"Action": [
"s3:PutObject"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-completion-report-bucket/*",
"arn:aws:s3:::amzn-s3-demo-manifest-bucket/*"
]
}
]
}
```
------
**ユーザー指定のマニフェストを使用する場合のポリシー**
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"s3:InitiateReplication"
],
"Effect": "Allow",
"Resource": [
"arn:aws:s3:::amzn-s3-demo-source-bucket/*"
]
},
{
"Action": [
"s3:GetObject",
"s3:GetObjectVersion"
],
"Effect": "Allow",
"Resource": [
"arn:aws:s3:::amzn-s3-demo-manifest-bucket/*"
]
},
{
"Effect": "Allow",
"Action": [
"s3:PutObject"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-completion-report-bucket/*"
]
}
]
}
```
------
1. [**次へ**] を選択します。
1. ポリシーの名前を指定し、**[ポリシーの作成]** を選択します。
**バッチレプリケーションの IAM ロールを作成するには**
1. AWS マネジメントコンソール にサインインして、IAM コンソール [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) を開きます。
1. **[Access management]** (アクセス管理) で、**[Roles]** (ロール) を選択します。
1. [**ロールの作成**] を選択してください。
1. 信頼されたエンティティの種類に、**[AWS のサービス]** を選択します。**[ユースケース]** セクションで、サービスとして **[S3]**、ユースケースとして **[S3 バッチオペレーション]** を選択します。
1. [**次へ**] を選択します。**[アクセス許可を追加]** ページが表示されます。検索ボックスで、前述の手順で作成したポリシーを検索します。ポリシー名の横にあるチェックボックスにチェックを入れてから、**[次へ]** を選択します。
1. **[名前、確認および作成]** ページで、IAM ロールに名前を指定します。
1. **[ステップ 1: 信頼 ID]** セクションで、IAM ロールが次の信頼ポリシーを使用していることを確認します。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Principal":{
"Service":"batchoperations.s3.amazonaws.com"
},
"Action":"sts:AssumeRole"
}
]
}
```
------
1. **[ステップ 2: アクセス許可を追加する]** セクションで、IAM ロールが前に作成したポリシーを使用していることを確認します。
1. [**ロールの作成**] を選択してください。
# 新しいレプリケーションルールまたは新しいレプリケート先にバッチレプリケーションジョブを作成する
Amazon S3 では、ライブレプリケーションは、レプリケーション設定を作成する前にレプリケート元バケットに既に存在していたオブジェクトをレプリケートしません。ライブレプリケーションは、レプリケーション設定の作成後にバケットに書き込まれた新しいオブジェクトと更新されたオブジェクトのみを自動的にレプリケートします。既存のオブジェクトをレプリケートするには、S3 バッチレプリケーションを使用して、これらのオブジェクトをオンデマンドでレプリケートできます。
新しいライブレプリケーション設定で最初のルールを作成する場合、または Amazon S3 コンソールを介して新しいレプリケート先バケットを既存のレプリケーション設定に追加する場合は、オプションでバッチレプリケーションジョブを作成できます。このバッチレプリケーションジョブを使用して、レプリケート元バケット内の既存のオブジェクトをレプリケート先バケットにレプリケートできます。
既存の設定に対して、新しいレプリケート先バケットを追加せずにバッチレプリケーションを使用するには、「[既存のレプリケーションルールのバッチレプリケーションジョブを作成する](s3-batch-replication-existing-config.md)」を参照してください。
**前提条件**
バッチオペレーションジョブを作成する前に、バッチオペレーション AWS Identity and Access Management (IAM) ロールを作成し、ユーザーに代わってアクションを実行するための Amazon S3 許可を付与する必要があります。詳細については、「[S3 バッチレプリケーション用の IAM ロールの設定](s3-batch-replication-policies.md)」を参照してください。
## Amazon S3 コンソールを介して新しいレプリケーションルールまたはレプリケート先にバッチレプリケーションを使用する
新しいレプリケーション設定で最初のルールを作成する場合、または Amazon S3 コンソールを介して新しいレプリケート先バケットを既存の設定に追加する場合は、バッチレプリケーションジョブを作成してレプリケート元バケットで既存のオブジェクトをレプリケートできます。
**レプリケーション設定を作成または更新するときにバッチレプリケーションジョブを作成するには**
1. AWS マネジメントコンソール にサインインし、Amazon S3 コンソール [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) を開きます。
1. 左側のナビゲーションペインで、**[バケット]** を選択します。
1. **[汎用バケット]** リストで、レプリケートするオブジェクトが含まれるバケットの名前を選択します。
1. 新しいレプリケーションルールを作成するか、既存のルールを編集するには、**[管理]** を選択し、下へスクロールして **[レプリケーションルール]** を選択します。
+ 新しいレプリケーションルールを作成するには、[**レプリケーションルールの作成**] を選択します。ベーシックレプリケーションルールのセットアップ方法の例については、「[ライブレプリケーションの設定例](replication-example-walkthroughs.md)」を参照してください。
+ 既存のバックアップルールを編集するには、ルール名の隣にあるオプションボタンを選択してから、**[編集]** を選択します。
1. 新しいレプリケーションルールを作成するか、既存のレプリケーションルールのレプリケーション先を編集して、[**保存**] を選択します。
新しいレプリケーション設定で最初のルールを作成した後、または既存の設定を編集して新しいレプリケート先を追加すると、[**Replicate existing objects?**] (既存のオブジェクトをレプリケーションしますか?) ダイアログが表示され、バッチレプリケーションジョブを作成するオプションが表示されます。
1. このジョブを今すぐ作成して実行する場合は、**[はい、既存のオブジェクトをレプリケートする]** を選択します。
バッチレプリケーションジョブを後で作成するには、**[いいえ、既存のオブジェクトをレプリケートしない** を選択します。
1. **[はい、既存のオブジェクトをレプリケートする]** を選択すると、**[バッチオペレーションの作成ジョブ]** ページが表示されます。S3 バッチレプリケーションジョブには、次の設定があります。
**ジョブ実行オプション**
S3 バッチレプリケーションジョブをすぐに実行する場合は、**[準備ができたジョブを自動的に実行]** を選択します。後でジョブを実行する場合は、**[ジョブの準備ができるまで実行を待機]** 選択します。
**[準備ができたジョブを自動的に実行]** を選択すると、バッチオペレーションマニフェストを作成および保存することはできません。バッチオペレーションマニフェストを保存するには、**[ジョブの準備ができるまで実行を待機]** を選択します。
**バッチオペレーションマニフェスト**
**[ジョブの準備ができるまで実行を待機]** を選択した場合、**[バッチオペレーションマニフェスト]** セクションが表示されます。マニフェストとは、指定されたアクションを実行するすべてのオブジェクトのリストです。マニフェストを保存することもできます。S3 インベントリファイルと同様に、マニフェストは CSV ファイルとして保存され、バケットに保存されます。バッチオペレーションマニフェストの詳細については、「[マニフェストの指定](batch-ops-create-job.md#specify-batchjob-manifest)」を参照してください。
**完了レポート**
S3 バッチオペレーションは、マニフェストで指定された各オブジェクトに対して 1 つのタスクを実行します。完了レポートは、追加の設定を必要としない統合形式でタスクの結果を表示する簡単な方法です。すべてのタスクまたは失敗したタスクについてのみ完了レポートをリクエストできます。完了レポートの詳細については、「[完了レポート](batch-ops-job-status.md#batch-ops-completion-report)」を参照してください。
**アクセス許可**
レプリケーション失敗の最も一般的な原因の 1 つは、提供されている AWS Identity and Access Management (IAM) ロールの権限が不十分であることです。このロールの作成の詳細については、「[S3 バッチレプリケーション用の IAM ロールの設定](s3-batch-replication-policies.md)」を参照してください。バッチレプリケーションに必要なアクセス許可を持つ IAM ロールを作成または選択します。
1. **[保存]** を選択します。
# 既存のレプリケーションルールのバッチレプリケーションジョブを作成する
Amazon S3 では、ライブレプリケーションは、レプリケーション設定を作成する前にレプリケート元バケットに既に存在していたオブジェクトをレプリケートしません。ライブレプリケーションは、レプリケーション設定の作成後にバケットに書き込まれた新しいオブジェクトと更新されたオブジェクトのみを自動的にレプリケートします。既存のオブジェクトをレプリケートするには、S3 バッチレプリケーションを使用して、これらのオブジェクトをオンデマンドでレプリケートできます。
AWS SDK、AWS Command Line Interface (AWS CLI)、Simple Storage Service (Amazon S3) コンソールを使用して、既存のレプリケーション設定に S3 バッチレプリケーションを設定できます。バッチレプリケーションの概要については、「[バッチレプリケーションを使用した既存のオブジェクトのレプリケーション](s3-batch-replication-batch.md)」を参照してください。
バッチレプリケーションジョブが終了すると、完了レポートが表示されます。レポートを使用してジョブを検査する方法の詳細については、「[ジョブステータスと完了レポートの追跡](batch-ops-job-status.md)」を参照してください。
**前提条件**
バッチオペレーションジョブを作成する前に、バッチオペレーション AWS Identity and Access Management (IAM) ロールを作成し、ユーザーに代わってアクションを実行するための Amazon S3 許可を付与する必要があります。詳細については、「[S3 バッチレプリケーション用の IAM ロールの設定](s3-batch-replication-policies.md)」を参照してください。
## S3 コンソールの使用
1. AWS マネジメントコンソール にサインインし、Amazon S3 コンソール ([https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)) を開きます。
1. 左のナビゲーションペインで、[**バッチ操作**] を選択します。
1. **[ジョブの作成]** を選択します。
1. **[AWS リージョン]** セクションに、ジョブを作成するリージョンが表示されていることを確認します。
1. **[マニフェスト]** セクションで、使用するマニフェスト形式を指定します。マニフェストとは、指定されたアクションを実行するすべてのオブジェクトのリストです。バッチオペレーションマニフェストの詳細については、「[マニフェストの指定](batch-ops-create-job.md#specify-batchjob-manifest)」を参照してください。
+ マニフェストの準備ができている場合は、**S3 インベントリレポート manifest.json**または**CSV**。マニフェストがバージョニングされたバケットにある場合は、マニフェストのバージョン ID を指定できます。バージョン ID を指定しない場合、バッチオペレーションはマニフェストの最新バージョンを使用します。マニフェストの作成の詳細については、「[マニフェストの指定](batch-ops-create-job.md#specify-batchjob-manifest)」を参照してください。
**注記**
マニフェスト内のオブジェクトがバージョニング対応のバケット内にある場合は、そのオブジェクトのバージョン ID を指定する必要があります。詳細については、「[マニフェストの指定](batch-ops-create-job.md#specify-batchjob-manifest)」を参照してください。
+ レプリケーション構成に基づいてマニフェストを作成するには、**[Create manifest using S3 Replication configuration]** (S3 レプリケーション設定を使用してマニフェストを作成する) を選択します。レプリケーション設定のレプリケート元バケットを選択します。
1. (オプション) **[S3 レプリケーション設定を使用してマニフェストを作成する]** を選択した場合は、オブジェクト作成日やレプリケーションステータスなどの追加のフィルターを含めることができます。レプリケーションステータスによるフィルター方法の例については、「[バッチレプリケーションジョブのマニフェストの指定](s3-batch-replication-batch.md#batch-replication-manifest)」を参照してください。
1. (オプション) **[S3 レプリケーション設定を使用してマニフェストを作成する]** を選択した場合は、生成されたマニフェストを保存できます。マニフェストを保存するには、**[バッチオペレーションマニフェストを保存]** を選択します。次に、マニフェストのレプリケート先バケットを指定し、マニフェストを暗号化するかどうかを選択します。
**注記**
生成されたマニフェストは、レプリケーション元バケットと同じ AWS リージョンに保存されている必要があります。
1. [**次へ**] を選択します。
1. **[オペレーション]** ページで、**[レプリケート]** を選択し、**[次へ]** を選択します。
1. (オプション) **[Description]** (説明) に入力します。
1. 必要に応じて、ジョブの **[Priority]** (優先度) を調整します。番号が高いほど、優先順位が高いことを表します。Simple Storage Service (Amazon S3) は、優先度の低いジョブの前に優先度の高いジョブを実行しようとします。ジョブの優先度の詳細については、「[ジョブの優先度の割り当て](batch-ops-job-priority.md)」を参照してください。
1. (オプション) 完了レポートを生成します。このレポートを生成するには **[完了レポートを生成]** を選択します。
完了レポートを生成する場合は、**[Failed tasks only]** (失敗したタスクのみ) または **[All tasks]** (すべてのタスク) をレポートするかを選択肢、レポートのレプリケート先バケットを指定する必要があります。
1. **[アクセス許可]** セクションで、バッチレプリケーションに必要なアクセス許可を持つ IAM ロールが選択されていることを確認してください。レプリケーション失敗の最も一般的な原因の 1 つは、提供されている (IAM) ロールのアクセス許可が不十分であることです。このロールの作成の詳細については、「[S3 バッチレプリケーション用の IAM ロールの設定](s3-batch-replication-policies.md)」を参照してください。
1. (オプション) バッチレプリケーションジョブにジョブタグを追加します。
1. [**次へ**] を選択します。
1. ジョブの設定を確認し、**[ジョブの作成]** を選択します。
## S3 マニフェストとともに、AWS CLI を使用する
次の `create-job` コマンド例では、S3 が AWS アカウント `111122223333` に生成したマニフェストを使用して S3 バッチレプリケーションジョブを作成します。この例では、既存のオブジェクトと以前にレプリケートに失敗したオブジェクトをレプリケートします。レプリケーションステータスによるフィルタリングの詳細については、「[バッチレプリケーションジョブのマニフェストの指定](s3-batch-replication-batch.md#batch-replication-manifest)」を参照してください。
このコマンドを使用するには、*`user input placeholders`* をユーザー自身の情報に置き換えます。IAM ロール `role/batch-Replication-IAM-policy` を、以前に作成した IAM ロールに置き換えます。詳細については、「[S3 バッチレプリケーション用の IAM ロールの設定](s3-batch-replication-policies.md)」を参照してください。
```
aws s3control create-job --account-id 111122223333 \
--operation '{"S3ReplicateObject":{}}' \
--report '{"Bucket":"arn:aws:s3:::amzn-s3-demo-completion-report-bucket",\
"Prefix":"batch-replication-report", \
"Format":"Report_CSV_20180820","Enabled":true,"ReportScope":"AllTasks"}' \
--manifest-generator '{"S3JobManifestGenerator": {"ExpectedBucketOwner": "111122223333", \
"SourceBucket": "arn:aws:s3:::amzn-s3-demo-source-bucket", \
"EnableManifestOutput": false, "Filter": {"EligibleForReplication": true, \
"ObjectReplicationStatuses": ["NONE","FAILED"]}}}' \
--priority 1 \
--role-arn arn:aws:iam::111122223333:role/batch-Replication-IAM-policy \
--no-confirmation-required \
--region source-bucket-region
```
**注記**
ジョブは、レプリケーション元バケットと同じ AWS リージョンから開始する必要があります。
バッチレプリケーションジョブを正常に開始すると、応答としてジョブ ID を受け取ります。次の `describe-job` コマンドを使用して、このジョブをモニタリングできます。このコマンドを使用するには、*`user input placeholders`* をユーザー自身の情報に置き換えます。
```
aws s3control describe-job --account-id 111122223333 --job-id job-id --region source-bucket-region
```
## ユーザー提供のマニフェストとともに AWS CLI を使用する
次の例では、AWS アカウント `111122223333` のユーザー定義のマニフェストを使用して S3 バッチレプリケーションジョブを作成します。マニフェスト内のオブジェクトがバージョニング対応のバケット内にある場合は、そのオブジェクトのバージョン ID を指定する必要があります。マニフェストで指定されたバージョン ID を持つオブジェクトのみがレプリケートされます。マニフェストの作成の詳細については、「[マニフェストの指定](batch-ops-create-job.md#specify-batchjob-manifest)」を参照してください。
このコマンドを使用するには、*`user input placeholders`* をユーザー自身の情報に置き換えます。IAM ロール `role/batch-Replication-IAM-policy` を、以前に作成した IAM ロールに置き換えます。詳細については、「[S3 バッチレプリケーション用の IAM ロールの設定](s3-batch-replication-policies.md)」を参照してください。
```
aws s3control create-job --account-id 111122223333 \
--operation '{"S3ReplicateObject":{}}' \
--report '{"Bucket":"arn:aws:s3:::amzn-s3-demo-completion-report-bucket",\
"Prefix":"batch-replication-report", \
"Format":"Report_CSV_20180820","Enabled":true,"ReportScope":"AllTasks"}' \
--manifest '{"Spec":{"Format":"S3BatchOperations_CSV_20180820",\
"Fields":["Bucket","Key","VersionId"]},\
"Location":{"ObjectArn":"arn:aws:s3:::amzn-s3-demo-manifest-bucket/manifest.csv",\
"ETag":"Manifest Etag"}}' \
--priority 1 \
--role-arn arn:aws:iam::111122223333:role/batch-Replication-IAM-policy \
--no-confirmation-required \
--region source-bucket-region
```
**注記**
ジョブは、レプリケーション元バケットと同じ AWS リージョンから開始する必要があります。
バッチレプリケーションジョブを正常に開始すると、応答としてジョブ ID を受け取ります。次の `describe-job` コマンドを使用して、このジョブをモニタリングできます。
```
aws s3control describe-job --account-id 111122223333 --job-id job-id --region source-bucket-region
```