PUT

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

參見