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.
GetJob
La GetJob operación recupera información sobre un trabajo específico, incluido su estado actual, la configuración, las marcas horarias y cualquier información de error. Utilice esta operación para supervisar el progreso del trabajo y verificar los detalles de la configuración. En el caso de los trabajos finalizados, puede utilizar esta información para comprobar que el procesamiento se ha realizado correctamente antes de acceder a los resultados.
Para obtener más información, consulta GetJobla referencia de la API de Amazon Location Service.
Para ver ejemplos de solicitudes, respuestas y comandos de CLI para esta API, consulta Cómo supervisar el progreso del trabajo.
Casos de uso
-
Supervisión del estado y el progreso del trabajo: realice un seguimiento de la progresión del ciclo de vida del trabajo a través de los estados pendiente, en ejecución y finalización para determinar cuándo se ha completado el procesamiento y los resultados están disponibles para su descarga. Supervise el estado de las tareas para gestionar el flujo de trabajo y generar informes.
-
Diagnóstico de errores: recupere información detallada sobre los errores cuando los trabajos fallen, incluidos los mensajes de error específicos y los motivos de los errores para solucionar los problemas de procesamiento.
-
Verificación de la configuración: confirme los detalles de la configuración del trabajo, incluidas input/output las ubicaciones, las funciones de ejecución y las funciones solicitadas, antes de que comience el procesamiento.
Explicación de la solicitud
La GetJob solicitud requiere solo un parámetro para recuperar información completa sobre un trabajo específico. Esta sencilla estructura de solicitud facilita la supervisión del estado del trabajo y la recuperación de información detallada de configuración y procesamiento.
La solicitud incluye el siguiente parámetro:
- Identificación del trabajo
-
Parámetro obligatorio que especifica el trabajo sobre el que se va a recuperar la información.
-
JobId: el identificador único del trabajo que se va a recuperar. Debe tener entre 1 y 100 caracteres que coincidan con el patrón.[-._\w]+Es el mismo identificador devuelto por laStartJoboperación cuando se creó el trabajo.
-
Explicación de la respuesta
La GetJob respuesta proporciona información sobre el trabajo especificado, incluido su estado actual, la configuración completa, las marcas de tiempo de procesamiento y cualquier información de error. Puede utilizar esta respuesta para supervisar el estado del trabajo y solucionar cualquier error que pueda surgir.
La respuesta incluye los siguientes campos:
- Identificación del trabajo
-
Identificadores únicos e información laboral básica.
-
JobId: El identificador de trabajo único que se utiliza para las operaciones de supervisión y gestión. -
JobArn: ARN que identifica de forma exclusiva el trabajo interno. AWS -
Name: nombre del trabajo legible por humanos si se especificó durante la creación del trabajo.
-
- Estado y ciclo de vida del trabajo
-
Información sobre el estado actual del trabajo y el cronograma de procesamiento.
-
Status: el estado actual del trabajo indica el estado del procesamiento (pendiente, en ejecución, completado, fallido, cancelado o cancelado). -
CreatedAt: Marca de tiempo de creación de empleo en formato ISO 8601. -
UpdatedAt: Fecha y hora de la última actualización de estado en formato ISO 8601. -
EndedAt: Marca de tiempo de finalización del trabajo en formato ISO 8601. Solo está presente para trabajos en estados terminales.
-
- Configuración del trabajo
-
Complete la configuración del trabajo tal y como se especificó durante la creación.
-
Action: el tipo de operación que se está realizando (actualmente soloValidateAddressse admite). -
ExecutionRoleArn: el ARN del rol de IAM se utiliza para acceder a los buckets de Amazon S3 durante la ejecución del trabajo. -
InputOptions: configuración de entrada que incluye la ubicación y el formato de datos de Amazon S3. -
OutputOptions: configuración de salida que incluye el formato de destino y resultado de Amazon S3. -
ActionOptions: funciones adicionales opcionales solicitadas para el trabajo, comoPositionoCountrySpecificAttributes.
-
- Información de error
-
Cuando se produce un error en un trabajo, la respuesta incluye detalles del error para ayudarte a diagnosticar y resolver el problema.
-
Error: unJobErrorobjeto que contiene detalles sobre el error. Este objeto incluye los siguientes campos:-
Code: un código de error que identifica el tipo de error. -
Messages: una lista de mensajes legibles por humanos que proporcionan un contexto adicional para la solución de problemas.
-
-
