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

Objets de travail processus asynchrones

PDF

Active IQ Unified Manager fournit le jobs API qui récupère des informations sur les tâches effectuées lors de l'exécution d'autres API. vous devez savoir comment fonctionne le traitement asynchrone à l'aide de l'objet Job.

Certains appels d'API, en particulier ceux utilisés pour ajouter ou modifier des ressources, peuvent prendre plus de temps que d'autres appels. Unified Manager traite ces demandes de longue durée de manière asynchrone.

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

Après un appel d'API exécuté de manière 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 en tâche d'arrière-plan et continue de s'exécuter après la réponse HTTP initiale au client. La réponse inclut l'objet Job ancrant 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 abouti. Un objet Job peut être 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 pour la tâche, soit un succès, soit un échec :

  • Demande d'interrogation standard : l'état actuel du travail est renvoyé immédiatement.

  • Demande d'interrogation longue : lorsque l'état du travail passe à NORMAL, ERROR, ou PARTIAL_FAILURES.

Étapes d'une requête asynchrone

Vous pouvez utiliser la procédure de haut niveau suivante pour terminer un appel d’API asynchrone :

  1. Émettez l’appel API asynchrone.

  2. Recevez une réponse HTTP 202 indiquant l'acceptation réussie de la demande.

  3. Extraire 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 terminal du travail et récupérez le résultat du travail.