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

# `awsbsub`
<a name="awsbatchcli.awsbsub-v3"></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-v3.args"></a>

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

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

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

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

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

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

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

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

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

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

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

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

**-n {{NODES}}, --nodes {{NODES}}**  
ジョブ用に予約するノード数を指定します。マルチノード並列送信が有効になるように、このパラメータに値を指定します。  
[`Scheduler`](Scheduling-v3.md#yaml-Scheduling-Scheduler)/[`AwsBatchQueues`](Scheduling-v3.md#Scheduling-v3-AwsBatchQueues)/[`CapacityType`](Scheduling-v3.md#yaml-Scheduling-AwsBatchQueues-CapacityType) パラメータが `SPOT` に設定されている場合、マルチノード並列ジョブはサポート*されません*。さらに、アカウントには `AWSServiceRoleForEC2Spot` のサービスにリンクされたロールが必要です。このロールは、次の AWS CLI コマンドを使用して作成できます。  

```
$ aws iam create-service-linked-role --aws-service-name spot.amazonaws.com
```
詳細については、「*Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド*」の「[スポットインスタンスリクエスト向けのサービスにリンクされたロール](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-requests.html#service-linked-roles-spot-instance-requests)」を参照してください。

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

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