本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# AWS Batch (`awsbatch`)
如需 的詳細資訊 AWS Batch，請參閱 [AWS Batch](https://aws.amazon.com/batch/)。如需文件，請參閱 [AWS Batch 使用者指南](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 任務](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`
將任務提交至叢集的任務佇列。
```
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)。
## 定位引數
***command***
提交任務 （指定的命令必須可用於運算執行個體） 或要傳輸的檔案名稱。另請參閱`--command-file`。
**arguments**
(選用) 指定命令或命令檔案的引數。
## 具名引數
**-jn *JOB\$1NAME*, --job-name *JOB\$1NAME***
為任務命名。第一個字元必須是字母或數字。任務名稱可包含字母 （大小寫）、數字、連字號和底線，長度上限為 128 個字元。
**-c *CLUSTER*, --cluster *CLUSTER***
指定要使用的叢集。
**-cf, --command-file**
指出命令是要傳輸至運算執行個體的檔案。
預設：False
**-w *WORKING\$1DIR*, --working-dir *WORKING\$1DIR***
指定要做為任務工作目錄的資料夾。如果未指定工作目錄，任務會在使用者主目錄的`job-`子資料夾中執行。您可以使用此參數或 `--parent-working-dir` 參數。
**-pw *PARENT\$1WORKING\$1DIR*, --parent-working-dir *PARENT\$1WORKING\$1DIR***
指定任務工作目錄的父資料夾。如果未指定父工作目錄，則會預設為使用者的主目錄。系統會在上層工作目錄中建立一個名為 `job-` 的子資料夾。您可以使用此參數或 `--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=**，type=**；..."。
# `awsbstat`
顯示在叢集的任務佇列中提交的任務。
```
awsbstat [-h] [-c CLUSTER] [-s STATUS] [-e] [-d] [job_ids [job_ids ...]]
```
## 定位引數
***job\$1ids***
指定以空格分隔的清單，其中列出要在輸出中顯示的任務 ID。如果該任務為任務陣列，則會顯示所有子任務。如果請求單一任務，則會以詳細版本顯示它。
## 具名引數
**-c *CLUSTER*, --cluster *CLUSTER***
指出要使用的叢集。
**-s *STATUS*, --status *STATUS***
指定以逗號分隔的清單，其中列出要包含的任務狀態。預設任務狀態為「作用中」。可接受的值為：`SUBMITTED`、`PENDING`、`RUNNABLE`、`STARTING`、`RUNNING`、`SUCCEEDED`、`FAILED` 和 `ALL`。
預設：“`SUBMITTED`,`PENDING`,`RUNNABLE`,`STARTING`,`RUNNING`”
**-e, --expand-children**
展開具有子項 (陣列和多節點平行) 的任務。
預設：False
**-d, --details**
顯示任務詳細資訊。
預設：False
# `awsbout`
顯示特定任務的輸出。
```
awsbout [ - h ] [ - c CLUSTER ] [ - hd HEAD ] [ - t TAIL ] [ - s ] [ - sp STREAM_PERIOD ] job_id
```
## 定位引數
***job\$1id***
指定任務 ID。
## 具名引數
**-c *CLUSTER*, --cluster *CLUSTER***
指出要使用的叢集。
**-hd *HEAD*, --head *HEAD***
取得任務輸出的第一個 *HEAD* 行。
**-t *TAIL*, --tail *TAIL***
取得任務輸出的最後一個 行。
**-s, --stream**
取得任務輸出，然後等待產生額外的輸出。此引數可與 –tail 搭配使用，從任務輸出的最新 行開始。
預設：False
**-sp *STREAM\$1PERIOD*, --stream-period *STREAM\$1PERIOD***
設定串流期間。
預設：5
# `awsbkill`
取消或終止叢集中提交的任務。
```
awsbkill [ - h ] [ - c CLUSTER ] [ - r REASON ] job_ids [ job_ids ... ]
```
## 定位引數
***job\$1ids***
指定以空格分隔的清單，其中列出要取消或終止的任務 ID。
## 具名引數
**-c *CLUSTER*, --cluster *CLUSTER***
指出要使用的叢集名稱。
**-r *REASON*, --reason *REASON***
指出要附加至任務的訊息，說明任務取消的原因。
預設：”Terminated by the user”
# `awsbqueues`
顯示與叢集相關聯的任務佇列。
```
awsbqueues [ - h ] [ - c CLUSTER ] [ - d ] [ job_queues [ job_queues ... ]]
```
## 定位引數
***job\$1queues***
指定以空格分隔的清單，其中列出要顯示的佇列名稱。如果請求單一佇列，則會以詳細版本顯示它。
## 具名引數
**-c *CLUSTER*, --cluster *CLUSTER***
指定要使用的叢集名稱。
**-d, --details**
指出是否顯示佇列的詳細資訊。
預設：False
# `awsbhosts`
顯示屬於叢集運算環境的主機。
```
awsbhosts [ - h ] [ - c CLUSTER ] [ - d ] [ instance_ids [ instance_ids ... ]]
```
## 定位引數
***instance\$1ids***
指定空格分隔的執行個體 ID 清單。如果請求單一執行個體，則會以詳細版本顯示它。
## 具名引數
**-c *CLUSTER*, --cluster *CLUSTER***
指定要使用的叢集名稱。
**-d, --details**
指出是否顯示主機的詳細資訊。
預設：False