View a markdown version of this page

StartJob - 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á.

StartJob

A StartJob operação inicia um novo trabalho de processamento de dados de localização da Amazon. Você especifica o tipo de ação, os locais de entrada e saída do Amazon S3 e uma função de execução do IAM que concede ao serviço acesso aos seus buckets. A operação retorna um identificador do trabalho, o Amazon Resource Name (ARN) e o status inicial que você pode usar para monitorar o progresso do trabalho.

Você pode solicitar recursos adicionais usando o ActionOptions parâmetro nas StartJob solicitações. Esses recursos oferecem opções aprimoradas para processamento de dados e resultados.

Para ValidateAddress trabalhos, o recurso Posição inclui coordenadas de latitude e longitude no formato do Sistema Geodésico Mundial (WGS 84). CountrySpecificAttributesinclui dados adicionais específicos de cada país, como informações de rota da transportadora, dados do censo e identificadores postais.

Para obter mais informações, consulte StartJoba Amazon Location Service API Reference.

Por exemplo, solicitações, respostas e comandos da CLI para essa API, consulte Como iniciar um trabalho.

Casos de uso

  • Migração de dados e consolidação do sistema: limpe e padronize grandes volumes de dados de endereço ao migrar entre sistemas ou consolidar várias fontes de dados em um banco de dados unificado.

  • Preparação da campanha de marketing: valide bancos de dados de endereços de clientes antes de lançar campanhas de mala direta para reduzir os custos de correspondência devolvida e melhorar as taxas de sucesso de entrega.

  • Manutenção e conformidade do banco de dados: valide regularmente os bancos de dados de endereços de clientes existentes para manter os padrões de qualidade dos dados e atender aos requisitos de conformidade de transporte e logística.

Sobre a solicitação

A StartJob solicitação exige detalhes de configuração que especifiquem a ação do trabalho, os locais dos dados e as permissões. Essa configuração determina como seus dados são processados e onde os resultados são armazenados.

A solicitação inclui os seguintes parâmetros:

Ação e permissões do Job

Parâmetros obrigatórios que definem o tipo de operação e as permissões de acesso.

  • Action: O tipo de operação a ser executada. No momento, somente ValidateAddress é compatível.

  • ExecutionRoleArn: ARN da função do IAM que a Amazon Location assume para acessar seus buckets do Amazon S3 durante a execução do trabalho.

Configuração de entrada

Parâmetros obrigatórios que especificam onde ler os dados de entrada e seu formato.

  • InputOptions: Objeto contendo configuração de dados de entrada.

    • Location: ARN ou URI do Amazon S3 em que os arquivos de entrada são armazenados.

    • Format: Formato de dados de entrada. No momento, somente Parquet é compatível.

Configuração de saída

Parâmetros obrigatórios que especificam onde gravar os resultados e seu formato.

  • OutputOptions: Objeto contendo configuração de dados de saída.

    • Location: ARN ou URI do Amazon S3 em que os arquivos de saída são gravados.

    • Format: Formato de dados de saída. No momento, somente Parquet é compatível.

Parâmetros opcionais

Parâmetros que fornecem configurações e recursos adicionais do trabalho.

  • Name: Nome do trabalho legível por humanos para facilitar a identificação. Deve ter de 1 a 100 caracteres que correspondam ao padrão[-._\w]+.

  • ClientToken: token de idempotência para garantir que o mesmo trabalho não seja criado várias vezes. Deve ter de 1 a 64 caracteres que correspondam ao padrão^[!-~]+$.

  • ActionOptions: Objeto contendo recursos adicionais para a ação especificada.

    • ValidateAddress: Objeto contendo opções específicas para validação de endereço.

      • AdditionalFeatures: matriz de nomes de recursos a serem incluídos nos resultados. Valores válidos:

        • Position: inclui latitude e longitude no formato WGS 84 para cada endereço validado.

        • CountrySpecificAttributes: inclui dados adicionais específicos de cada país, como informações sobre a rota da transportadora, dados do censo e identificadores postais.

Sobre a resposta

A StartJob resposta fornece informações essenciais para monitorar e gerenciar o trabalho recém-criado. Use esses valores para monitorar o progresso do trabalho e recuperar os resultados quando o processamento for concluído.

A resposta inclui os seguintes campos:

Identificação do trabalho

Identificadores exclusivos para o trabalho criado.

  • JobId: identificador de trabalho exclusivo usado para operações de monitoramento e gerenciamento.

  • JobArn: ARN que identifica de forma exclusiva o trabalho contido em. AWS

Status e horário do trabalho

Status inicial e data e hora de criação.

  • Status: Status inicial do trabalho. Sempre Pending para empregos recém-criados.

  • CreatedAt: Carimbo de data e hora de criação de emprego no formato ISO 8601.