PUT

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

<request-target>

Identifiziert die Zielressource der Anfrage in Kombination mit den Informationen, die im Host-Header bereitgestellt werden. Dies ist ein absoluter Pfad (z.B. /path/to/file.html) bei Anfragen an einen Ursprungs-Server und eine absolute URL bei Anfragen an Proxies (z.B. http://www.example.com/path/to/file.html).

<query> Optional

Eine optionale Abfragekomponente, die durch ein Fragezeichen ? eingeleitet wird. Wird oft verwendet, um identifizierende Informationen in Form von key=value Paaren zu transportieren.

Die folgende PUT-Anfrage verlangt das Erstellen einer Ressource unter example.com/new.html mit dem Inhalt <p>New File</p>:

PUT /new.html HTTP/1.1
Host: example.com
Content-type: text/html
Content-length: 16

<p>New File</p>

Falls die Zielressource keine aktuelle Repräsentation hat und die PUT-Anfrage erfolgreich eine erstellt, muss der Ursprungs-Server eine 201 Created Antwort senden:

HTTP/1.1 201 Created
Content-Location: /new.html

Falls die Zielressource eine aktuelle Repräsentation hat und diese erfolgreich mit dem Zustand der Anfrage modifiziert wird, muss der Ursprungs-Server entweder eine 200 OK oder eine 204 No Content senden, um den erfolgreichen Abschluss der Anfrage anzuzeigen:

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

Der Browser verwendet die PUT-Methode nicht für durch den Benutzer initiierte Aktionen, daher gilt "Browser-Kompatibilität" nicht. Entwickler können diese Anforderungsmethode mit fetch() festlegen.

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