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à.
# ListJobs
L'`ListJobs`operazione recupera un elenco impaginato di lavori con funzionalità di filtro opzionali. È possibile filtrare in base allo stato del lavoro e controllare il numero di risultati restituiti. L'operazione supporta l'impaginazione tramite i token successivi, consentendo di recuperare elenchi di lavori di grandi dimensioni in modo efficiente.
Per ulteriori informazioni, consulta il *riferimento [ListJobs](https://docs.aws.amazon.com/location/latest/APIReference/API_geojobs_ListJobs.html)all'API di Amazon Location Service*.
Ad esempio richieste, risposte e comandi CLI per questa API, vedi [Come elencare](https://docs.aws.amazon.com/location/latest/developerguide/listing-jobs.html) i lavori.
## Casi d’uso
+ **Gestione dell'inventario dei lavori:** recupera tutti i lavori per controllare la cronologia di elaborazione e monitora l'utilizzo delle risorse durante le operazioni di convalida.
+ **Monitoraggio basato sullo stato:** filtra i lavori in base allo stato per identificare i lavori in corso che richiedono attenzione o i lavori completati pronti per il recupero dei risultati.
+ **Reporting operativo:** genera report sui modelli di esecuzione dei lavori, sulle percentuali di successo e sui volumi di elaborazione per l'analisi aziendale.
+ **Risoluzione dei problemi e debug:** elenca i lavori non riusciti per identificare i modelli negli errori di elaborazione e diagnosticare problemi sistematici.
## Comprendi la richiesta
La `ListJobs` richiesta accetta parametri opzionali per il filtraggio e l'impaginazione. Senza alcun parametro, l'operazione restituisce tutti i lavori con l'impaginazione predefinita.
La richiesta include i seguenti parametri opzionali:
**Opzioni di filtraggio**
Parametri opzionali per restringere l'elenco dei lavori restituiti.
+ `Filter`: Oggetto contenente criteri di filtro.
+ `JobStatus`: filtra i lavori in base al loro stato corrente. Valori validi: `Pending``Running`,`Completed`,`Failed`,`Cancelling`, o`Cancelled`.
**Controlli di impaginazione**
Parametri opzionali per controllare la paginazione dei risultati.
+ `MaxResults`: Numero massimo di lavori da restituire in una singola risposta. Utilizzatelo per controllare le dimensioni della pagina per set di risultati di grandi dimensioni.
+ `NextToken`: token di impaginazione di una `ListJobs` risposta precedente. Includi questo token per recuperare la pagina successiva dei risultati.
## Comprendi la risposta
La `ListJobs` risposta fornisce un elenco impaginato di riepiloghi dei lavori con informazioni sulla configurazione e sullo stato di ciascun lavoro. Usa il token next per recuperare pagine aggiuntive quando sono disponibili più risultati.
La risposta include i seguenti campi:
**Job list**
Serie di riepiloghi delle offerte di lavoro corrispondenti ai criteri di filtro.
+ `Entries`: Serie di riepiloghi delle mansioni, tra cui:
+ `Action`: Azione eseguita dal lavoro.
+ `CreatedAt`: timestamp di creazione del lavoro in formato ISO 8601.
+ `EndedAt`: timestamp di completamento del lavoro in formato ISO 8601. Disponibile solo per i lavori negli stati del terminale (Completato, Non riuscito o Annullato).
+ `ExecutionRoleArn`: ruolo IAM utilizzato per l'esecuzione.
+ `InputOptions`: oggetto di configurazione di input.
+ `JobArn`: Amazon Resource Name (ARN) del job.
+ `JobId`: identificatore univoco del lavoro.
+ `Name`: Nome del lavoro, se fornito durante la creazione.
+ `OutputOptions`: oggetto di configurazione di output.
+ `Status`: stato attuale del lavoro.
+ `UpdatedAt`: timestamp dell'ultimo aggiornamento in formato ISO 8601.
+ `ActionOptions`: Eventuali funzionalità aggiuntive richieste.
**Token di impaginazione**
Token per il recupero di risultati aggiuntivi.
+ `NextToken`: Token da includere nella `ListJobs` richiesta successiva per recuperare la pagina successiva di risultati. Questo campo è presente solo quando sono disponibili più risultati. L'assenza di questo campo indica che hai recuperato l'ultima pagina.
**Nota**
I risultati mantengono un ordine coerente tra le pagine. Utilizza i `NextToken` dati di ogni risposta nelle richieste successive per scorrere tutte le pagine dei risultati.