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à.
# StartJob
L'`StartJob`operazione avvia un nuovo processo di elaborazione dei dati di Amazon Location. Devi specificare il tipo di azione, le posizioni di input e output di Amazon S3 e un ruolo di esecuzione IAM che garantisce al servizio l'accesso ai tuoi bucket. L'operazione restituisce un identificatore del lavoro, Amazon Resource Name (ARN) e lo stato iniziale che puoi utilizzare per monitorare l'avanzamento del lavoro.
Puoi richiedere funzionalità aggiuntive utilizzando il `ActionOptions` parametro nelle `StartJob` richieste. Queste funzionalità offrono opzioni avanzate per l'elaborazione dei dati e i risultati.
Per i `ValidateAddress` lavori, la funzione **Posizione** include le coordinate di latitudine e longitudine nel formato [World Geodetic System (WGS](https://earth-info.nga.mil/index.php?dir=wgs84&action=wgs84) 84). **CountrySpecificAttributes**include dati aggiuntivi specifici per ogni paese, come le informazioni sulla rotta del corriere, i dati del censimento e gli identificatori postali.
Per ulteriori informazioni, consulta il *riferimento [StartJob](https://docs.aws.amazon.com/location/latest/APIReference/API_geojobs_StartJob.html)all'API di Amazon Location Service*.
Ad esempio richieste, risposte e comandi CLI per questa API, vedi [Come avviare un lavoro](https://docs.aws.amazon.com/location/latest/developerguide/starting-a-job.html).
## Casi d’uso
+ **Migrazione dei dati e consolidamento del sistema:** pulisci e standardizza grandi volumi di dati sugli indirizzi durante la migrazione tra sistemi o il consolidamento di più fonti di dati in un database unificato.
+ **Preparazione delle campagne di marketing:** convalida i database degli indirizzi dei clienti prima di lanciare campagne di direct mailing per ridurre i costi della posta restituita e migliorare le percentuali di successo della consegna.
+ **Manutenzione e conformità dei database:** convalida regolarmente i database degli indirizzi dei clienti esistenti per mantenere gli standard di qualità dei dati e soddisfare i requisiti di conformità in materia di spedizione e logistica.
## Comprendi la richiesta
La `StartJob` richiesta richiede dettagli di configurazione che specificano l'azione del lavoro, le posizioni dei dati e le autorizzazioni. Questa configurazione determina come i dati vengono elaborati e dove vengono archiviati i risultati.
La richiesta include i seguenti parametri:
**Job action e autorizzazioni**
Parametri obbligatori che definiscono il tipo di operazione e le autorizzazioni di accesso.
+ `Action`: il tipo di operazione da eseguire. Attualmento solo `ValidateAddress` è supportato.
+ `ExecutionRoleArn`: ARN del ruolo IAM che Amazon Location assume per accedere ai bucket Amazon S3 durante l'esecuzione del processo.
**Configurazione di input**
Parametri richiesti che specificano dove leggere i dati di input e il relativo formato.
+ `InputOptions`: oggetto contenente la configurazione dei dati di input.
+ `Location`: ARN o URI di Amazon S3 in cui sono archiviati i file di input.
+ `Format`: formato dei dati di input. Attualmento solo `Parquet` è supportato.
**Configurazione dell'output**
Parametri richiesti che specificano dove scrivere i risultati e il relativo formato.
+ `OutputOptions`: oggetto contenente la configurazione dei dati di output.
+ `Location`: ARN o URI di Amazon S3 in cui vengono scritti i file di output.
+ `Format`: formato dei dati di output. Attualmento solo `Parquet` è supportato.
**Parametri opzionali**
Parametri che forniscono funzionalità e configurazioni di lavoro aggiuntive.
+ `Name`: nome del lavoro leggibile dall'uomo per una più facile identificazione. Deve contenere da 1 a 100 caratteri corrispondenti allo schema. `[-._\w]+`
+ `ClientToken`: token di idempotenza per garantire che lo stesso lavoro non venga creato più volte. Deve contenere da 1 a 64 caratteri corrispondenti allo schema. `^[!-~]+$`
+ `ActionOptions`: oggetto contenente funzionalità aggiuntive per l'azione specificata.
+ `ValidateAddress`: Oggetto contenente opzioni specifiche per la convalida degli indirizzi.
+ `AdditionalFeatures`: matrice di nomi di funzionalità da includere nei risultati. Valori validi:
+ `Position`: include latitudine e longitudine in formato [WGS 84](https://earth-info.nga.mil/index.php?dir=wgs84&action=wgs84) per ogni indirizzo convalidato.
+ `CountrySpecificAttributes`: Include dati aggiuntivi specifici per ogni paese, come le informazioni sull'itinerario del corriere, i dati del censimento e gli identificatori postali.
## Comprendi la risposta
La `StartJob` risposta fornisce informazioni essenziali per il monitoraggio e la gestione del nuovo lavoro creato. Utilizzate questi valori per tenere traccia dell'avanzamento del lavoro e recuperare i risultati al termine dell'elaborazione.
La risposta include i seguenti campi:
**Identificazione del lavoro**
Identificatori univoci per il lavoro creato.
+ `JobId`: identificatore univoco del lavoro utilizzato per le operazioni di monitoraggio e gestione.
+ `JobArn`: ARN che identifica in modo univoco il lavoro all'interno. AWS
**Stato e tempistiche del lavoro**
Stato iniziale e data di creazione.
+ `Status`: stato della mansione iniziale. Sempre `Pending` per i nuovi posti di lavoro.
+ `CreatedAt`: timestamp di creazione del lavoro in formato ISO 8601.