Skip to main content
Active IQ Unified Manager 9.8
9.8
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.

Auftragsobjekte asynchrone Prozesse

Beitragende
PDFs

Active IQ Unified Manager stellt den bereit jobs API, die Informationen über die während der Ausführung anderer APIs durchgeführten Jobs abruft. Sie müssen wissen, wie die asynchrone Verarbeitung mit dem Job-Objekt funktioniert.

Einige der API-Aufrufe, insbesondere solche, die zum Hinzufügen oder Ändern von Ressourcen verwendet werden, können länger dauern als andere Anrufe. Unified Manager verarbeitet diese langfristigen Anforderungen asynchron.

Asynchrone Anforderungen, die mit Job Object beschrieben werden

Nach einem API-Aufruf, der asynchron ausgeführt wird, weist der HTTP-Antwortcode 202 darauf hin, dass die Anforderung erfolgreich validiert und akzeptiert, aber noch nicht abgeschlossen wurde. Die Anforderung wird als Hintergrundaufgabe verarbeitet, die nach der ersten HTTP-Antwort auf den Client weiter ausgeführt wird. Die Antwort umfasst das Job-Objekt, das die Anfrage einschließlich der eindeutigen Kennung anverankert.

Abfragen des mit einer API-Anforderung verknüpften Jobobjekts

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

  • NORMAL

  • WARNING

  • PARTIAL_FAILURES

  • ERROR

Es gibt zwei Verfahren, die Sie beim Abfragen eines Jobobjekts verwenden können, um einen Terminalstatus für die Aufgabe zu erkennen: Erfolg oder Fehler:

  • Standard-Abfrage: Der aktuelle Job-Status wird sofort zurückgegeben.

  • Lange Abfrage: Wenn der Job-Status zu bewegt NORMAL, ERROR, Oder PARTIAL_FAILURES.

Schritte in einer asynchronen Anforderung

Sie können den folgenden grundlegenden Vorgang verwenden, um einen asynchronen API-Aufruf abzuschließen:

  1. Geben Sie den asynchronen API-Aufruf aus.

  2. Sie erhalten eine HTTP-Antwort 202, die darauf hinweist, dass die Anfrage erfolgreich angenommen wurde.

  3. Extrahieren Sie die Kennung für das Job-Objekt aus dem Antwortkörper.

  4. Warten Sie in einer Schleife, bis das Objekt Job den Terminalstatus erreicht hat NORMAL, ERROR, Oder PARTIAL_FAILURES.

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