# S3 バッチ操作ジョブの管理
Amazon S3 は、作成した S3 バッチ操作ジョブを管理するための一連の堅牢なツールを用意しています。このセクションでは、Amazon S3 コンソール、AWS Command Line Interface (AWS CLI)、AWS SDK、または Amazon S3 REST API を使用してジョブを管理および追跡するために使用できるオペレーションについて説明します。
**Topics**
+ [S3 バッチオペレーションジョブの管理に Simple Storage Service (Amazon S3) コンソールを使用する](#batch-ops-manage-console)
+ [ジョブのリスト取得](batch-ops-list-jobs.md)
+ [ジョブの詳細の表示](batch-ops-job-details.md)
+ [ジョブの優先度の割り当て](batch-ops-job-priority.md)
## S3 バッチオペレーションジョブの管理に Simple Storage Service (Amazon S3) コンソールを使用する
コンソールを使用して、S3 バッチオペレーションジョブを管理できます。例えば、以下のことが可能です:
+ アクティブなジョブとキュージョブを表示する
+ ジョブのステータスを確認する
+ ジョブの優先順位を変更する
+ ジョブを確認して実行する
+ ジョブのクローンを作成する
+ ジョブのキャンセル
**S3 コンソールを使用して S3 バッチオペレーションジョブを管理するには**
1. AWS マネジメントコンソール にサインインし、Amazon S3 コンソール [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) を開きます。
1. 左のナビゲーションペインで、[**バッチ操作**] を選択します。
1. 管理するジョブを選択します。
# ジョブのリスト取得
S3 バッチ操作ジョブのリストを取得できます。このリストには、まだ終了していないジョブと 90 日以内に終了したジョブに関する情報が表示されます。各ジョブのリストには、ジョブ ID、説明、優先度、現在のステータス、および成功したタスクと失敗したタスクの数などの詳細が含まれます。
ジョブのリストをステータスでフィルタリングできます。コンソールを使用してリストを取得するときに、説明または ID でジョブを検索して AWS リージョン別にフィルタリングすることもできます。
## `Active` および `Complete` ジョブのリストを取得する
以下の AWS CLI の例では、`Active` および `Complete` ジョブのリストを取得します。この例を実行するには、*`user input placeholders`* をユーザー自身の情報に置き換えます。
```
aws s3control list-jobs \
--region us-west-2 \
--account-id account-id \
--job-statuses '["Active","Complete"]' \
--max-results 20
```
詳細と例については、「AWS CLI コマンドリファレンス」で「[https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/list-jobs.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/list-jobs.html)」を参照してください。**
# ジョブの詳細の表示
ジョブを一覧表示することで取得できるよりも多くの Amazon S3 バッチオペレーションジョブの情報が必要な場合、単一のジョブのすべての詳細を表示できます。まだ終了していないジョブや、過去 90 日以内に終了したジョブの詳細を確認できます。ジョブリストで返される情報に加えて、単一のジョブの詳細には次のような情報が含まれています。
+ オペレーションパラメータ。
+ マニフェストに関する詳細。
+ 完了レポートに関する情報 (ジョブの作成時にレポートを設定した場合)。
+ ジョブの実行に割り当てた AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。
個々のジョブの詳細を表示することで、そのジョブの設定全体にアクセスできます。ジョブの詳細を表示するには、Amazon S3 コンソールまたは AWS Command Line Interface (AWS CLI) を使用します。
## Amazon S3 コンソールで S3 バッチオペレーションジョブの説明を取得する
**コンソールを使用してバッチオペレーションジョブの説明を表示するには**
1. AWS マネジメントコンソール にサインインし、Amazon S3 コンソール [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) を開きます。
1. 左のナビゲーションペインで、[**バッチ操作**] を選択します。
1. 詳細を表示する特定のジョブの ID を選択します。
## AWS CLI で S3 バッチオペレーションジョブの説明を取得する
次の例では、AWS CLI を使用して S3 バッチオペレーションジョブの説明を取得します。次のコマンド例を使用するには、*`user input placeholders`* をユーザー自身の情報に置き換えます。
```
aws s3control describe-job \
--region us-west-2 \
--account-id account-id \
--job-id 00e123a4-c0d8-41f4-a0eb-b46f9ba5b07c
```
詳細と例については、「AWS CLI コマンドリファレンス」で「[https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/describe-job.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/describe-job.html)」を参照してください。**
# ジョブの優先度の割り当て
各 Amazon S3 バッチオペレーションジョブには、数値の優先度 (任意の正の整数) を割り当てることができます。S3 バッチオペレーションは、割り当てられた優先度に従ってジョブの優先順位を決定します。優先度が高いジョブ (または、優先パラメータの数値が高いジョブ) ほど先に処理されます。優先度は降順に決定されます。例えば、優先度の値が 10 のジョブキューは、優先度の値が 1 のジョブキューより先にスケジュールされます。
ジョブの実行中にジョブの優先順位を変更できます。また、ジョブの実行中に優先順位が高い新しいジョブを送信すると、優先順位の低いジョブが一時停止して優先順位の高いジョブが実行される可能性があります。
ジョブの優先順位を変更しても、ジョブの処理速度には影響しません。
**注記**
S3 バッチオペレーションはベストエフォートベースでジョブの優先度を重視します。優先順位の高いジョブは優先順位の低いジョブより優先されるのが一般的ですが、Amazon S3 はジョブの厳密な順序付けを保証しません。
## S3 コンソールの使用
**Amazon S3 コンソールでジョブの優先度を更新する方法**
1. AWS マネジメントコンソール にサインインし、Amazon S3 コンソール [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) を開きます。
1. 左のナビゲーションペインで、[**バッチ操作**] を選択します。
1. 管理する特定のジョブを選択します。
1. **[Actions]** (アクション) を選択します。ドロップダウンリストから **[Update priority]** (更新優先度) を選択します。
## の使用AWS CLI
以下の例では、AWS CLI を使用してジョブの優先度を更新します。数値が大きいほど、実行優先度が高くなります。次のコマンド例を使用するには、*`user input placeholders`* をユーザー自身の情報に置き換えます。
```
aws s3control update-job-priority \
--region us-west-2 \
--account-id account-id \
--priority 98 \
--job-id 00e123a4-c0d8-41f4-a0eb-b46f9ba5b07c
```
## の使用AWS SDK for Java
AWS SDK for Java を使用して S3 バッチオペレーションジョブの優先度を更新するには、S3Control クライアントを使用してジョブの実行優先度を変更します。これにより、キュー内の他のジョブと比較してジョブが処理される順序が決まります。
ジョブの優先度の詳細については、「[ジョブの優先度の割り当て](#batch-ops-job-priority)」を参照してください。
AWS SDK for Java を使用してジョブの優先度を更新する方法の例については、「*Amazon S3 API リファレンス*」の「[Update the priority of a batch job](https://docs.aws.amazon.com/AmazonS3/latest/API/s3-control_example_s3-control_UpdateJobPriority_section.html)」を参照してください。