PUT

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

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

請求是否有主體 是
成功回應是否有主體 可能
安全 (en-US) 否
冪等 (en-US) 是
可緩存 否
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 請求成功創建了一個，那麼原伺服器必須通過發送 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

規範

Specification
HTTP Semantics
# PUT

瀏覽器相容性

BCD tables only load in the browser

參見