Ermöglicht das Abrufen von Informationen über die Aufgabe anhand ihrer ID.
Methode:
GET /api/2.0/virtualization/tasks/{ID}
wobei:
{ID}
– Aufgaben-ID (obligatorischer Parameter)
Bei erfolgreichem Abschluss der Anforderung gibt die REST API Informationen zur Aufgabe in der folgenden Form zurück:
<task id="{ID}" created="{Datum und Uhrzeit}" stateChanged="{Datum und Uhrzeit}" changed="{Datum und Uhrzeit}">
<state>{Zustand}</state>
<type>{Typ}</type>
<stage>{Schritt}</stage>
<progress>{Prozent abgeschlossen}</progress>
<result>{Ergebnis}</result>
<!-- Wenn die Aufgabe mit einem Fehler abgeschlossen wurde, wird statt des Ergebnisses eine Fehlermeldung angezeigt. -->
<error>{Fehlermeldung}</error>
</task>
wobei:
{ID}
– ID der Aufgabecreated="{Datum und Uhrzeit}"
– Zeitpunkt der Erstellung der Aufgabe im Format YYYY-MM-DDThh:mm:ssstateChanged="{Datum und Uhrzeit}"
– Zeitpunkt der Zustandsänderung der Aufgabe im Format YYYY-MM-DDThh:mm:sschanged="{Datum und Uhrzeit}"
– Zeitpunkt der Änderung der Aufgabe im Format YYYY-MM-DDThh:mm:ss{Zustand}
– Zustand der Aufgabe{Typ}
– Typ der Aufgabe Beispiel:CreateTenant
– Aufgabe, die beim Vorgang des Erstellens des Mandanten verwendet wirdChangeTenantActivation
– Aufgabe, die bei den Vorgängen zur Aktivierung und Deaktivierung von Mandanten verwendet wirdDeleteTenant
– Aufgabe, die beim Vorgang des Löschens des Mandanten verwendet wirdCreateTenantReport
– Aufgabe, die beim Vorgang zum Erzeugen eines Mandantenschutzberichts verwendet wird{Name}
– Name der Aufgabe{stage}
– Schritt der Aufgabe{Prozent abgeschlossen}
– Fortschritt der Aufgabe in Prozent{Ergebnis}
– Ergebnis der Aufgabe, z. B. Informationen zum erstellten Mandanten oder Berichts-ID{Fehlermeldung}
– Wenn während der Ausführung der Aufgabe ein Fehler auftritt, wird eine Fehlermeldung angezeigtRückgabecodes:
200 (OK)
– Anforderung erfolgreich abgeschlossen.403 (Forbidden)
– Der Zugriff auf die Ressource wird verweigert 404 (Not Found)
– Eine Aufgabe mit der angegebenen ID wurde in der Datenbank des Integrationsservers nicht gefunden.