DELETE

Die DELETE-Methode fordert den Ursprungsserver auf, die Verbindung zwischen der Zielressource und ihrer aktuellen Funktionalität zu entfernen. Im Grunde ähnelt diese Methode dem rm-Befehl in UNIX: Sie drückt eine Löschoperation für die URI-Zuordnung des Ursprungs-Servers aus und nicht die Erwartung, dass die zuvor assoziierten Informationen gelöscht werden.

Wenn die Ziel-Ressource eine oder mehrere aktuelle Repräsentationen hat, können diese vom Ursprungs-Server zerstört werden oder auch nicht, und der assoziierte Speicherplatz kann zurückgewonnen werden oder auch nicht, was ganz von der Art der Ressource und ihrer Implementierung durch den Ursprungs-Server abhängt (was außerhalb des Rahmens dieser Spezifikation liegt). Ebenso können andere Implementierungsaspekte einer Ressource als Ergebnis eines DELETE deaktiviert oder archiviert werden müssen, wie z. B. Datenbank- oder Gateway-Verbindungen. Im Allgemeinen wird davon ausgegangen, dass der Ursprungsserver DELETE nur für Ressourcen zulässt, für die er einen vorgeschriebenen Mechanismus zur Durchführung der Löschung hat.

Relativ wenige Ressourcen erlauben die DELETE-Methode - ihre primäre Verwendung ist für Remote-Authoring-Umgebungen, in denen der Benutzer eine gewisse Kontrolle über die Auswirkungen hat. Zum Beispiel könnte eine Ressource, die zuvor mit einer PUT-Anfrage erstellt oder über das Location-Header-Feld nach einer 201 (Created)-Antwort auf eine POST-Anfrage identifiziert wurde, eine entsprechende DELETE-Anfrage erlauben, um diese Aktionen rückgängig zu machen. Ebenso könnten benutzerdefinierte User-Agent-Implementierungen, die eine Autorenfunktion implementieren, wie z.B. Revisionskontroll-Clients, die HTTP für Remote-Operationen verwenden, DELETE basierend auf der Annahme verwenden, dass der URI-Raum des Servers so gestaltet wurde, dass er einem Versions-Repository entspricht.

Wenn eine DELETE-Methode erfolgreich angewendet wird, SOLLTE der Ursprungsserver einen 202 (Accepted) Statuscode senden, wenn die Aktion wahrscheinlich erfolgreich sein wird, aber noch nicht ausgeführt wurde, einen 204 (No Content) Statuscode, wenn die Aktion ausgeführt wurde und keine weiteren Informationen geliefert werden müssen, oder einen 200 (OK) Statuscode, wenn die Aktion ausgeführt wurde und die Antwortnachricht eine Darstellung enthält, die den Status beschreibt.

Eine Nutzlast innerhalb einer DELETE-Anforderungsnachricht hat keine definierte Semantik; das Senden eines Nutzlastkörpers bei einer DELETE-Anforderung kann dazu führen, dass einige bestehende Implementierungen die Anforderung zurückweisen.

Antworten auf die DELETE-Methode sind nicht cachefähig. Wenn eine DELETE-Anfrage einen Cache durchläuft, der eine oder mehrere gespeicherte Antworten für den effektiven Anfrage-URI hat, werden diese gespeicherten Antworten ungültig gemacht (siehe Abschnitt 4.4 von [RFC7234]).