

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
<a name="get-job-api"></a>

L'`GetJob`operazione 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 [GetJob](https://docs.aws.amazon.com/location/latest/APIReference/API_geojobs_GetJob.html)all'API di Amazon Location Service*.

Ad esempio richieste, risposte e comandi CLI per questa API, vedi [Come monitorare l'avanzamento del lavoro](https://docs.aws.amazon.com/location/latest/developerguide/monitoring-job-progress.html).

## Casi d’uso
<a name="get-job-use-cases"></a>
+ **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
<a name="get-job-request-parameters"></a>

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'`StartJob`operazione al momento della creazione del lavoro.

## Comprendi la risposta
<a name="get-job-response-details"></a>

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` o`CountrySpecificAttributes`.

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