View a markdown version of this page

GetJob - Servizio di posizione Amazon

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

GetJob

L'GetJoboperazione recupera informazioni su un lavoro specifico, inclusi lo stato corrente, la configurazione, i timestamp ed eventuali informazioni sugli errori. Utilizzare questa operazione per monitorare l'avanzamento del lavoro e verificare i dettagli di configurazione. Per i lavori completati, è possibile utilizzare queste informazioni per verificare la corretta elaborazione prima di accedere ai risultati.

Per ulteriori informazioni, consulta il riferimento GetJoball'API di Amazon Location Service.

Ad esempio richieste, risposte e comandi CLI per questa API, vedi Come monitorare l'avanzamento del lavoro.

Casi d’uso

  • Monitoraggio dello stato e dell'avanzamento del lavoro: monitora la progressione del ciclo di vita del lavoro attraverso gli stati in sospeso, in esecuzione e di completamento per determinare quando l'elaborazione è completa e i risultati sono disponibili per il download. Monitora lo stato dei lavori per la gestione e la reportistica del flusso di lavoro.

  • Diagnosi degli errori: recupera informazioni dettagliate sugli errori quando i lavori falliscono, inclusi messaggi di errore specifici e motivi di errore per risolvere i problemi di elaborazione.

  • Verifica della configurazione: conferma i dettagli della configurazione del lavoro, tra cui input/output posizioni, ruoli di esecuzione e funzionalità richieste, prima dell'inizio dell'elaborazione.

Comprendi la richiesta

La GetJob richiesta richiede solo un singolo parametro per recuperare informazioni complete su un lavoro specifico. Questa semplice struttura di richiesta semplifica il monitoraggio dello stato del lavoro e il recupero di informazioni dettagliate sulla configurazione e sull'elaborazione.

La richiesta include il seguente parametro:

Identificazione del lavoro

Parametro obbligatorio che specifica su quale processo recuperare le informazioni.

  • JobId: l'identificatore univoco del lavoro da recuperare. Deve contenere da 1 a 100 caratteri corrispondenti allo schema. [-._\w]+ Si tratta dello stesso identificatore restituito dall'StartJoboperazione al momento della creazione del lavoro.

Comprendi la risposta

La GetJob risposta fornisce informazioni sul lavoro specificato, tra cui lo stato corrente, la configurazione completa, i timestamp di elaborazione ed eventuali informazioni sugli errori. È possibile utilizzare questa risposta per monitorare lo stato del processo e risolvere eventuali errori che potrebbero verificarsi.

La risposta include i seguenti campi:

Identificazione del lavoro

Identificatori univoci e informazioni di base sulla mansione.

  • JobId: L'identificatore univoco del lavoro utilizzato per il monitoraggio e la gestione delle operazioni.

  • JobArn: ARN che identifica in modo univoco il lavoro all'interno. AWS

  • Name: nome del lavoro leggibile dall'uomo, se specificato durante la creazione del lavoro.

Stato del lavoro e ciclo di vita

Informazioni sullo stato attuale del lavoro e sulla tempistica di elaborazione.

  • Status: stato attuale del lavoro che indica lo stato di elaborazione (In sospeso, In esecuzione, Completato, Non riuscito, Annullato o Annullato).

  • CreatedAt: timestamp di creazione del lavoro in formato ISO 8601.

  • UpdatedAt: timestamp dell'ultimo aggiornamento dello stato in formato ISO 8601.

  • EndedAt: timestamp di completamento del lavoro in formato ISO 8601. Disponibile solo per i lavori negli stati terminali.

Configurazione dei processi

Configurazione completa del lavoro come specificato durante la creazione.

  • Action: il tipo di operazione da eseguire (attualmente ValidateAddress è supportata solo questa opzione).

  • ExecutionRoleArn: ARN del ruolo IAM utilizzato per accedere ai bucket Amazon S3 durante l'esecuzione del processo.

  • InputOptions: configurazione di input che include la posizione e il formato dei dati di Amazon S3.

  • OutputOptions: configurazione di output che include il formato di destinazione e risultato di Amazon S3.

  • ActionOptions: funzionalità aggiuntive opzionali richieste per il lavoro, ad esempio Position oCountrySpecificAttributes.

Informazioni sull'errore

In caso di errore di un processo, la risposta include dettagli sull'errore per facilitare la diagnosi e la risoluzione del problema.

  • Error: Un JobError oggetto contenente dettagli sull'errore. Questo oggetto include i seguenti campi:

    • Code: codice di errore che identifica il tipo di errore.

    • Messages: un elenco di messaggi leggibili dall'uomo che forniscono un contesto aggiuntivo per la risoluzione dei problemi.