登録されている HTTP リクエストメソッドを調べられます。何をするメソッドか、どの仕様で定義されているか、安全・冪等かどうかを確認できます。表は基本 9 メソッドと WebDAV・DeltaV・CalDAV 拡張を収録しています。
ブラウザ内でローカルに実行HTTP のリクエストメソッドは、そのリクエストが何をするかを示します。基本となる 9 つのメソッド(GET、HEAD、POST、PUT、DELETE、CONNECT、OPTIONS、TRACE、PATCH)は HTTP 自体で定義され、それ以外は WebDAV・バージョン管理・カレンダーの登録済み拡張と、その後の HTTP 改訂で削除された 2 つのメソッドです。表は IANA の HTTP Method Registry にある全メソッドを、定義している仕様と安全・冪等の別とともに示します。
| メソッド | 定義 | 安全 / 冪等 | 用途 |
|---|---|---|---|
| 基本メソッド | |||
| GET | RFC 9110 §9.3.1 | はい / はい | 対象リソースの表現を取得します。 |
| HEAD | RFC 9110 §9.3.2 | はい / はい | 本文を除いた応答ヘッダーだけを取得します。 |
| POST | RFC 9110 §9.3.3 | いいえ / いいえ | 処理するデータを対象リソースへ送ります。リソースの作成や操作の開始によく使われます。 |
| PUT | RFC 9110 §9.3.4 | いいえ / はい | 対象リソースを作成するか、リクエスト内容で置き換えます。 |
| DELETE | RFC 9110 §9.3.5 | いいえ / はい | 対象リソースを削除します。 |
| CONNECT | RFC 9110 §9.3.6 | いいえ / いいえ | 通常はプロキシ経由で、対象 authority へのトンネルを開きます。 |
| OPTIONS | RFC 9110 §9.3.7 | はい / はい | 対象リソースが対応するメソッドとオプションを問い合わせます。 |
| TRACE | RFC 9110 §9.3.8 | はい / はい | 診断のため、受信したリクエストをそのまま返すようサーバーに求めます。 |
| PATCH | RFC 5789 §2 | いいえ / いいえ | リクエスト内容に書かれた変更を対象リソースに適用します。 |
| WebDAV 拡張 | |||
| PROPFIND | RFC 4918 §9.1 | はい / はい | リソースのプロパティを読み取ります。深さは Depth ヘッダーで指定します。 |
| PROPPATCH | RFC 4918 §9.2 | いいえ / はい | 1 回のリクエストで複数のプロパティを設定または削除します。 |
| MKCOL | RFC 4918 §9.3 | いいえ / はい | WebDAV のフォルダーに相当するコレクションを作成します。 |
| COPY | RFC 4918 §9.8 | いいえ / はい | Destination ヘッダーの URI へリソースをコピーします。 |
| MOVE | RFC 4918 §9.9 | いいえ / はい | Destination ヘッダーの URI へリソースを移動します。 |
| LOCK | RFC 4918 §9.10 | いいえ / いいえ | リソースを書き込みロックし、ロックトークンを返します。 |
| UNLOCK | RFC 4918 §9.11 | いいえ / はい | Lock-Token ヘッダーのトークンでロックを解除します。 |
| ACL | RFC 3744 §8.1 | いいえ / はい | リソースのアクセス制御リストを読み取り、または変更します。 |
| SEARCH | RFC 5323 §2 | はい / はい | コレクションに DASL クエリを実行し、一致したリソースを返します。 |
| MKCALENDAR | RFC 4791 §5.3.1 | いいえ / はい | カレンダーのプロパティを持つカレンダーコレクションを作成します。 |
| BIND | RFC 5842 §4 | いいえ / はい | 既存のリソースを新しいバインディングとしてコレクションに追加します。 |
| UNBIND | RFC 5842 §5 | いいえ / はい | コレクションからバインディングを削除します。 |
| REBIND | RFC 5842 §6 | いいえ / はい | バインディングを別のコレクションへ移動します。 |
| ORDERPATCH | RFC 3648 §7 | いいえ / はい | 順序付きコレクションのメンバーの位置を変更します。 |
| MKREDIRECTREF | RFC 4437 §6 | いいえ / はい | 別の URI を指すリダイレクト参照リソースを作成します。 |
| UPDATEREDIRECTREF | RFC 4437 §7 | いいえ / はい | リダイレクト参照リソースの対象 URI を変更します。 |
| バージョン管理拡張(DeltaV) | |||
| VERSION-CONTROL | RFC 3253 §3.5 | いいえ / はい | リソースをバージョン管理下に置きます。 |
| REPORT | RFC 3253 §3.6 | はい / はい | リソースに関するバージョン・プロパティ・DAV のレポートを要求します。 |
| CHECKOUT | RFC 3253 §8.8 | いいえ / はい | バージョン管理されたリソースを書き込み可能にするか、作業リソースを作成します。 |
| CHECKIN | RFC 3253 §9.4 | いいえ / はい | 変更を新しいバージョンとして保存し、リソースを読み取り専用に戻します。 |
| UNCHECKOUT | RFC 3253 §4.5 | いいえ / はい | チェックアウトを取り消し、未確定の変更を破棄します。 |
| MKWORKSPACE | RFC 3253 §6.3 | いいえ / はい | バージョン管理作業用のワークスペースを作成します。 |
| UPDATE | RFC 3253 §7.1 | いいえ / はい | あるバージョンの変更を別のリソースに適用します。 |
| LABEL | RFC 3253 §8.2 | いいえ / はい | バージョンにラベルを付けたり外したりします。 |
| MERGE | RFC 3253 §11.2 | いいえ / はい | 2 つのバージョン履歴の差分をマージします。 |
| BASELINE-CONTROL | RFC 3253 §12.6 | いいえ / はい | コレクションをベースライン管理されたコレクションにします。 |
| MKACTIVITY | RFC 3253 §13.5 | いいえ / はい | 複数リソースの変更をまとめるアクティビティを作成します。 |
| その他の登録メソッド | |||
| QUERY | RFC 10008 §2 | はい / はい | パラメータをリクエスト内容に置いた、安全で冪等なクエリを送ります。 |
| PRI | RFC 9113 §3.4 | はい / はい | HTTP/2 の接続 preface でのみ、フレームより前に送信されます。 |
| HTTP から削除 | |||
| LINK | RFC 2068 §19.6.1.2 | いいえ / はい | RFC 2068 でリソース間のリンク作成用に定義され、その後の HTTP 改訂で削除されました。 |
| UNLINK | RFC 2068 §19.6.1.3 | いいえ / はい | RFC 2068 でリソース間のリンク削除用に定義され、その後の HTTP 改訂で削除されました。 |
このページは、IETF が管理する IANA の HTTP Method Registry にある全メソッドをまとめたものです。各行にメソッド名、定義している仕様、安全・冪等かどうか、そして何をするメソッドかの一行説明を載せています。
表はページにあらかじめ含まれています。実行時に生成されるものはなく、入力も不要で、読んでいる間にリクエストは送信されません。検索欄はブラウザー内で表を絞り込むだけです。
仕様が読み取り専用と定めているメソッドは「安全」です。レジストリでは GET、HEAD、OPTIONS、TRACE、PROPFIND、REPORT、SEARCH、QUERY、PRI が安全とされています。安全は意図を表すもので、サーバーが加える副作用(ログ、集計、課金など)を禁じるものではありません。
同一のリクエストを繰り返しても 1 回と同じ効果しかないメソッドは「冪等」です。PUT、DELETE とほとんどすべての WebDAV・DeltaV メソッドは冪等ですが、POST、PATCH、CONNECT、LOCK は冪等ではないため、タイムアウト後にクライアントやプロキシが自動で再送してはいけません。
IANA は新しいメソッドが公開されるたびにレジストリを更新しており、この表もそれに従っています。メソッド名、安全・冪等の区分、そして最初に挙げられている仕様を示します。レジストリがさらに仕様を挙げている場合(MKCOL は RFC 5689、PROPFIND と REPORT は RFC 8144 で拡張)、定義している RFC を表示します。
レジストリにないメソッドも存在します。UPnP の SSDP は M-SEARCH を UDP で送り、RFC 2774 は M-GET のような M- 接頭辞の拡張メソッドを定義し、多くの API は独自の動詞を作っています。未知のメソッドにはサーバーが 405 Method Not Allowed を返し、プロキシがそのまま拒否することもあります。
LINK と UNLINK は最初の HTTP/1.1 仕様である RFC 2068 に由来し、その後削除されました。レジストリには草案の参照付きで残っていますが、現在の HTTP 仕様では使われていません。
PRI は接続ごとに 1 回、HTTP/2 の接続 preface でフレームより前に送信されます。レジストリには、リソースではなくサーバー全体を対象とする OPTIONS * のアスタリスク形式も載っています。どちらもリクエストログでは見落としやすい項目です。