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.1
Host: example.com

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

http

HTTP/1.1 204 No Content
Date: 2024年9月04日 10:16:04 GMT

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

http

HTTP/1.1 200 OK
Content-Type: text/html; charset=UTF-8
Date: 2024年6月21日 14:18:33 GMT
Content-Length: 1234
<html lang="ja">
 <body>
 <h1>ファイル "file.html" が削除されました。</h1>
 </body>
</html>

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

http

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