

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Inizia un lavoro
<a name="starting-a-job"></a>

Invia una `StartJob` richiesta con la configurazione del tuo lavoro. Specificate l'azione che desiderate eseguire, fornite l'ARN del ruolo di esecuzione e configurate le opzioni di input e output con le posizioni dei bucket Amazon S3.

Alcuni tipi di azioni supportano funzionalità aggiuntive opzionali che migliorano i risultati. Le funzionalità disponibili dipendono dal tipo di azione. Per le funzionalità aggiuntive di convalida degli indirizzi, vedere[Funzionalità di convalida degli indirizzi](address-validation-concepts.md#address-validation-features).

Fornisci un nome di lavoro significativo per aiutare a identificare il lavoro nelle operazioni di monitoraggio e gestione. Prendi in considerazione l'inclusione di timestamp o identificatori di batch nei nomi dei lavori per facilitarne il tracciamento.

## Esempi di convalida degli indirizzi
<a name="start-job-examples"></a>

Gli esempi seguenti mostrano come avviare un processo di convalida degli indirizzi. Utilizzali come riferimento per la struttura della richiesta.

### Avvia un processo di convalida degli indirizzi asincrono
<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
```

------

### Avvia un lavoro con funzionalità aggiuntive
<a name="start-job-with-features-example"></a>

L'esempio seguente include `Position` le funzionalità `CountrySpecificAttributes` aggiuntive:

------
#### [ 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
```

------