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

# Search AWS Batch 用于任务队列中的作业
<a name="searching-filtering-jobs"></a>

您可以使用职位搜索 AWS Batch 来搜索和筛选您的职位。此功能提供了搜索现有作业队列以及筛选队列中作业的选项。

使用“搜索和筛选”功能可以检索非处于最终状态（`SUCCEEDED` 或 `FAILED`）的作业。一旦作业的状态变为 `SUCCEEDED` 或 `FAILED`，您最多可以在七天内检索该作业。您仍然可以查看任务 CloudWatch 或亚马逊 EventBridge 日志。

要同时使用多个条件进行搜索，请使用**高级搜索**功能。例如，您可以使用以下任何或所有筛选条件：**状态**、**日期范围**和**其他条件**（例如作业名称、作业定义，或作业 ID）。

## Search 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}}替换为要筛选依据的共享标识符。

------