Skip to main content
Active IQ Unified Manager 9.14
La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

Processi asincroni degli oggetti di lavoro

Collaboratori
PDF

Active IQ Unified Manager fornisce l' `jobs`API che recupera le informazioni sui lavori eseguiti durante l'esecuzione di altre API. È necessario conoscere il funzionamento dell'elaborazione asincrona utilizzando l'oggetto lavoro.

Alcune delle chiamate API, in particolare quelle utilizzate per l'aggiunta o la modifica delle risorse, possono richiedere più tempo per il completamento rispetto ad altre chiamate. Unified Manager elabora queste richieste a esecuzione prolungata in modo asincrono.

Richieste asincrone descritte utilizzando l'oggetto Job

Dopo aver effettuato una chiamata API eseguita in modo asincrono, il codice di risposta HTTP 202 indica che la richiesta è stata convalidata e accettata correttamente, ma non ancora completata. La richiesta viene elaborata come attività in background che continua a essere eseguita dopo la risposta HTTP iniziale al client. La risposta include l'oggetto Job che ancora la richiesta, incluso il relativo identificatore univoco.

Esecuzione di query sull'oggetto Job associato a una richiesta API

L'oggetto Job restituito nella risposta HTTP contiene diverse proprietà. È possibile eseguire una query sulla proprietà state per determinare se la richiesta è stata completata correttamente. Un oggetto Job può trovarsi in uno dei seguenti stati:

  • NORMAL

  • WARNING

  • PARTIAL_FAILURES

  • ERROR

Esistono due tecniche che è possibile utilizzare quando si esegue il polling di un oggetto Job per rilevare lo stato di un terminale per l'attività, ovvero riuscito o non riuscito:

  • Richiesta di polling standard: Lo stato corrente del processo viene restituito immediatamente.

  • Richiesta polling lungo: Quando lo stato del lavoro passa a NORMAL, ERROR, o. PARTIAL_FAILURES.

Passaggi in una richiesta asincrona

È possibile utilizzare la seguente procedura di alto livello per completare una chiamata API asincrona:

  1. Eseguire la chiamata API asincrona.

  2. Ricevere una risposta HTTP 202 che indichi la corretta accettazione della richiesta.

  3. Estrarre l'identificatore per l'oggetto Job dal corpo della risposta.

  4. All'interno di un ciclo, attendere che l'oggetto Job raggiunga lo stato terminale NORMAL, ERROR, o. PARTIAL_FAILURES.

  5. Verificare lo stato terminale del lavoro e recuperare il risultato del lavoro.