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 name="start-job-api"></a>

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)](https://earth-info.nga.mil/index.php?dir=wgs84&action=wgs84). **CountrySpecificAttributes**inclui 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 [StartJob](https://docs.aws.amazon.com/location/latest/APIReference/API_geojobs_StartJob.html)a *Amazon Location Service API Reference*.

Por exemplo, solicitações, respostas e comandos da CLI para essa API, consulte [Como iniciar um trabalho](https://docs.aws.amazon.com/location/latest/developerguide/starting-a-job.html).

## Casos de uso
<a name="start-job-use-cases"></a>
+ **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 name="start-job-request-parameters"></a>

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](https://earth-info.nga.mil/index.php?dir=wgs84&action=wgs84) 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 name="start-job-response-details"></a>

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.