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

# AWS Batch 搜尋任務佇列中的任務
<a name="searching-filtering-jobs"></a>

您可以使用任務搜尋在 中搜尋和篩選 AWS Batch 任務。此功能提供在現有任務佇列中搜尋並篩選其任務的選項。

搜尋和篩選能夠擷取未處於終端狀態 (`SUCCEEDED` 或 ) 的任務`FAILED`。一旦任務的狀態為 `SUCCEEDED`，或者`FAILED`您應該能夠擷取任務最多七天。您仍然可以檢視任務的 CloudWatch 或 Amazon EventBridge 日誌。

若要同時使用多個條件進行搜尋，請使用**進階搜尋**功能。例如，您可以包含下列任何或所有篩選條件：**狀態**、**日期範圍****和其他條件** （例如任務名稱、任務定義或任務 ID)。

## 搜尋 AWS Batch 任務AWS （主控台）
<a name="search-jobs"></a>

使用此程序在 AWS Batch 主控台中搜尋任務佇列中的任務。

1. 導覽至 [AWS Batch 主控台](https://console.aws.amazon.com/batch/home)。

1. 在導覽窗格中，選擇**任務**。

1. 開啟**進階搜尋**。

1. 展開**任務佇列**下拉式清單，然後選擇您要搜尋的任務佇列。
**注意**  
您一次只能搜尋一個任務佇列內的任務。

1. 對於**搜尋選項**：

   1. 針對**狀態**下拉式清單，您可以選擇要篩選的一或多個狀態。如需詳細資訊，請參閱[任務狀態](job_states.md)及[服務任務狀態](service-job-status.md)。
**注意**  
當任何子任務更新為 `PENDING`時，陣列任務父會更新為 ，`RUNNABLE`並在子任務執行時保持為 `PENDING` 狀態。若要檢視這些任務，請根據`PENDING`狀態進行篩選，直到所有子任務達到最終狀態為止。

   1. 選擇**日期範圍**，根據日期和時間範圍篩選結果。
      + 選擇**相對模式**，以搜尋在從目前日期和時間回溯計數的時間範圍內建立日期的任務。
      + 選擇**絕對模式**以搜尋在您指定的日期和時間範圍內建立日期的任務。

   1. 在**其他條件**欄位中，輸入要包含在搜尋結果中的關鍵字。例如，您可以使用此欄位依**任務名稱**、**任務定義**、**任務 ID** 或**共用識別符**進行搜尋。視 屬性而定，可能會有其他運算子，例如等於 (=) 或包含您必須定義的 (：)。
**注意**  
SageMaker Training 任務佇列僅支援依**任務名稱**和**任務 ID** 篩選
**注意**  
依**共用識別符**篩選時，您也可以指定任務狀態。這是其他篩選條件排除任務狀態篩選的限制的例外狀況。

1. 選擇 **Search** (搜尋)。

## 搜尋和篩選 AWS Batch 任務 (AWS CLI)
<a name="search-filter-jobs-cli"></a>

使用此程序，透過 列出任務佇列中的所有任務 AWS CLI。或者，使用 **篩選條件**參數，根據您指定的條件縮小結果範圍。

------
#### [ Search job queue (AWS CLI) ]

您可以使用 [list-jobs](https://docs.aws.amazon.com/cli/latest/reference/batch/list-jobs.html) 命令來搜尋和篩選任務佇列。

例如，您可以根據任務名稱搜尋任務佇列：

```
aws batch list-jobs \
    --job-queue {{my-job-queue}} \
    --filters name=JOB_NAME,values="{{my-job}}"
```

依共用識別符篩選任務：

```
aws batch list-jobs \
    --job-queue {{my-job-queue}} \
    --filters name=SHARE_IDENTIFIER,values="{{my-share}}"
```

依共用識別符篩選時，您可以包含任務狀態：

```
aws batch list-jobs \
    --job-queue {{my-job-queue}} \
    --job-status RUNNING \
    --filters name=SHARE_IDENTIFIER,values="{{my-share}}"
```

在上述命令中，進行下列變更：
+ 以您的任務佇列名稱取代 {{my-job-queue}}。
+ 將 {{my-job}} 取代為您的任務名稱。
+ 將 {{my-share}} 取代為您要篩選的共用識別符。

------
#### [ Search service job queue (AWS CLI) ]

您可以使用 [list-service-jobs](https://docs.aws.amazon.com/cli/latest/reference/batch/list-service-jobs.html) 命令來搜尋和篩選服務任務佇列。

例如，您可以根據任務名稱搜尋服務任務佇列：

```
aws batch list-service-jobs \
    --job-queue {{my-sm-queue}} \
    --filters name=JOB_NAME,values="{{my-sm-job}}"
```

依共用識別符篩選服務任務：

```
aws batch list-service-jobs \
    --job-queue {{my-sm-queue}} \
    --filters name=SHARE_IDENTIFIER,values="{{my-share}}"
```

在上述命令中，進行下列變更：
+ 以您的服務任務佇列名稱取代 {{my-sm-queue}}。
+ 以您的服務任務名稱取代 {{my-sm-job}}。
+ 將 {{my-share}} 取代為您要篩選的共用識別符。

------