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 請求成功建立了一個表示,則源伺服器必須透過傳送 201已建立)響應來通知使用者代理。

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

如果目標資源確實有當前表示,並且該表示根據所包含表示的狀態成功修改,則源伺服器必須傳送 200OK)或 204無內容)響應,以指示請求已成功完成。

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

規範

規範
HTTP 語義
# PUT

瀏覽器相容性

BCD 表格僅在啟用 JavaScript 的瀏覽器中載入。

另請參閱