本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# `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 任務](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`，它會識別每個節點vCPUs 數量。  
預設：1

**-m *MEMORY*, --memory *MEMORY***  
指定要提供給任務的記憶體的硬性限制 (以 MiB 為單位)。如果您的任務嘗試超過此處指定的記憶體限制，則任務會結束。  
預設：128

**-e *ENV*, --env *ENV***  
指定以逗號分隔的清單，其中列出要匯出至任務環境的環境變數名稱。若要匯出所有環境變數，請指定「所有」。請注意，「全部」環境變數清單不包含 `–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***  
指定持續時間，以秒為單位 （從任務嘗試的`startedAt`時間戳記測量），在此時間之後，如果任務尚未完成，則會 AWS Batch 終止任務。逾時值必須至少為 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 個任務。您可以指定`SEQUENTIAL`類型相依性，而無需指定陣列任務的任務 ID。序列相依性允許每個子陣列任務循序完成，從索引 0 開始。您也可以指定 N\$1TO\$1N 類型相依性，以及陣列任務的任務 ID。N\$1TO\$1N 相依性表示，此任務的每個索引子系必須等待各相依性對應的索引子系完成後，才能開始。此參數的語法為 "jobId=*<string>*，type=*<string>*；..."。