

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

# Comece um trabalho
<a name="starting-a-job"></a>

Envie uma `StartJob` solicitação com a configuração do seu trabalho. Especifique a ação que você deseja realizar, forneça o ARN da função de execução e configure as opções de entrada e saída com os locais de seus buckets do Amazon S3.

Alguns tipos de ação oferecem suporte a recursos adicionais opcionais que aprimoram os resultados. Os recursos disponíveis dependem do tipo de ação. Para recursos adicionais de validação de endereço, consulte[Recursos de validação de endereço](address-validation-concepts.md#address-validation-features).

Forneça um nome de trabalho significativo para ajudar a identificar o trabalho nas operações de monitoramento e gerenciamento. Considere incluir carimbos de data e hora ou identificadores de lote nos nomes dos trabalhos para facilitar o rastreamento.

## Exemplos de validação de endereço
<a name="start-job-examples"></a>

Os exemplos a seguir mostram como iniciar um trabalho de validação de endereço. Use-os como referência para a estrutura da solicitação.

### Iniciar um trabalho de validação de endereço assíncrono
<a name="start-address-validation-example"></a>

------
#### [ Sample request ]

```
{
   "Action": "ValidateAddress",
   "Name": "MyFirstValidationJob",
   "ExecutionRoleArn": "arn:aws:iam::{{YOUR_ACCOUNT_ID}}:role/LocationServiceJobExecutionRole",
   "InputOptions": {
       "Location": "arn:aws:s3:::{{YOUR_INPUT_BUCKET_NAME}}",
       "Format": "Parquet"
   },
   "OutputOptions": {
       "Location": "arn:aws:s3:::{{YOUR_OUTPUT_BUCKET_NAME}}",
       "Format": "Parquet"
   }
}
```

------
#### [ Sample response ]

```
{
   "CreatedAt": "2024-01-01T00:00:00Z",
   "JobArn": "arn:aws:geo:us-west-2:{{YOUR_ACCOUNT_ID}}:job/MyFirstValidationJob-12345678-abcd-1234-5678-abcdef123456",
   "JobId": "MyFirstValidationJob-12345678-abcd-1234-5678-abcdef123456",
   "Status": "Pending"
}
```

------
#### [ AWS CLI ]

```
aws location start-job \
  --action ValidateAddress \
  --execution-role-arn "arn:aws:iam::{{YOUR_ACCOUNT_ID}}:role/LocationServiceJobExecutionRole" \
  --input-options Location=arn:aws:s3:::{{YOUR_INPUT_BUCKET}},Format=Parquet \
  --name "MyFirstCLIJob" \
  --output-options Location=arn:aws:s3:::{{YOUR_OUTPUT_BUCKET}},Format=Parquet \
  --region us-west-2
```

------

### Comece um trabalho com recursos adicionais
<a name="start-job-with-features-example"></a>

O exemplo a seguir inclui `Position` os recursos `CountrySpecificAttributes` adicionais:

------
#### [ Sample request ]

```
{
   "Action": "ValidateAddress",
   "Name": "ValidationJobWithFeatures",
   "ExecutionRoleArn": "arn:aws:iam::{{YOUR_ACCOUNT_ID}}:role/LocationServiceJobExecutionRole",
   "InputOptions": {
       "Location": "arn:aws:s3:::{{YOUR_INPUT_BUCKET_NAME}}",
       "Format": "Parquet"
   },
   "OutputOptions": {
       "Location": "arn:aws:s3:::{{YOUR_OUTPUT_BUCKET_NAME}}",
       "Format": "Parquet"
   },
   "ActionOptions": {
       "ValidateAddress": {
           "AdditionalFeatures": [
               "Position",
               "CountrySpecificAttributes"
           ]
       }
   }
}
```

------
#### [ AWS CLI ]

```
aws location start-job \
  --action ValidateAddress \
  --execution-role-arn "arn:aws:iam::{{YOUR_ACCOUNT_ID}}:role/LocationServiceJobExecutionRole" \
  --input-options Location=arn:aws:s3:::{{YOUR_INPUT_BUCKET}},Format=Parquet \
  --name "ValidationJobWithFeatures" \
  --output-options Location=arn:aws:s3:::{{YOUR_OUTPUT_BUCKET}},Format=Parquet \
  --action-options '{"ValidateAddress":{"AdditionalFeatures":["Position","CountrySpecificAttributes"]}}' \
  --region us-west-2
```

------