PUT
HTTP の PUT
リクエストメソッドは、新しいリソースを作成するか、指定したリソースの表現をリクエストのペイロードで置き換えます。
PUT
と POST
との違いは、PUT
はべき等であり、呼び出し回数が 1 回でも複数回でも同じ効果になる(副作用がない)一方で、 POST
は連続して同じものを実行すると、注文を複数回渡してしまうなどの追加の影響が発生する可能性があります。
構文
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 |
---|
HTTP Semantics # PUT |
ブラウザーの互換性
BCD tables only load in the browser