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.
# ListJobs
La `ListJobs` operación recupera una lista paginada de trabajos con capacidades de filtrado opcionales. Puede filtrar por estado de trabajo y controlar el número de resultados devueltos. La operación admite la paginación a través de los siguientes símbolos, lo que le permite recuperar listas de tareas de gran tamaño de manera eficiente.
Para obtener más información, consulta [ListJobs](https://docs.aws.amazon.com/location/latest/APIReference/API_geojobs_ListJobs.html)la *referencia de la API de Amazon Location Service*.
Para ver ejemplos de solicitudes, respuestas y comandos de CLI para esta API, consulta [Cómo enumerar trabajos](https://docs.aws.amazon.com/location/latest/developerguide/listing-jobs.html).
## Casos de uso
+ **Gestión del inventario de trabajos:** recupere todos los trabajos para auditar el historial de procesamiento y realizar un seguimiento de la utilización de los recursos en las operaciones de validación.
+ **Supervisión basada en el estado:** filtre los trabajos por estado para identificar los trabajos en ejecución que requieren atención o los trabajos finalizados que están listos para la recuperación de los resultados.
+ **Informes operativos:** genere informes sobre los patrones de ejecución de los trabajos, las tasas de éxito y los volúmenes de procesamiento para el análisis empresarial.
+ **Solución de problemas y depuración: enumere** los trabajos fallidos para identificar patrones en los errores de procesamiento y diagnosticar problemas sistemáticos.
## Explicación de la solicitud
La `ListJobs` solicitud acepta parámetros opcionales para el filtrado y la paginación. Sin ningún parámetro, la operación devuelve todos los trabajos con la paginación predeterminada.
La solicitud incluye los siguientes parámetros opcionales:
**Opciones de filtrado**
Parámetros opcionales para reducir la lista de trabajos devueltos.
+ `Filter`: Objeto que contiene criterios de filtro.
+ `JobStatus`: filtra los trabajos por su estado actual. Valores válidos: `Pending``Running`,`Completed`,`Failed`,`Cancelling`, o`Cancelled`.
**Controles de paginación**
Parámetros opcionales para controlar la paginación de los resultados.
+ `MaxResults`: Número máximo de trabajos que se pueden devolver en una sola respuesta. Utilice esta opción para controlar el tamaño de la página en conjuntos de resultados de gran tamaño.
+ `NextToken`: símbolo de paginación de una `ListJobs` respuesta anterior. Incluye este token para recuperar la siguiente página de resultados.
## Explicación de la respuesta
La `ListJobs` respuesta proporciona una lista paginada de resúmenes de trabajos con información de configuración y estado de cada trabajo. Utilice el siguiente token para recuperar páginas adicionales cuando haya más resultados disponibles.
La respuesta incluye los siguientes campos:
**Lista de trabajos**
Conjunto de resúmenes de trabajos que coinciden con los criterios del filtro.
+ `Entries`: Conjunto de resúmenes de puestos, que incluye:
+ `Action`: Acción realizada por el trabajo.
+ `CreatedAt`: Fecha y hora de creación de empleo en formato ISO 8601.
+ `EndedAt`: Marca de tiempo de finalización del trabajo en formato ISO 8601. Solo está presente para los trabajos en estados terminales (completados, fallidos o cancelados).
+ `ExecutionRoleArn`: función de IAM utilizada para la ejecución.
+ `InputOptions`: objeto de configuración de entrada.
+ `JobArn`: Nombre del recurso de Amazon (ARN) del trabajo.
+ `JobId`: identificador de trabajo único.
+ `Name`: nombre del trabajo si se proporcionó durante la creación.
+ `OutputOptions`: objeto de configuración de salida.
+ `Status`: Estado actual del trabajo.
+ `UpdatedAt`: Fecha y hora de la última actualización en formato ISO 8601.
+ `ActionOptions`: Se solicitan funciones adicionales, si las hubiera.
**Token de paginación**
Símbolo para recuperar resultados adicionales.
+ `NextToken`: token que se incluirá en la siguiente `ListJobs` solicitud para recuperar la siguiente página de resultados. Este campo solo está presente cuando hay más resultados disponibles. La ausencia de este campo indica que ha recuperado la última página.
**nota**
Los resultados mantienen un orden uniforme en todas las páginas. Usa el `NextToken` contenido de cada respuesta en las solicitudes posteriores para recorrer todas las páginas de resultados.