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) in Anfragen an einen Ursprungsserver und eine absolute URL in 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 Identifizierungsinformationen in Form von key=value-Paaren zu übertragen.

Die folgende PUT-Anfrage fordert 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>

Wenn 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 Repräsentation erfolgreich mit dem Zustand in 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

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