冪等
PUT HTTPメソッド
PUTリクエストは対象リソースをリクエストコンテンツで置き換えます。
意味
クライアントは、同封した表現を対象URIに保存するようサーバーに求めます。
よくある用途
既知のリソースを置き換える場合や、既知のURLに書き込む場合にPUTを使います。
確認すべきこと
リクエストが完全な置き換え表現を含んでいること、そして必要に応じて前提条件ヘッダーが誤った上書きを防ぐことを確認します。
リクエスト例
PUT /articles/123 HTTP/1.1
Host: example.com
Content-Type: application/json
{"title":"Updated article"}プロパティ
- 安全
- いいえ。このメソッドはサーバーの状態を変更できます。
- 冪等
- はい。同じリクエストを繰り返しても、意図された効果は同じになるはずです。
- キャッシュ可能
- いいえ
- リクエストボディ
- 通常はあり