

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# AWS Batch Busque trabajos en una cola de trabajos
<a name="searching-filtering-jobs"></a>

Puede buscar y filtrar sus trabajos AWS Batch mediante la búsqueda de empleo. Esta característica ofrece una opción para buscar en una cola de trabajos existente y filtrar sus trabajos.

La búsqueda y el filtrado tienen la capacidad de recuperar trabajos que no están en un estado terminal (`SUCCEEDED` o `FAILED`). Una vez que el estado de un trabajo sea `SUCCEEDED` o `FAILED`, podrá recuperarlo durante un máximo de siete días. Aún puedes ver los EventBridge registros de un trabajo CloudWatch o de Amazon.

Para buscar con varios criterios al mismo tiempo, utilice la característica **Búsqueda avanzada**. Por ejemplo, puede incluir uno o todos de los siguientes filtros: **Estado**, **Intervalo de fechas** y **Criterios adicionales** (como nombre del trabajo, definición del trabajo o ID del trabajo). 

## Buscar AWS Batch trabajos (AWS consola)
<a name="search-jobs"></a>

Utilice este procedimiento para buscar los trabajos en una cola de trabajos en la AWS Batch consola. 

1. Vaya a la [consola de AWS Batch](https://console.aws.amazon.com/batch/home).

1. En el panel de navegación, seleccione **Trabajos**.

1. Active la **Búsqueda avanzada**.

1. Expanda la lista desplegable **Cola de trabajos** y elija la cola de trabajos en la que desea buscar.
**nota**  
Puede buscar trabajos en una sola cola de trabajos a la vez.

1. En las **opciones de búsqueda**:

   1. En la lista desplegable de **Estados**, puedes elegir uno o más estados por los que filtrar. Para obtener más información, consulte [Estados de trabajo](job_states.md) y [Estado del trabajo de servicio](service-job-status.md).
**nota**  
Los padres de los trabajos de matriz se actualizan cada `PENDING` vez que se actualiza un trabajo secundario `RUNNABLE` y permanecen en `PENDING` su estado mientras los trabajos secundarios se están ejecutando. Para ver estos trabajos, filtre por `PENDING` estado hasta que todos los trabajos secundarios alcancen un estado terminal.

   1. (Opcional) Elija un **Intervalo de fechas** para filtrar los resultados en función de un rango de fechas y horas.
      + Seleccione el **Modo relativo** para buscar trabajos que tengan una fecha de creación en un intervalo de tiempo que cuente hacia atrás desde la fecha y la hora actuales. 
      + Seleccione el **Modo absoluto** para buscar trabajos que tengan una fecha de creación en el intervalo de fechas y horas que especifique. 

   1. En el campo **Criterios adicionales**, introduzca las palabras clave que desee incluir en los resultados de búsqueda. Por ejemplo, puede usar este campo para buscar por **nombre de trabajo**, **definición de trabajo**, **ID de trabajo** o **identificador de recurso compartido**. Según la propiedad, es posible que deba definir operadores adicionales, como igual a (=) o que contengan (:), que debe definir. 
**nota**  
SageMaker Las colas de trabajos de formación solo admiten el filtrado por **nombre e ID** de **trabajo.**
**nota**  
Al filtrar por **identificador de recurso compartido**, también puede especificar el estado de un trabajo. Se trata de una excepción a la restricción, en la que otros filtros excluyen el filtrado del estado del trabajo.

1. Elija **Buscar**.

## Buscar y filtrar AWS Batch trabajos (AWS CLI)
<a name="search-filter-jobs-cli"></a>

Use este procedimiento para enumerar todos los trabajos de una cola de trabajos con AWS CLI. Si lo desea, utilice el parámetro **-filters** para restringir los resultados en función de los criterios que especifique. 

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

Puede utilizar el comando [list-jobs](https://docs.aws.amazon.com/cli/latest/reference/batch/list-jobs.html) para buscar y filtrar una cola de trabajos. 

Por ejemplo, puede buscar una cola de trabajos según el nombre del trabajo:

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

Filtrar trabajos por identificador de recursos compartidos:

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

Al filtrar por identificador de recurso compartido, puede incluir el estado del trabajo:

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

En el comando anterior, realice los siguientes cambios:
+ *my-job-queue*Sustitúyalo por el nombre de la cola de trabajos.
+ *my-job*Sustitúyalo por el nombre de tu trabajo.
+ *my-share*Sustitúyalo por el identificador de recurso compartido por el que quieras filtrar.

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

Puede usar el [list-service-jobs](https://docs.aws.amazon.com/cli/latest/reference/batch/list-service-jobs.html)comando para buscar y filtrar una cola de trabajos de servicio. 

Por ejemplo, puede buscar una cola de trabajos de servicio según el nombre del trabajo:

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

Filtre los trabajos de servicio por identificador de recurso compartido:

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

En el comando anterior, realice los siguientes cambios:
+ *my-sm-queue*Sustitúyalo por el nombre de la cola de trabajos de servicio.
+ *my-sm-job*Sustitúyalo por el nombre de tu trabajo de servicio.
+ *my-share*Sustitúyalo por el identificador de recurso compartido por el que quieras filtrar.

------