PUT リクエストメソッド

構文

PUT <request-target>["?"<query>] HTTP/1.1

<request-target>

Host ヘッダーで提供される情報と組み合わせたときの、リクエストのターゲットリソースを識別します。 これは元のサーバーへのリクエストにおいては絶対パス（/path/to/file.html など）であり、プロキシーへのリクエストにおいては絶対 URL（http://www.example.com/path/to/file.html など）です。

<query> 省略可

疑問符 ? で始まるオプションのクエリー成分。 多くの場合、key=value の組の形で識別情報を保持するために使用されます。

例

リクエスト

次の PUT リクエストは、example.com/new.html に <p>新しいファイル</p> というコンテンツでリソースを作成するよう要求します。

PUT /new.html HTTP/1.1
Host: example.com
Content-type: text/html
Content-length: 16

<p>新しいファイル</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

仕様書

ブラウザーの互換性

ブラウザーはユーザー主導のアクションにPUTメソッドを使用しないため、「ブラウザー互換性」は適用されません。 開発者は fetch() を使ってこのリクエストメソッドを設定することができます。

関連情報

• HTTP リクエストメソッド
• HTTP レスポンスステータスコード
• HTTP ヘッダー
• 201 Created, 204 No Content レスポンスステータス