lightmy.day

冪等

PUT HTTPメソッド

PUTリクエストは対象リソースをリクエストコンテンツで置き換えます。

意味

クライアントは、同封した表現を対象URIに保存するようサーバーに求めます。

よくある用途

既知のリソースを置き換える場合や、既知のURLに書き込む場合にPUTを使います。

確認すべきこと

リクエストが完全な置き換え表現を含んでいること、そして必要に応じて前提条件ヘッダーが誤った上書きを防ぐことを確認します。

リクエスト例

PUT /articles/123 HTTP/1.1
Host: example.com
Content-Type: application/json

{"title":"Updated article"}

プロパティ

安全
いいえ。このメソッドはサーバーの状態を変更できます。
冪等
はい。同じリクエストを繰り返しても、意図された効果は同じになるはずです。
キャッシュ可能
いいえ
リクエストボディ
通常はあり

参考資料

関連するHTTPメソッド

関連するHTTPステータスコード