PUT

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

<request-target>

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

<query> Optional

Eine optionale Abfragekomponente, die von einem Fragezeichen ? eingeleitet wird. Wird häufig verwendet, um identifizierende Informationen in Form von key=value Paaren zu übertragen.

Die folgende PUT-Anfrage fordert an, eine Ressource bei example.com/new.html mit dem Inhalt <p>New File</p> zu erstellen:

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 Ursprungsserver eine 201 Created Antwort senden:

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

Wenn die Zielressource eine aktuelle Repräsentation hat und diese erfolgreich mit dem Zustand der Anfrage modifiziert wird, muss der Ursprungsserver 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 benutzerinitiierte Aktionen, daher gilt "Browser-Kompatibilität" nicht. Entwickler können diese Anfragemethode mit fetch() festlegen.

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