PUT 請求方法

PUT HTTP 方法會建立新資源,或者用請求內容替換目標資源的表示。

PUTPOST 的區別在於 PUT冪等的:呼叫一次與連續呼叫多次的效果相同(沒有副作用)。

請求有正文
成功響應有正文 可能
安全
冪等
可快取
允許在 HTML 表單中使用

語法

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 OK204 No Content 以指示請求成功完成。

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

規範

規範
HTTP 語義
# PUT

瀏覽器相容性

瀏覽器不會將 PUT 方法用於使用者發起的動作,因此“瀏覽器相容性”不適用。開發者可以使用 fetch() 設定此請求方法。

另見