

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# AWS Batch Procure empregos em uma fila de empregos
<a name="searching-filtering-jobs"></a>

Você pode pesquisar e filtrar suas vagas AWS Batch usando a Pesquisa de vagas. Esse atributo fornece uma opção para pesquisar em uma fila de trabalhos existente e filtrar seus trabalhos.

A pesquisa e o filtro são capazes de recuperar trabalhos que não estão em um estado terminal (`SUCCEEDED` ou `FAILED`). Quando o estado de um trabalho estiver `SUCCEEDED` ou `FAILED` você deverá ser capaz de recuperá-lo por até sete dias. Você ainda pode ver os EventBridge registros de um trabalho CloudWatch ou da Amazon.

Para pesquisar usando vários critérios simultaneamente, use o atributo **Pesquisa avançada**. Por exemplo, é possível incluir qualquer um ou todos os filtros a seguir: **Status**, **Intervalo de datas** e **Critérios adicionais** (como nome do trabalho, definição do trabalho ou ID do trabalho). 

## Pesquisar AWS Batch empregos (AWS Console)
<a name="search-jobs"></a>

Use esse procedimento para pesquisar os trabalhos em uma fila de trabalhos no AWS Batch console. 

1. Navegue até o [console do AWS Batch](https://console.aws.amazon.com/batch/home).

1. No painel de navegação, escolha **Tarefas**.

1. Ative a **Pesquisa avançada**.

1. Expanda a lista suspensa **Fila de trabalhos** e escolha a fila de trabalhos na qual você deseja pesquisar.
**nota**  
É possível pesquisar trabalhos em apenas uma fila de trabalhos por vez.

1. Para **Opções de pesquisa**:

   1. Na lista suspensa **Status**, você pode escolher um ou mais status para filtrar. Para obter mais informações, consulte [Estados do trabalho](job_states.md) e [Status de serviço do trabalho](service-job-status.md).
**nota**  
Os pais dos trabalhos de matriz são atualizados para `PENDING` quando qualquer trabalho secundário é atualizado `RUNNABLE` e permanecem no `PENDING` status enquanto os trabalhos secundários estão em execução. Para visualizar esses trabalhos, filtre por `PENDING` status até que todos os trabalhos secundários atinjam um estado terminal.

   1. Escolha o **Intervalo de datas** para filtrar os resultados com base em um intervalo de data e hora.
      + Escolha o **modo Relativo** para pesquisar trabalhos com uma data de criação dentro de um intervalo de tempo contado para trás a partir da data e hora atuais. 
      + Escolha o **Modo absoluto** para pesquisar trabalhos com uma data de criação em um intervalo de data e hora especificado por você. 

   1. No campo **Critérios adicionais**, insira palavras-chave a serem incluídas nos resultados da pesquisa. Por exemplo, você pode usar esse campo para pesquisar por **nome do trabalho**, **definição do trabalho**, **ID do trabalho** ou **identificador de compartilhamento**. Dependendo da propriedade, pode haver operadores adicionais, como igual (=) ou contém (:), que você deve definir. 
**nota**  
SageMaker **As filas de trabalhos de treinamento suportam somente a filtragem por **nome do trabalho e ID do** trabalho**
**nota**  
Ao filtrar por **identificador de compartilhamento**, você também pode especificar o status do trabalho. Essa é uma exceção à restrição em que outros filtros excluem a filtragem do status do trabalho.

1. Selecione a opção **Pesquisar**.

## Pesquisar e filtrar AWS Batch vagas (AWS CLI)
<a name="search-filter-jobs-cli"></a>

Use esse procedimento para listar todos os trabalhos em uma fila de trabalhos com o AWS CLI. Opcionalmente, use o parâmetro **-filters** para restringir os resultados com base nos critérios que você especificar. 

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

Você pode usar o comando [list-jobs](https://docs.aws.amazon.com/cli/latest/reference/batch/list-jobs.html) para pesquisar e filtrar uma fila de trabalhos. 

Por exemplo, você pode pesquisar uma fila de trabalhos com base no nome do trabalho:

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

Filtrar trabalhos por identificador de compartilhamento:

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

Ao filtrar por identificador de compartilhamento, você pode incluir o status do trabalho:

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

No comando anterior, faça as seguintes alterações:
+ *my-job-queue*Substitua pelo nome da sua fila de trabalhos.
+ *my-job*Substitua pelo nome do seu trabalho.
+ *my-share*Substitua pelo identificador de compartilhamento pelo qual você deseja filtrar.

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

Você pode usar o [list-service-jobs](https://docs.aws.amazon.com/cli/latest/reference/batch/list-service-jobs.html)comando para pesquisar e filtrar uma fila de trabalhos de serviço. 

Por exemplo, você pode pesquisar uma fila de trabalhos de serviço com base no nome do trabalho:

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

Filtrar trabalhos de serviço por identificador de compartilhamento:

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

No comando anterior, faça as seguintes alterações:
+ *my-sm-queue*Substitua pelo nome da sua fila de trabalhos de serviço.
+ *my-sm-job*Substitua pelo nome do seu trabalho de serviço.
+ *my-share*Substitua pelo identificador de compartilhamento pelo qual você deseja filtrar.

------