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

# AWS Batch (`awsbatch`)
<a name="awsbatchcli"></a>

詳細については AWS Batch、「」を参照してください[AWS Batch](https://aws.amazon.com/batch/)。ドキュメントについては、[「AWS Batch IAM ユーザーガイド」](https://docs.aws.amazon.com/batch/latest/userguide/)を参照してください。

**AWS ParallelCluster の CLI コマンド AWS Batch**

スケ`awsbatch`ジューラを使用すると、 の AWS ParallelCluster CLI コマンド AWS Batch が AWS ParallelCluster ヘッドノードに自動的にインストールされます。CLI は AWS Batch API オペレーションを使用し、次のオペレーションを許可します。
+ ジョブの送信と管理
+ ジョブ、キュー、ホストのモニタリング
+ 従来のスケジューラコマンドのミラーリング

**重要**  
AWS ParallelCluster は の GPU ジョブをサポートしていません AWS Batch。詳細については、「[GPU jobs](https://docs.aws.amazon.com/batch/latest/userguide/gpu-jobs.html)」を参照してください。

**Topics**
+ [

# `awsbsub`
](awsbatchcli.awsbsub.md)
+ [

# `awsbstat`
](awsbatchcli.awsbstat.md)
+ [

# `awsbout`
](awsbatchcli_awsbout.md)
+ [

# `awsbkill`
](awsbatchcli_awsbkill.md)
+ [

# `awsbqueues`
](awsbatchcli_awsbqueues.md)
+ [

# `awsbhosts`
](awsbatchcli_awsbhosts.md)

# `awsbsub`
<a name="awsbatchcli.awsbsub"></a>

ジョブをクラスターのジョブキューに送信します。

```
awsbsub [-h] [-jn JOB_NAME] [-c CLUSTER] [-cf] [-w WORKING_DIR]
        [-pw PARENT_WORKING_DIR] [-if INPUT_FILE] [-p VCPUS] [-m MEMORY]
        [-e ENV] [-eb ENV_DENYLIST] [-r RETRY_ATTEMPTS] [-t TIMEOUT]
        [-n NODES] [-a ARRAY_SIZE] [-d DEPENDS_ON]
        [command] [arguments [arguments ...]]
```

**重要**  
AWS ParallelCluster は の GPU ジョブをサポートしていません AWS Batch。詳細については、「[GPU jobs](https://docs.aws.amazon.com/batch/latest/userguide/gpu-jobs.html)」を参照してください。

## 位置引数
<a name="awsbatchcli.awsbsub.args"></a>

***command***  
ジョブを送信するか (指定したコマンドがコンピューティングインスタンスで使用可能である必要があります)、転送するファイル名を指定します。`--command-file` も参照してください。

**arguments**  
(オプション) コマンドまたはコマンドファイルの引数を指定します。

## 名前付き引数
<a name="awsbatchcli.awsbsub.namedargs"></a>

**-jn *JOB\$1NAME*, --job-name *JOB\$1NAME***  
ジョブの名前を指定します。最初の文字はアルファベットまたは数字でなければなりません。ジョブ名には、アルファベット (大文字、小文字)、数字、ハイフン、アンダースコアを含めることができ、最大 128 文字まで使用可能です。

**-c *CLUSTER*, --cluster *CLUSTER***  
使用するクラスターを指定します。

**-cf, --command-file**  
コマンドがコンピューティングインスタンスに転送されるファイルであることを示します。  
デフォルト: False

**-w *WORKING\$1DIR*, --working-dir *WORKING\$1DIR***  
ジョブの作業ディレクトリとして使用するフォルダを指定します。作業ディレクトリが指定されない場合、ジョブは、ユーザーのホームディレクトリの `job-<AWS_BATCH_JOB_ID>` サブフォルダで実行されます。このパラメータ、または `--parent-working-dir` パラメータを使用できます。

**-pw *PARENT\$1WORKING\$1DIR*, --parent-working-dir *PARENT\$1WORKING\$1DIR***  
ジョブの作業ディレクトリの親フォルダを指定します。親の作業ディレクトリが指定されない場合、デフォルトはユーザーのホームディレクトリに設定されます。`job-<AWS_BATCH_JOB_ID>` という名前のサブフォルダが親の作業ディレクトリに作成されます。このパラメータ、または `--working-dir` パラメータを使用できます。

**-if *INPUT\$1FILE*, --input-file *INPUT\$1FILE***  
コンピューティングインスタンスに転送するファイル (ジョブの作業ディレクトリ内) を指定します。複数の入力ファイルのパラメータを指定できます。

**-p *VCPUS*, --vcpus *VCPUS***  
コンテナ用に予約する vCPU の数を指定します。`–nodes` を指定すると、ノードごとの vCPU の数が識別されます。  
デフォルト: 1

**-m *MEMORY*, --memory *MEMORY***  
ジョブに送信するメモリのハード制限 (MiB 単位) を指定します。ここで指定したメモリ制限を超えようとすると、ジョブは強制終了されます。  
デフォルト: 128

**-e *ENV*, --env *ENV***  
ジョブ環境にエクスポートする環境変数名のカンマ区切りリストを指定します。すべての環境変数をエクスポートするには、「all」を指定します。「all」の環境変数のリストには、`–env-blacklist` パラメータに一覧表示されている変数や、プレフィックスが `PCLUSTER_*` または `AWS_*` の変数は含まれません。

**-eb *ENV\$1DENYLIST*, --env-blacklist *ENV\$1DENYLIST***  
ジョブ環境にエクスポート**しない**環境変数名のカンマ区切りリストを指定します。`HOME`、`PWD`、`USER`、`PATH`、`LD_LIBRARY_PATH`、`TERM`、および `TERMCAP` はデフォルトでエクスポートされません。

**-r *RETRY\$1ATTEMPTS*, --retry-attempts *RETRY\$1ATTEMPTS***  
ジョブを `RUNNABLE` ステータスに移行する回数を指定します。1〜10 回の試行を指定できます。試行回数の設定値が 1 より大きい場合にジョブが失敗すると、`RUNNABLE` ステータスに変わるまで、指定された回数分、再試行します。  
デフォルト: 1

**-t *TIMEOUT*, --timeout *TIMEOUT***  
ジョブが終了していない場合に がジョブ AWS Batch を終了するまでの時間 (ジョブ試行の`startedAt`タイムスタンプから測定) を秒単位で指定します。タイムアウト値は 60 秒以上に指定する必要があります。

**-n *NODES*, --nodes *NODES***  
ジョブ用に予約するノード数を指定します。マルチノード並列送信が有効になるように、このパラメータに値を指定します。  
[`cluster_type`](cluster-definition.md#cluster-type) パラメータが `spot` に設定されている場合、マルチノード並列ジョブはサポートされません。

**-a *ARRAY\$1SIZE*, --array-size *ARRAY\$1SIZE***  
配列のサイズを示します。2 から 10,000 までの値を指定できます。ジョブの配列プロパティを指定した場合は、配列ジョブになります。

**-d *DEPENDS\$1ON*, --depends-on *DEPENDS\$1ON***  
ジョブの依存関係のセミコロン区切りリストを指定します。ジョブは最大 20 個のジョブに依存します。配列ジョブのジョブ ID を指定せずに、`SEQUENTIAL` タイプの依存関係を指定できます。シーケンシャルな依存関係では、各子配列ジョブがインデックス 0 から開始して順番に完了します。また、配列ジョブのジョブ ID を使用して N\$1TO\$1N タイプの依存関係を指定することもできます。N\$1TO\$1N の依存関係では、このジョブの各インデックスの子は各依存関係の対応するインデックスの子が完了するまで待機してから開始されます。このパラメータの構文は、「jobId=*<string>*,type=*<string>*;...」です。

# `awsbstat`
<a name="awsbatchcli.awsbstat"></a>

クラスターのジョブキューに送信されたジョブを表示します。

```
awsbstat [-h] [-c CLUSTER] [-s STATUS] [-e] [-d] [job_ids [job_ids ...]]
```

## 位置引数
<a name="awsbatchcli.awsbstat.arguments"></a>

***job\$1ids***  
出力に表示するジョブ ID のスペース区切りリストを指定します。ジョブがジョブ配列の場合は、すべての子ジョブが表示されます。単一のジョブがリクエストされた場合は、詳細バージョンで表示されます。

## 名前付き引数
<a name="awsbatchcli.awsbstat.namedarguments"></a>

**-c *CLUSTER*, --cluster *CLUSTER***  
使用するクラスターを示します。

**-s *STATUS*, --status *STATUS***  
含めるジョブステータスのカンマ区切りリストを指定します。デフォルトのジョブのステータスは「active」です。有効な値は、`SUBMITTED`、`PENDING`、`RUNNABLE`、`STARTING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`ALL` です。  
デフォルト値は、`SUBMITTED`、`PENDING`、`RUNNABLE`、`STARTING`、`RUNNING` です。

**-e, --expand-children**  
子を含むジョブを拡張します (配列とマルチノードの並列ジョブのいずれも)。  
デフォルト: False

**-d, --details**  
ジョブの詳細を表示します。  
デフォルト: False

# `awsbout`
<a name="awsbatchcli_awsbout"></a>

指定されたジョブの出力を表示します。

```
awsbout [ - h ] [ - c CLUSTER ] [ - hd HEAD ] [ - t TAIL ] [ - s ] [ - sp STREAM_PERIOD ] job_id
```

## 位置引数
<a name="awsbatchcli.awsbout.arguments"></a>

***job\$1id***  
ジョブ ID を指定します。

## 名前付き引数
<a name="awsbatchcli.awsbout.namedarguments"></a>

**-c *CLUSTER*, --cluster *CLUSTER***  
使用するクラスターを示します。

**-hd *HEAD*, --head *HEAD***  
ジョブ出力の最初の *HEAD* 行を取得します。

**-t *TAIL*, --tail *TAIL***  
ジョブ出力の最後の <tail> 行を取得します。

**-s, --stream**  
ジョブ出力を取得してから、追加の出力が生成されるのを待ちます。ジョブ出力の最新の <tail> 行から開始するには、この引数に –tail を指定します。  
デフォルト: False

**-sp *STREAM\$1PERIOD*, --stream-period *STREAM\$1PERIOD***  
ストリーミング期間を設定します。  
デフォルト: 5

# `awsbkill`
<a name="awsbatchcli_awsbkill"></a>

クラスターに送信されたジョブをキャンセルし、終了します。

```
awsbkill [ - h ] [ - c CLUSTER ] [ - r REASON ] job_ids [ job_ids ... ]
```

## 位置引数
<a name="awsbatchcli.awsbkill.arguments"></a>

***job\$1ids***  
キャンセルまたは終了するジョブ ID のスペース区切りリストを指定します。

## 名前付き引数
<a name="awsbatchcli.awsbkill.namedarguments"></a>

**-c *CLUSTER*, --cluster *CLUSTER***  
使用するクラスターの名前を示します。

**-r *REASON*, --reason *REASON***  
キャンセル理由と合わせて、ジョブにアタッチするメッセージを示します。  
デフォルト:「Terminated by the user」

# `awsbqueues`
<a name="awsbatchcli_awsbqueues"></a>

クラスターに関連付けられているジョブキューを表示します。

```
awsbqueues [ - h ] [ - c CLUSTER ] [ - d ] [ job_queues [ job_queues ... ]]
```

## 位置引数
<a name="awsbatchcli.awsbqueues.arguments"></a>

***job\$1queues***  
表示するキュー名のスペース区切りリストを指定します。単一のキューがリクエストされた場合は、詳細バージョンで表示されます。

## 名前付き引数
<a name="awsbatchcli.awsbqueues.namedarguments"></a>

**-c *CLUSTER*, --cluster *CLUSTER***  
使用するクラスターの名前を指定します。

**-d, --details**  
キューの詳細を表示するかどうかを示します。  
デフォルト: False

# `awsbhosts`
<a name="awsbatchcli_awsbhosts"></a>

クラスターのコンピューティング環境に属するホストを表示します。

```
awsbhosts [ - h ] [ - c CLUSTER ] [ - d ] [ instance_ids [ instance_ids ... ]]
```

## 位置引数
<a name="awsbatchcli.awsbhosts.arguments"></a>

***instance\$1ids***  
インスタンス ID のスペース区切りリストを指定します。単一のインスタンスがリクエストされた場合は、詳細バージョンで表示されます。

## 名前付き引数
<a name="awsbatchcli.awsbhosts.namedarguments"></a>

**-c *CLUSTER*, --cluster *CLUSTER***  
使用するクラスターの名前を指定します。

**-d, --details**  
ホストの詳細を表示するかどうかを示します。  
デフォルト: False