PUT

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

HTTP PUT 方法用請求有效負載創建新資源或替換目標資源的表示。

PUTPOST 之間的區別在於 PUT 是幂等的:調用一次或多次連續調用具有相同效果(即沒有作用),而連續相同的 POST 請求可能會產生額外的效果,類似於多次下單。

請求是否有主體
成功回應是否有主體 可能
安全
冪等
可緩存
HTML 表單中是否允許

語法

http
PUT /new.html HTTP/1.1

範例

請求

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

<p>New File</p>

回應

如果目標資源沒有當前表示並且 PUT 請求成功創建了一個,那麼原伺服器必須通過發送 201Created)回應來通知用戶代理。

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

如果目標資源具有當前表示且該表示根據所附表示的狀態成功修改,則原伺服器必須發送 200OK)或 204No Content)回應以指示請求的成功完成。

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

規範

Specification
HTTP Semantics
# PUT

瀏覽器相容性

BCD tables only load in the browser

參見