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 [GetJob](https://docs.aws.amazon.com/location/latest/APIReference/API_geojobs_GetJob.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 supervisar el progreso del trabajo](https://docs.aws.amazon.com/location/latest/developerguide/monitoring-job-progress.html).
## 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 la `StartJob` operació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 solo `ValidateAddress` se 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, como `Position` o`CountrySpecificAttributes`.
**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`: un `JobError` objeto 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.