翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ジョブの状態
<a name="job_states"></a>

ジョブキューに AWS Batch ジョブを送信すると、ジョブは `SUBMITTED`状態になります。その後、以下の状態を経由して完了 (コード `0` で終了) または失敗 (0 以外のコードで終了) します。 AWS Batch ジョブの各状態は以下のとおりです。

`SUBMITTED`  
キューに送信され、まだスケジューラによって評価されていないジョブです。スケジューラは、ジョブを評価し、他のジョブの正常な完了に依存するかどうか (未処理の依存関係があるかどうか) を判断します。依存関係がある場合、ジョブの状態は `PENDING` に移行します。依存関係がない場合、ジョブの状態は `RUNNABLE` に移行します。

`PENDING`  
ジョブはキュー内にあり、別のジョブやリソースへの依存関係があるため、まだ実行できません。依存関係が満たされると、ジョブの状態は `RUNNABLE` に移行します。  
配列ジョブの親は、子ジョブが に更新`PENDING`されると に更新`RUNNABLE`され、子ジョブの実行中に `PENDING`ステータスのままになります。これらのジョブを表示するには、すべての子ジョブが終了状態になるまで`PENDING`ステータスでフィルタリングします。

`RUNNABLE`  
ジョブはキュー内にあり、未処理の依存関係はありません。したがって、ホストにスケジューリングされる準備ができています。この状態のジョブは、ジョブのキューにマッピングされたコンピューティング環境のいずれかで十分なリソースが使用可能になり次第、開始されます。ただし、十分なリソースが使用不可の場合、この状態が無限に続くことがあります。  
ジョブが `STARTING` に進行しない場合は、トラブルーシューティングセクションの[`RUNNABLE` 状態でジョブが止まる](job_stuck_in_runnable.md)を参照してください。

`STARTING`  
これらのジョブはホストにスケジュールされており、関連するコンテナ初期化操作が進行中です。コンテナイメージがプルされてコンテナが稼働状態になると、ジョブの状態は `RUNNING` に移行します。  
イメージのプル期間、Amazon EKS initContainer の完了期間、Amazon ECS containerDependency 解決期間は STARTING 状態で発生します。ジョブのイメージをプルするのにかかる時間は、ジョブが STARTING 状態にある時間と同じです。  
例えば、ジョブのイメージをプルするのに 3 分かかる場合、ジョブは 3 分間 STARTING 状態になります。initContainers の完了に合計 10 分かかる場合、Amazon EKS ジョブは 10 分間 STARTING 状態になります。Amazon ECS ジョブに複数の Amazon ECS containerDependencies がある場合、すべてのコンテナ依存関係 (それらのランタイム) が解決されるまで、ジョブは STARTING 状態になります。STARTING はタイムアウトに含まれないため、期間は RUNNING から始まります。詳細については、「[ジョブの状態](https://docs.aws.amazon.com/batch/latest/userguide/job_states.html)」を参照してください。

`RUNNING`  
ジョブは、コンピューティング環境内の Amazon ECS コンテナインスタンスでコンテナジョブとして実行中です。ジョブのコンテナが終了すると、プロセス終了コードでジョブの正否が判定されます。終了コードの `0` は成功を示し、ゼロ以外の終了コードは失敗を示します。試行が失敗したジョブの再試行戦略に設定されている再試行回数が残っている場合は、ジョブの状態が `RUNNABLE` に移行します。詳細については、[ジョブの再試行の自動化](job_retries.md)を参照してください。  
`RUNNING` ジョブのログは クラウドウォッチのログ(CloudWatch Logs) で確認できます。ロググループは `/aws/batch/job`、ログストリーム名形式は `first200CharsOfJobDefinitionName/default/ecs_task_id` です。この形式は将来変わる可能性があります。  
ジョブが `RUNNING` ステータスになったら、[DescribeJobs](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html) API オペレーションを使用してそのログストリーム名をプログラムで取得できます。詳しくは、*Amazon CloudWatch Logs ユーザーガイド*の[CloudWatch Logs に送信されたログデータを表示する](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#ViewingLogData)を参照してください。デフォルトでは、これらのログには有効期限はありません。ただし、保存期間を変更することは可能です。詳細については、*Amazon CloudWatch Logs ユーザーガイド*の [CloudWatch Logs でのログデータ保管期間の変更](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/SettingLogRetention.html) を参照してください。

`SUCCEEDED`  
ジョブは、終了コード `0` で正常に完了しました。ジョブの`SUCCEEDED`ジョブ状態は、少なくとも 7 日間 AWS Batch に保持されます。  
`SUCCEEDED` ジョブのログは クラウドウォッチのログ(CloudWatch Logs) で確認できます。ロググループは `/aws/batch/job`、ログストリーム名形式は`first200CharsOfJobDefinitionName/default/ecs_task_id`です。この形式は将来に変更される可能性があります。  
ジョブが `RUNNING` ステータスになったら、[DescribeJobs](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html) API オペレーションを使用してそのログストリーム名をプログラムで取得できます。詳しくは、*Amazon CloudWatch Logs ユーザーガイド*の[CloudWatch Logs に送信されたログデータを表示する](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#ViewingLogData)を参照してください。デフォルトでは、これらのログの有効期限はありません。ただし、保存期間を変更することは可能です。詳細については、*Amazon CloudWatch Logs ユーザーガイド*の [CloudWatch Logs でのログデータ保管期間の変更](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/SettingLogRetention.html) を参照してください。

`FAILED`  
ジョブのすべての使用可能な試行が失敗しました。`FAILED` のジョブの状態は、少なくとも7日間 AWS Batch に保存されます。  
`FAILED` ジョブのログは クラウドウォッチのログ(CloudWatch Logs) で確認できます。ロググループは `/aws/batch/job`、ログストリーム名形式は`first200CharsOfJobDefinitionName/default/ecs_task_id`です。この形式は将来に変更される可能性があります。  
ジョブが `RUNNING` ステータスになったら、[DescribeJobs](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html) API オペレーションを使用してそのログストリームをプログラムで取得できます。詳しくは、*Amazon CloudWatch Logs ユーザーガイド*の[CloudWatch Logs に送信されたログデータを表示する](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#ViewingLogData)を参照してください。デフォルトでは、これらのログには有効期限はありません。ただし、保存期間を変更することは可能です。詳細については、*Amazon CloudWatch Logs ユーザーガイド*の [CloudWatch Logs でのログデータ保管期間の変更](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/SettingLogRetention.html) を参照してください。