Skip to main content
Active IQ Unified Manager
Die deutsche Sprachversion wurde als Serviceleistung für Sie durch maschinelle Übersetzung erstellt. Bei eventuellen Unstimmigkeiten hat die englische Sprachversion Vorrang.

Jobobjekte asynchrone Prozesse

PDFs

Active IQ Unified Manager bietet die jobs API, die Informationen zu den Jobs abruft, die während der Ausführung anderer APIs ausgeführt werden. Sie müssen wissen, wie die asynchrone Verarbeitung mithilfe des Job-Objekts funktioniert.

Die Ausführung einiger API-Aufrufe, insbesondere jener zum Hinzufügen oder Ändern von Ressourcen, kann länger dauern als die Ausführung anderer Aufrufe. Unified Manager verarbeitet diese lang andauernden Anfragen asynchron.

Asynchrone Anforderungen, beschrieben mithilfe des Job-Objekts

Nach einem asynchron ausgeführten API-Aufruf zeigt der HTTP-Antwortcode 202 an, dass die Anfrage erfolgreich validiert und akzeptiert, aber noch nicht abgeschlossen wurde. Die Anfrage wird als Hintergrundaufgabe verarbeitet, die nach der ersten HTTP-Antwort an den Client weiterläuft. Die Antwort enthält das Job-Objekt, das die Anfrage verankert, einschließlich seiner eindeutigen Kennung.

Abfragen des mit einer API-Anforderung verknüpften Job-Objekts

Das in der HTTP-Antwort zurückgegebene Job-Objekt enthält mehrere Eigenschaften. Sie können die Statuseigenschaft abfragen, um festzustellen, ob die Anforderung erfolgreich abgeschlossen wurde. Ein Job-Objekt kann einen der folgenden Zustände aufweisen:

  • NORMAL

  • WARNING

  • PARTIAL_FAILURES

  • ERROR

Es gibt zwei Techniken, die Sie beim Abfragen eines Job-Objekts verwenden können, um einen Endzustand für die Aufgabe zu erkennen (entweder Erfolg oder Misserfolg):

  • Standard-Polling-Anfrage: Der aktuelle Jobstatus wird sofort zurückgegeben.

  • Lange Polling-Anforderung: Wenn der Job-Status wechselt zu NORMAL, ERROR, oder PARTIAL_FAILURES.

Schritte in einer asynchronen Anfrage

Sie können das folgende allgemeine Verfahren verwenden, um einen asynchronen API-Aufruf abzuschließen:

  1. Führen Sie den asynchronen API-Aufruf aus.

  2. Erhalten Sie eine HTTP-Antwort 202, die die erfolgreiche Annahme der Anfrage anzeigt.

  3. Extrahieren Sie die Kennung für das Job-Objekt aus dem Antworttext.

  4. Warten Sie innerhalb einer Schleife, bis das Job-Objekt den Endzustand erreicht NORMAL, ERROR, oder PARTIAL_FAILURES.

  5. Überprüfen Sie den Endstatus des Jobs und rufen Sie das Jobergebnis ab.