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'ListJobsoperazione 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 ListJobsall'API di Amazon Location Service.
Ad esempio richieste, risposte e comandi CLI per questa API, vedi Come elencare 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:PendingRunning,Completed,Failed,Cancelling, oCancelled.
-
-
- 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 unaListJobsrisposta 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 nellaListJobsrichiesta 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.
