語法
http
PUT <request-target>["?"<query>] HTTP/1.1
<請求目標>-
與
Host標頭中提供的資訊結合使用時,標識請求的目標資源。這是對源伺服器的請求中的絕對路徑(例如,/path/to/file.html),以及對代理的請求中的絕對 URL(例如,http://www.example.com/path/to/file.html)。 <query>可選-
一個可選的查詢元件,前面帶有一個問號
?。通常用於以key=value對的形式攜帶識別資訊。
示例
成功建立資源
以下 PUT 請求要求在 example.com/new.html 處建立資源,內容為 <p>New File</p>
http
PUT /new.html HTTP/1.1
Host: example.com
Content-type: text/html
Content-length: 16
<p>New File</p>
如果目標資源沒有當前表示,並且 PUT 請求成功建立了一個,那麼源伺服器必須傳送 201 Created 響應。
http
HTTP/1.1 201 Created
Content-Location: /new.html
如果目標資源有當前表示,並且該表示已成功透過請求中的狀態進行修改,則源伺服器必須傳送 200 OK 或 204 No Content 以指示請求成功完成。
http
HTTP/1.1 204 No Content
Content-Location: /existing.html
規範
| 規範 |
|---|
| HTTP 語義 # PUT |
瀏覽器相容性
瀏覽器不會將 PUT 方法用於使用者發起的動作,因此“瀏覽器相容性”不適用。開發者可以使用 fetch() 設定此請求方法。