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

PUT とPOST との違いは、PUT はべき等であり、呼び出し回数が 1 回でも複数回でも同じ効果になる（副作用がない）一方で、POST は連続して同じものを実行すると、注文を複数回渡してしまうなどの追加の影響が発生する可能性があります。

構文

PUT /new.html HTTP/1.1

例

リクエスト

PUT /new.html HTTP/1.1Host: example.comContent-type: text/htmlContent-length: 16<p>New File</p>

レスポンス

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

HTTP/1.1 201 CreatedContent-Location: /new.html

対象リソースに現在の表現が存在し、その表現が内容の表現の状態に従って変更が完了した場合、サーバーは200 (OK) または204 (No Content) の何れかのレスポンスによって、リクエストが正常に完了したことを示します。

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

仕様書

ブラウザーの互換性

関連情報

• 201
• 204