DELETE リクエストメソッド

DELETE は HTTP のメソッドで、サーバーに指定されたリソースを削除するよう依頼します。

DELETE を使用するリクエストは、データの削除にのみ使用すべきであり、本体を含まれてはなりません。

メモ:DELETE リクエストでメッセージの本文を送信すると、意味づけは未定義になります。サーバーによっては、そのリクエストを4XX クライアントエラーレスポンスで拒否することがあります。

リクエストの本文	なし
成功時のレスポンスの本文	可
安全性	なし
べき等性	あり
キャッシュ	不可
HTML フォームでの使用	不可

構文

http

DELETE <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 の組の形で識別情報を保持するために使用されます。

例

リソースの削除に成功

次のリクエストは、サーバーにリソースfile.html を削除するよう依頼します。

http

DELETE /file.html HTTP/1.1Host: example.com

リクエストが成功した場合、いくつかの成功レスポンスステータスコードが返る可能性ががあります。204 No Content レスポンスは、リクエストが成功し、クライアントに追加情報が必要でないということです。

http

HTTP/1.1 204 No ContentDate: Wed, 04 Sep 2024 10:16:04 GMT

200 OK レスポンスは、リクエストが成功したということを意味し、レスポンス本体には結果を記述する表現が含まれます。

http

HTTP/1.1 200 OKContent-Type: text/html; charset=UTF-8Date: Fri, 21 Jun 2024 14:18:33 GMTContent-Length: 1234<html lang="ja">  <body>    <h1>ファイル "file.html" が削除されました。</h1>  </body></html>

202 Accepted レスポンスは、リクエストが受け入れられ、おそらく成功するものの、リソースがサーバーによってまだ削除されていないことを意味します。

http

HTTP/1.1 202 AcceptedDate: Wed, 26 Jun 2024 12:00:00 GMTContent-Type: text/html; charset=UTF-8Content-Length: 1234<html lang="en-US">  <body>    <h1>"file.html" の削除が受け付けられました。</h1>    <p>詳細は<a href="http://example.com/tasks/123/status">状態モニター</a>を参照してください。</p>  </body></html>