View a markdown version of this page

GetJob - Amazon Location Service
Casos de usoSobre a solicitaçãoSobre a resposta

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 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 GetJoba Amazon Location Service API Reference.

Por exemplo, solicitações, respostas e comandos da CLI para essa API, consulte Como monitorar o progresso do trabalho.

Casos de uso

  • 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 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 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 ouCountrySpecificAttributes.

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.