As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# GetJob
<a name="get-job-api"></a>

A `GetJob` operação recupera informações sobre uma tarefa específica, incluindo seu status atual, configuração, registros de data e hora e qualquer informação de erro. Use essa operação para monitorar o progresso do trabalho e verificar os detalhes da configuração. Para trabalhos concluídos, você pode usar essas informações para verificar o sucesso do processamento antes de acessar os resultados.

Para obter mais informações, consulte [GetJob](https://docs.aws.amazon.com/location/latest/APIReference/API_geojobs_GetJob.html)a *Amazon Location Service API Reference*.

Por exemplo, solicitações, respostas e comandos da CLI para essa API, consulte [Como monitorar o progresso do trabalho](https://docs.aws.amazon.com/location/latest/developerguide/monitoring-job-progress.html).

## Casos de uso
<a name="get-job-use-cases"></a>
+ **Monitoramento do status e do progresso do trabalho:** acompanhe a progressão do ciclo de vida do trabalho nos estados pendente, em execução e conclusão para determinar quando o processamento está concluído e os resultados estão disponíveis para download. Monitore o status do trabalho para gerenciamento e geração de relatórios do fluxo de trabalho.
+ **Diagnóstico de erros:** recupere informações detalhadas de erros quando os trabalhos falham, incluindo mensagens de erro específicas e motivos de falha para solucionar problemas de processamento.
+ **Verificação da configuração:** confirme os detalhes da configuração do trabalho, incluindo input/output locais, funções de execução e recursos solicitados antes do início do processamento.

## Sobre a solicitação
<a name="get-job-request-parameters"></a>

A `GetJob` solicitação requer apenas um único parâmetro para recuperar informações abrangentes sobre um trabalho específico. Essa estrutura de solicitação simples facilita o monitoramento do status do trabalho e a recuperação de informações detalhadas de configuração e processamento.

A solicitação inclui o seguinte parâmetro:

**Identificação do trabalho**  
Parâmetro obrigatório que especifica sobre qual tarefa recuperar informações.  
+ `JobId`: o identificador exclusivo da tarefa a ser recuperada. Deve ter de 1 a 100 caracteres que correspondam ao padrão`[-._\w]+`. Esse é o mesmo identificador retornado pela `StartJob` operação quando o trabalho foi criado.

## Sobre a resposta
<a name="get-job-response-details"></a>

A `GetJob` resposta fornece informações sobre o trabalho especificado, incluindo seu status atual, configuração completa, registros de data e hora de processamento e qualquer informação de erro. Você pode usar essa resposta para monitorar o status do trabalho e solucionar quaisquer erros que possam surgir.

A resposta inclui os seguintes campos:

**Identificação do trabalho**  
Identificadores exclusivos e informações básicas sobre o trabalho.  
+ `JobId`: o identificador exclusivo de tarefas usado para operações de monitoramento e gerenciamento.
+ `JobArn`: ARN que identifica de forma exclusiva o trabalho contido em. AWS
+ `Name`: nome do trabalho legível por humanos, se especificado durante a criação do trabalho.

**Status do trabalho e ciclo de vida**  
Estado atual do trabalho e informações do cronograma de processamento.  
+ `Status`: Status atual do trabalho indicando o estado do processamento (pendente, em execução, concluído, com falha, cancelando ou cancelado).
+ `CreatedAt`: Carimbo de data e hora de criação de emprego no formato ISO 8601.
+ `UpdatedAt`: data e hora da última atualização de status no formato ISO 8601.
+ `EndedAt`: Carimbo de data e hora de conclusão do trabalho no formato ISO 8601. Presente apenas para empregos em estados terminais.

**Configuração do trabalho**  
Conclua a configuração do trabalho conforme especificado durante a criação.  
+ `Action`: o tipo de operação que está sendo executada (atualmente somente `ValidateAddress` é suportada).
+ `ExecutionRoleArn`: ARN da função do IAM usado para acessar buckets do Amazon S3 durante a execução do trabalho.
+ `InputOptions`: Configuração de entrada, incluindo localização e formato de dados do Amazon S3.
+ `OutputOptions`: Configuração de saída, incluindo destino e formato de resultado do Amazon S3.
+ `ActionOptions`: recursos adicionais opcionais solicitados para o trabalho, como `Position` ou`CountrySpecificAttributes`.

**Informações de erro**  
Quando um trabalho falha, a resposta inclui detalhes do erro para ajudá-lo a diagnosticar e resolver o problema.  
+ `Error`: um `JobError` objeto contendo detalhes sobre a falha. Esse objeto inclui os seguintes campos:
  + `Code`: um código de erro que identifica o tipo de falha.
  + `Messages`: uma lista de mensagens legíveis por humanos que fornecem contexto adicional para solução de problemas.