Skip to main content
Active IQ Unified Manager
Une version plus récente de ce produit est disponible.
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Comprenez comment Active IQ Unified Manager utilise les objets Job pour le traitement asynchrone

PDF

Active IQ Unified Manager fournit l’ `jobs`API qui récupère des informations sur les tâches exécutées lors de l’utilisation d’autres API. Vous devez comprendre le fonctionnement du traitement asynchrone à l’aide de l’objet Job.

Certains appels d'API, notamment ceux utilisés pour ajouter ou modifier des ressources, peuvent prendre plus de temps à s'exécuter que d'autres appels. Unified Manager traite ces requêtes de longue durée de manière asynchrone.

Requêtes asynchrones décrites à l'aide de l'objet Job

Après un appel API asynchrone, le code de réponse HTTP 202 indique que la requête a été validée et acceptée, mais pas encore terminée. La requête est traitée comme une tâche en arrière-plan qui continue de s'exécuter après la réponse HTTP initiale au client. La réponse inclut l'objet Job associé à la requête, ainsi que son identifiant unique.

Interroger l'objet Job associé à une requête API

L'objet Job renvoyé dans la réponse HTTP contient plusieurs propriétés. Vous pouvez interroger la propriété state pour déterminer si la requête a été complétée avec succès. Un objet Job peut se trouver dans l'un des états suivants :

  • NORMAL

  • WARNING

  • PARTIAL_FAILURES

  • ERROR

Il existe deux techniques que vous pouvez utiliser lors de l'interrogation d'un objet Job pour détecter un état terminal de la tâche, soit la réussite, soit l'échec :

  • Requête d'interrogation standard : l'état actuel de la tâche est renvoyé immédiatement.

  • Requête d'interrogation longue : lorsque l'état de l'emploi passe à NORMAL, ERROR, ou PARTIAL_FAILURES.

Étapes d'une requête asynchrone

Vous pouvez utiliser la procédure générale suivante pour effectuer un appel d'API asynchrone :

  1. Effectuez l'appel API asynchrone.

  2. Recevez une réponse HTTP 202 indiquant l’acceptation réussie de la requête.

  3. Extrayez l'identifiant de l'objet Job du corps de la réponse.

  4. Dans une boucle, attendez que l'objet Job atteigne l'état terminal NORMAL, ERROR, ou PARTIAL_FAILURES.

  5. Vérifiez l'état final du Job et récupérez son résultat.