本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 AWS Batch 作业队列中搜索作业
<a name="searching-filtering-jobs"></a>

你可以使用 Job Search 搜索和 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 训练作业队列仅支持按**任务名称**和作**业 ID** 筛选
**注意**  
按**共享标识符**筛选时，您还可以指定任务状态。这是限制的例外，其他过滤器不包括作业状态筛选。

1. 选择**搜索**。

## 搜索和筛选 AWS Batch 职位 (AWS CLI)
<a name="search-filter-jobs-cli"></a>

使用此过程通过 AWS CLI列出作业队列中的所有作业。也可使用 **-filters** 参数来根据您指定的条件缩小结果范围。

------
#### [ 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*替换为要筛选依据的股票标识符。

------