Skip to main content
Active IQ Unified Manager
Eine neuere Version dieses Produkts ist erhältlich.
Die deutsche Sprachversion wurde als Serviceleistung für Sie durch maschinelle Übersetzung erstellt. Bei eventuellen Unstimmigkeiten hat die englische Sprachversion Vorrang.

Informationen dazu, wie Active IQ Unified Manager Jobobjekte für die asynchrone Verarbeitung verwendet

Änderungen vorschlagen
PDFs

Active IQ Unified Manager stellt die `jobs`API bereit, die Informationen über die während der Ausführung anderer APIs ausgeführten Jobs abruft. Kenntnisse darüber, wie die asynchrone Verarbeitung mithilfe des Job-Objekts funktioniert, sind erforderlich.

Einige API-Aufrufe, insbesondere solche zum Hinzufügen oder Ändern von Ressourcen, können länger dauern als andere. Unified Manager verarbeitet diese zeitaufwändigen Anfragen asynchron.

Asynchrone Anfragen werden mithilfe des Job-Objekts beschrieben.

Nach einem asynchronen API-Aufruf signalisiert der HTTP-Antwortcode 202, 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 weiterhin ausgeführt wird. Die Antwort enthält das Job-Objekt, das die Anfrage verankert, einschließlich seiner eindeutigen Kennung.

Abfrage des Job-Objekts, das einer API-Anfrage zugeordnet ist

Das in der HTTP-Antwort zurückgegebene Job-Objekt enthält mehrere Eigenschaften. Sie können die Eigenschaft state abfragen, um festzustellen, ob die Anfrage erfolgreich abgeschlossen wurde. Ein Job-Objekt kann sich in einem der folgenden Zustände befinden:

  • 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:

  • Bei einer Standard-Abfrage wird der aktuelle Jobstatus sofort zurückgegeben.

  • Long Polling-Anfrage: Wenn sich der Jobstatus zu NORMAL, ERROR, oder PARTIAL_FAILURES. ändert

Schritte bei einer asynchronen Anfrage

Sie können die folgende allgemeine Vorgehensweise verwenden, um einen asynchronen API-Aufruf durchzuführen:

  1. Führe den asynchronen API-Aufruf aus.

  2. Sie erhalten eine HTTP-Antwort 202, die die erfolgreiche Annahme der Anfrage signalisiert.

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

  4. Innerhalb einer Schleife auf das Erreichen des Endzustands durch das Job-Objekt NORMAL, ERROR, oder PARTIAL_FAILURES. warten

  5. Überprüfung des Endstatus des Jobs und Abruf des Jobergebnisses.