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'StartJoboperazione 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
Per ulteriori informazioni, consulta il riferimento StartJoball'API di Amazon Location Service.
Ad esempio richieste, risposte e comandi CLI per questa API, vedi Come avviare un lavoro.
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 soloValidateAddressè 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 soloParquetè 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 soloParquetè 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 84per 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. SemprePendingper i nuovi posti di lavoro. -
CreatedAt: timestamp di creazione del lavoro in formato ISO 8601.
-
