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 ListJobsla 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.
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:PendingRunning,Completed,Failed,Cancelling, oCancelled.
-
-
- 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 unaListJobsrespuesta 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 siguienteListJobssolicitud 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.
