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

# 使用 HealthOmics 執行群組
<a name="creating-run-groups"></a>

您可以選擇性地建立執行群組，以限制您新增至群組之執行的運算資源。執行群組可協助您：
+ 將執行排入佇列，以免超過服務限制。
+ 透過設定最長執行持續時間來擷取執行中任務。
+ 管理每個執行的優先順序，讓最重要的執行先完成。

如果您設定並行 vCPU、GPU 或執行次數上限，執行任務會在達到上限時排入佇列。如果您設定最長執行持續時間，如果超過最長執行持續時間，則執行會失敗。

使用執行優先順序設定在執行群組中建立優先順序。

服務限制優先於執行群組限制。例如，如果您將執行群組最大值設定為高於區域中的服務最大值，HealthOmics 會套用服務最大值。

**Topics**
+ [執行優先順序](#run-priority)
+ [使用主控台建立執行群組](#console-create-run-group)
+ [使用 CLI 建立執行群組](#api-create-run-group)
+ [使用主控台刪除執行群組](#console-delete-run-group)
+ [使用 CLI 刪除執行群組](#api-delete-run-group)

## 執行優先順序
<a name="run-priority"></a>



您可以使用執行優先順序來建立執行群組中執行的優先順序。

如果多個執行具有相同的優先順序，則首先啟動的執行具有較高的優先順序。



您也可以為不在執行群組中的執行設定優先順序。優先順序會與不在執行群組中的所有其他執行的優先順序進行比較



您可以在開始執行時設定執行優先順序。如需詳細資訊，請參閱[在 HealthOmics 中開始執行](starting-a-run.md)。

## 使用主控台建立執行群組
<a name="console-create-run-group"></a>

**建立執行群組**

1. 開啟 [HealthOmics 主控台](https://console.aws.amazon.com/omics/)。

1.  如有需要，請開啟左側導覽窗格 (≡)。選擇**執行群組**。

1. 在**執行群組**頁面上，選擇**建立執行群組**。

1. 在**建立執行群組詳細資訊**頁面上，提供下列資訊
   + **執行群組名稱** - 此執行群組的唯一名稱。
   + **並行執行的 vCPU 上限** - 可在執行群組中的所有作用中執行同時執行的 vCPUs 數目上限。
   + **最大 GPUs**：可在執行群組中的所有作用中執行中同時執行的 GPUs 數量上限。
   + **每次執行的最大執行時間 （分鐘）** - 每次執行的最大時間 （以分鐘為單位）。如果執行超過執行時間上限，則執行會自動失敗。
   + **並行執行上限** - 可同時執行的執行數目上限。

1. （選用） 您最多可以將 50 個**標籤**新增至執行群組。

1. 選擇**建立執行群組**。

## 使用 CLI 建立執行群組
<a name="api-create-run-group"></a>

若要建立執行群組，請使用 **create-run-group** API 操作來建立名為 的執行群組`TestRunGroup`。下列範例會設定最多 20 CPUs、10 個 GPUs、5 個執行，以及最多 600 分鐘的執行持續時間。

```
aws omics create-run-group --name TestRunGroup \
--max-cpus 20 \
--max-gpus 10 \
--max-duration 600 \
--max-runs 5
```

此 API 操作的回應包含新建立 的 ID`RunGroup`。

```
{
    "arn": "arn:aws:omics:us-west-2:12345678901:runGroup/2839621",
    "id": "2839621",
    "tags": {}
}
```

若要取得有關執行群組的其他資訊，請將此 ID 與 **get-run-group** API 操作搭配使用，如下列範例所示。

```
aws omics get-run-group --id run group id   
```

回應包含執行群組的限制設定和指派的標籤。

```
{
    "arn": "arn:aws:omics:us-west-2:776893852117:runGroup/2839621",
    "id": "2839621",
    "name": "TestRunGroup",
    "maxCpus": 20,
    "maxRuns": 5,
    "maxDuration": 600,
    "creationTime": "2024-06-12T15:35:39.191730+00:00",
    "tags": {},
    "maxGpus": 10
}
```

您也可以使用 **list-run-group** API 操作來檢視所有建立的執行群組。

```
aws omics list-run-groups     
```

## 使用主控台刪除執行群組
<a name="console-delete-run-group"></a>

如果沒有與狀態為 `PENDING`、`RUNNING`、 或 的執行群組相關聯的執行`STARTING`，您可以刪除執行群組`STOPPING`。

若要刪除執行群組，請遵循下列步驟。

1. 開啟 [HealthOmics 主控台](https://console.aws.amazon.com/omics/)。

1.  如有需要，請開啟左側導覽窗格 (≡)。選擇**執行群組**。

1. 在**執行群組**頁面上，選擇要刪除的執行群組，然後在 xx 中選擇**刪除**。

## 使用 CLI 刪除執行群組
<a name="api-delete-run-group"></a>

如果沒有與狀態為 `PENDING`、`RUNNING`、 或 的執行群組相關聯的執行`STARTING`，您可以刪除執行群組`STOPPING`。

下列範例示範如何使用 AWS CLI 刪除執行群組。您將不會收到回應。若要執行範例，`run group id`請以您要刪除之執行群組的 ID 取代 。

```
aws omics delete-run-group --id run group id 
```