HTTP メソッド一覧

登録されている HTTP リクエストメソッドを調べられます。何をするメソッドか、どの仕様で定義されているか、安全・冪等かどうかを確認できます。表は基本 9 メソッドと WebDAV・DeltaV・CalDAV 拡張を収録しています。

ブラウザ内でローカルに実行
メソッド定義安全 / 冪等用途
基本メソッド
GETRFC 9110 §9.3.1はい / はい対象リソースの表現を取得します。
HEADRFC 9110 §9.3.2はい / はい本文を除いた応答ヘッダーだけを取得します。
POSTRFC 9110 §9.3.3いいえ / いいえ処理するデータを対象リソースへ送ります。リソースの作成や操作の開始によく使われます。
PUTRFC 9110 §9.3.4いいえ / はい対象リソースを作成するか、リクエスト内容で置き換えます。
DELETERFC 9110 §9.3.5いいえ / はい対象リソースを削除します。
CONNECTRFC 9110 §9.3.6いいえ / いいえ通常はプロキシ経由で、対象 authority へのトンネルを開きます。
OPTIONSRFC 9110 §9.3.7はい / はい対象リソースが対応するメソッドとオプションを問い合わせます。
TRACERFC 9110 §9.3.8はい / はい診断のため、受信したリクエストをそのまま返すようサーバーに求めます。
PATCHRFC 5789 §2いいえ / いいえリクエスト内容に書かれた変更を対象リソースに適用します。
WebDAV 拡張
PROPFINDRFC 4918 §9.1はい / はいリソースのプロパティを読み取ります。深さは Depth ヘッダーで指定します。
PROPPATCHRFC 4918 §9.2いいえ / はい1 回のリクエストで複数のプロパティを設定または削除します。
MKCOLRFC 4918 §9.3いいえ / はいWebDAV のフォルダーに相当するコレクションを作成します。
COPYRFC 4918 §9.8いいえ / はいDestination ヘッダーの URI へリソースをコピーします。
MOVERFC 4918 §9.9いいえ / はいDestination ヘッダーの URI へリソースを移動します。
LOCKRFC 4918 §9.10いいえ / いいえリソースを書き込みロックし、ロックトークンを返します。
UNLOCKRFC 4918 §9.11いいえ / はいLock-Token ヘッダーのトークンでロックを解除します。
ACLRFC 3744 §8.1いいえ / はいリソースのアクセス制御リストを読み取り、または変更します。
SEARCHRFC 5323 §2はい / はいコレクションに DASL クエリを実行し、一致したリソースを返します。
MKCALENDARRFC 4791 §5.3.1いいえ / はいカレンダーのプロパティを持つカレンダーコレクションを作成します。
BINDRFC 5842 §4いいえ / はい既存のリソースを新しいバインディングとしてコレクションに追加します。
UNBINDRFC 5842 §5いいえ / はいコレクションからバインディングを削除します。
REBINDRFC 5842 §6いいえ / はいバインディングを別のコレクションへ移動します。
ORDERPATCHRFC 3648 §7いいえ / はい順序付きコレクションのメンバーの位置を変更します。
MKREDIRECTREFRFC 4437 §6いいえ / はい別の URI を指すリダイレクト参照リソースを作成します。
UPDATEREDIRECTREFRFC 4437 §7いいえ / はいリダイレクト参照リソースの対象 URI を変更します。
バージョン管理拡張(DeltaV)
VERSION-CONTROLRFC 3253 §3.5いいえ / はいリソースをバージョン管理下に置きます。
REPORTRFC 3253 §3.6はい / はいリソースに関するバージョン・プロパティ・DAV のレポートを要求します。
CHECKOUTRFC 3253 §8.8いいえ / はいバージョン管理されたリソースを書き込み可能にするか、作業リソースを作成します。
CHECKINRFC 3253 §9.4いいえ / はい変更を新しいバージョンとして保存し、リソースを読み取り専用に戻します。
UNCHECKOUTRFC 3253 §4.5いいえ / はいチェックアウトを取り消し、未確定の変更を破棄します。
MKWORKSPACERFC 3253 §6.3いいえ / はいバージョン管理作業用のワークスペースを作成します。
UPDATERFC 3253 §7.1いいえ / はいあるバージョンの変更を別のリソースに適用します。
LABELRFC 3253 §8.2いいえ / はいバージョンにラベルを付けたり外したりします。
MERGERFC 3253 §11.2いいえ / はい2 つのバージョン履歴の差分をマージします。
BASELINE-CONTROLRFC 3253 §12.6いいえ / はいコレクションをベースライン管理されたコレクションにします。
MKACTIVITYRFC 3253 §13.5いいえ / はい複数リソースの変更をまとめるアクティビティを作成します。
その他の登録メソッド
QUERYRFC 10008 §2はい / はいパラメータをリクエスト内容に置いた、安全で冪等なクエリを送ります。
PRIRFC 9113 §3.4はい / はいHTTP/2 の接続 preface でのみ、フレームより前に送信されます。
HTTP から削除
LINKRFC 2068 §19.6.1.2いいえ / はいRFC 2068 でリソース間のリンク作成用に定義され、その後の HTTP 改訂で削除されました。
UNLINKRFC 2068 §19.6.1.3いいえ / はいRFC 2068 でリソース間のリンク削除用に定義され、その後の HTTP 改訂で削除されました。

このメソッド一覧の読み方

このページは、IETF が管理する IANA の HTTP Method Registry にある全メソッドをまとめたものです。各行にメソッド名、定義している仕様、安全・冪等かどうか、そして何をするメソッドかの一行説明を載せています。

表はページにあらかじめ含まれています。実行時に生成されるものはなく、入力も不要で、読んでいる間にリクエストは送信されません。検索欄はブラウザー内で表を絞り込むだけです。

  1. 検索欄にメソッド名の一部、RFC 番号、説明の語を入力すると表を絞り込めます。件数表示で残っている行数がわかります。
  2. 「定義」列で仕様を確認できます。節記号はメソッドを定義している条項を示します(例:GET は RFC 9110 §9.3.1)。
  3. リクエストを再送する前に「安全 / 冪等」列を確認します。安全なメソッドは読み取り専用として定義され、冪等なメソッドは同じ効果のまま再送できます。
  4. 行全体が必要なときは「行をコピー」を、1 つのセルだけなら選択してコピーします。表はリファレンスであり、変換・保存・送信は行いません。

列とレジストリの意味

安全と冪等

仕様が読み取り専用と定めているメソッドは「安全」です。レジストリでは 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 * のアスタリスク形式も載っています。どちらもリクエストログでは見落としやすい項目です。

最近使ったツール: