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

仕様書

仕様書 題名
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 完全対応 12Firefox 完全対応 ありIE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 ありOpera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり

凡例

完全対応  
完全対応

関連情報