Antwortcodes

Wenn Sie eine der REST-API-Ressourcen für Identitätsdomains aufrufen, gibt der Antwortheader einen der HTTP-Standardstatuscodes 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. Für eine erfolgreiche GET-Methode wird der Status 200 zurückgegeben.
201 Created Die Anforderung wurde erfüllt und hat zum Erstellen einer neuen Ressource geführt. Die Antwort enthält einen Speicherortheader mit der kanonischen URI für die neu erstellte Ressource.

Der Status 201 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 Verarbeitung akzeptiert, die Verarbeitung wurde jedoch nicht abgeschlossen. Die Anforderung kann oder kann schließlich nicht bearbeitet werden, da sie möglicherweise zum Zeitpunkt der tatsächlichen Verarbeitung nicht zulässig ist.

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

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

204 No Content Vorgang erfolgreich, und im Antwortbody ist kein Inhalt zum Senden vorhanden. Dies wird normalerweise auf der erfolgreichen DELETE. gesendet.
307 Temporary Redirect Die Anforderung sollte an dem angegebenen temporären Speicherort wiederholt werden. Verwenden Sie jedoch den ursprünglichen Speicherort als permanente Referenz auf die Ressource.
308 Permanent Redirect Die Anforderung sollte an dem angegebenen Ort 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. einen Validierungsfehler in einem Eingabefeld, einen fehlenden erforderlichen 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 nicht vorhandene Ressourcen-URI.
405 Method Not Allowed Das in der Anforderung (DELETE, GET, POST, PUT) angegebene HTTP-Verb wird für diese Ressource nicht unterstützt, oder die Methode erfordert einen Filter, 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, die Ressource kann jedoch nur JSON akzeptieren).
500 Internal Server Error Beim Server ist eine unerwartete Bedingung aufgetreten, die verhindert hat, dass die Anforderung erfüllt werden konnte.
501 Not Implemented Der angeforderte Vorgang wird nicht unterstützt.
503 Service Unavailable Der Server kann die Anforderung nicht verarbeiten, weil der Server vorübergehend überlastet ist oder gewartet wird. Die REST-Webanwendung für Identitätsdomains wird derzeit nicht ausgeführt.