DiePUT HTTP-Methode erstellt eine neue Ressource oder ersetzt eine Darstellung der Zielressource mit dem Anforderungs-Inhalt.

Der Unterschied zwischenPUT undPOST besteht darin, dassPUTidempotent ist: Das einmalige Aufrufen ist nicht anders, als es mehrmals hintereinander aufzurufen (es gibt keine _Neben_wirkungen).

Syntax

PUT <request-target>["?"<query>] HTTP/1.1

<request-target>

Identifiziert die Zielressource der Anforderung in Kombination mit den imHost Header bereitgestellten Informationen.Dies ist ein absoluter Pfad (z.B./path/to/file.html) bei Anforderungen an einen Ursprung-Server und eine absolute URL bei Anforderungen an Proxys (z.B.http://www.example.com/path/to/file.html).

<query>Optional

Eine optionale Abfragekomponente, der ein Fragezeichen? vorangestellt ist.Häufig verwendet, um Identifikationsinformationen in Form vonkey=value Paaren zu übertragen.

Beispiele

Erfolgreiches Erstellen einer Ressource

Die folgendePUT-Anfrage bittet darum, eine Ressource unterexample.com/new.html mit dem Inhalt<p>New File</p> zu erstellen:

PUT /new.html HTTP/1.1Host: example.comContent-type: text/htmlContent-length: 16<p>New File</p>

Falls die Zielressourcekeine aktuelle Darstellung hat und diePUT-Anfrage erfolgreich eine erstellt, muss der Ursprungsserver eine201 Created Antwort senden:

HTTP/1.1 201 CreatedContent-Location: /new.html

Falls die Zielressourceeine aktuelle Darstellung hat und diese Darstellung erfolgreich mit dem Zustand der Anfrage modifiziert wird, muss der Ursprungsserver entweder eine200 OK oder eine204 No Content senden, um den erfolgreichen Abschluss der Anfrage zu indikieren:

HTTP/1.1 204 No ContentContent-Location: /existing.html

Spezifikationen

Browser-Kompatibilität

Der Browser verwendet diePUT-Methode nicht für benutzerinitiierte Aktionen, daher gilt "Browser-Kompatibilität" nicht.Entwickler können diese Anforderungsmethode mitfetch() festlegen.

Siehe auch

• HTTP-Anfragemethoden
• HTTP-Antwortstatuscodes
• HTTP-Header
• 201 Created,204 No Content Antwortstatus