HTTP Status Code 207 Multi-Status

Die Antwort beschreibt über ein XML-Dokument mehrere Status Codes für unabhängig durchgeführte Operationen.

Bedeutung

Als Reaktion auf die Anfrage wurden mehrere Operationen durchgeführt. Das zurückgelieferte Dokument beschreibt die Status Codes dieser einzelnen Operationen.

Spezifikation von `207 Multi-Status`

Der 207 Multi-Status HTTP Status Code übermittelt Informationen über mehrere Resource bei denen auch mehrere Status Codes angemessen wären. Der Standard-Körper einer Multi-Status Antwort in ein text/xml oder application/xml HTTP Entität mit meinem multistatus-Wurzelelement. Weitere Elemente enthalten Status Codes der 200, 300, 400 und 500 Klasse die während des Aufrufs der Methode erzeugt wurden. Die Status Codes der 100 Klasse sollen nicht in einem response XML-Element aufgezeichnet werden.

Auch wenn 207 Multi-Status HTTP Status Code als der Gesamt-Status-Code genutzt wird, so muss der Client doch den Inhalt der einzelnen Antworten untersuchen, um weiterführende Informationen über den Erfolg oder Misserfolg der Methodenausführung zu erhalten. Der 207 Multi-Status HTTP Status Code kann sowohl für Erfolg, teilweisen Erfolg oder auch Misserfolg Situationen genutzt werden.

Das multistatus-Wurzelelement enthält keinen oder mehrere response Elemente in beliebiger Reihenfolge, mit Informationen über eine individuelle Ressource. Jedes der resonse Elemente muss ein href-Element enthalten, um die Ressource zu identifizieren.

Eine Multi-Status Antwort benutzt eine von zwei verschiedenen Formaten für die Repräsentation des Status:

Ein status Element als ein Kind des response Elements zeigt den Status der Methoden Ausführung für die identifizierte Ressource als ganzes an. Einige Methoden-Definitionen bieten Informationen über spezifische Status Codes, auf die Clients vorbereitet sein sollten in einer Antwort anzutreffen. Andererseits müssen Clients in der Lage sein, andere Status Codes zu behandeln, anhand der generischen Regeln, wie sie in Abschnitt 10 von RFC2616 definiert werden.
Für PROPFIND und PROPPATCH wurde das Format um ein propstat-Element anstelle des status-Elements erweitert, welches Informationen über die individuellen Eigenschaften einer Ressource liefern. Dieses Format ist für PROPFIND und PROPPATCH spezifisch und detaillierter in Abschnitt 9.1 und 9.2 von RFC7918 beschrieben.