Antwortcodes

Wenn Sie eine der REST-API-Ressourcen für Identitätsdomains aufrufen, gibt der Antwortheader einen der Standard-HTTP-Statuscodes zurück.

Weitere Informationen finden Sie im Abschnitt Statuscodedefinitionen des Hypertext Transfer Protocol -- HTTP/1.1.

HTTP-Statuscode

Beschreibung

200 OK Die Anforderung wurde erfolgreich abgeschlossen. Ein 200-Status wird für eine erfolgreiche GET-Methode zurückgegeben.
201 Created Die Anforderung wurde erfüllt und hat zum Erstellen einer neuen Ressource geführt. Die Antwort enthält einen Location-Header mit der kanonischen URI für die neu erstellte Ressource.

Ein 201-Status wird von einer synchronen Ressourcenerstellung oder einer asynchronen Ressourcenerstellung zurückgegeben, die abgeschlossen wurde, bevor die Antwort zurückgegeben wurde.

202 Accepted Die Anforderung wurde zur Bearbeitung akzeptiert, die Verarbeitung wurde jedoch noch nicht abgeschlossen. Die Anforderung kann oder wird möglicherweise nicht bearbeitet, da sie möglicherweise zum Zeitpunkt der tatsächlichen Verarbeitung nicht zulässig ist.

Wenn Sie eine asynchrone (__detached=true)-Ressourcenerstellung angeben (z.B. beim Deployment einer Anwendung) oder eine Aktualisierung (z.B. beim erneuten Deployment einer Anwendung), wird eine 202 zurückgegeben, wenn der Vorgang noch ausgeführt wird. Wenn __detached=false, kann ein 202 zurückgegeben werden, wenn der zugrunde liegende Vorgang nicht in einer angemessenen Zeit abgeschlossen wird.

Die Antwort enthält einen Location-Header einer Jobressource, die der Client abfragen muss, um zu bestimmen, wann der Job beendet ist. Gibt auch eine Entity zurück, die den aktuellen Status des Jobs enthält

204 No Content Vorgang erfolgreich, und es ist kein Inhalt zum Senden im Antworttext vorhanden. Wird normalerweise bei erfolgreichem DELETE. gesendet
307 Temporary Redirect Die Anforderung sollte am angegebenen temporären Speicherort wiederholt werden, aber den ursprünglichen Speicherort als permanenten Verweis auf die Ressource verwenden.
308 Permanent Redirect Die Anforderung muss am angegebenen Speicherort wiederholt werden und als permanente Referenz auf die Ressource verwendet werden.
400 Bad Request Die Anforderung konnte nicht verarbeitet werden, weil sie fehlende oder ungültige Informationen enthält (z.B. Validierungsfehler in einem Eingabefeld, fehlender erforderlicher Wert usw.).
401 Unauthorized Die Anforderung ist nicht autorisiert. Die in dieser Anforderung enthaltenen Authentifizierungszugangsdaten fehlen oder sind ungültig.
403 Forbidden Der Anforderungsvorgang wird nicht unterstützt.
404 Not Found Die Anforderung enthält eine Ressourcen-URI, die nicht vorhanden ist.
405 Method Not Allowed Das in der Anforderung (DELETE, GET, POST, PUT) angegebene HTTP-Verb wird für diese Ressource nicht unterstützt, oder für die Methode ist ein Filter erforderlich, der nicht angegeben wurde.
409 Conflict Entweder stimmt die Versionsnummer nicht überein, oder es wurde eine doppelte Ressource angefordert und kann nicht neu erstellt werden.
412 Precondition Failed Aktualisierung nicht erfolgreich, da Ressource geändert wurde.
413 Request Entity Too Large maxOperations (1000) oder maxPayload (1048576) wurde überschritten.
415 Not Acceptable Der ContentType-Header des Clients ist nicht korrekt (Beispiel: Der Client versucht, die Anforderung in XML zu senden, aber die Ressource kann nur JSON akzeptieren).
500 Internal Server Error Server ist auf eine unerwartete Bedingung gestoßen, die die Ausführung der Anforderung verhindert hat.
501 Not Implemented Der angeforderte Vorgang wird nicht unterstützt.
503 Service Unavailable Der Server ist aufgrund einer vorübergehenden Überlastung oder Wartung des Servers nicht in der Lage, die Anforderung zu verarbeiten. Die REST-Webanwendung für Identitätsdomains wird derzeit nicht ausgeführt.