PUT

HTTP の PUT メソッド は新しいリソースを作成するか、指定したリソースの表現をリクエストしたペイロードに置き換えます。

PUTPOST の違いは、PUT はべき等であり1回または数回連続して呼び出しても同じ効果になります(副作用がありません)。一方で連続して POST した場合は、注文を数回重ねてしまうなどの、追加の効果が発生するかもしれません。

リクエストの本文 あり
成功時のレスポンスの本文 なし
安全性 なし
べき等性 あり
キャッシュ 不可
HTML フォーム での使用 不可

構文

PUT /new.html HTTP/1.1 

リクエスト

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

<p>New File</p>

レスポンス

対象リソースが存在せず PUT リクエストによって正常に作成された場合、サーバーは 201 (Created) をユーザーエージェントに通知します。

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

対象リソースが存在し、正しく要求された内容に従って変更された場合 200 (OK) または 204 (No Content) のいずれかによって、正常に完了したことを応答します。

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

仕様書

Specification Title
RFC 7231, セクション 4.3.4: PUT Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content

ブラウザーの対応

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
PUTChrome 完全対応 ありEdge 完全対応 ありFirefox 完全対応 ありIE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 ありOpera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり

凡例

完全対応  
完全対応

関連情報