Upgrade
HTTP 1.1 (専用) の Upgrade
ヘッダーは、すでに確立されたクライアントとサーバー間のプロトコルを、異なるプロトコルに(同じ転送プロトコルを通じて)アップグレードするために使用することができます。例えば、クライアントが HTTP 1.1 から HTTP 2.0 へ、または HTTP や HTTPS のコネクションを WebSocket へアップグレードすることができます。
警告: HTTP/2 は明確にこの仕組み/ヘッダーを使用することを禁止しています。これは HTTP/1.1 専用です。
概要
Upgrade
ヘッダーフィールドは、クライアントがサーバーに対して、優先度の降順に列挙したプロトコルのうちの 1 つ(以上)に切り替えるよう促すために使用することができます。
例えば、クライアントが下記のような GET
リクエストを送信する際に、切り替えるべき推奨プロトコル(この場合は "example/1" および "foo/2")を列挙することができます。
GET /index.html HTTP/1.1 Host: www.example.com Connection: upgrade Upgrade: example/1, foo/2
メモ: Connection: upgrade
は Upgrade
を送る際に設定する必要があります。
サーバーはどのような理由であろうと、無視することができます。その場合、サーバーは Upgrade
ヘッダーが送信されていないかのように応答する必要があります(たとえば 200 OK
)。
サーバーが接続をアップグレードすることを決めた場合、次のようにする必要があります。
-
101 Switching Protocols
レスポンスステータスを返し、そこに切り替え先のプロトコルを示したUpgrade
ヘッダーを入れる必要があります。例えば次のようにします。httpHTTP/1.1 101 Switching Protocols Upgrade: foo/2 Connection: Upgrade
-
元のリクエストに新しいプロトコルを使用してレスポンスを送ります(サーバーは、元のリクエストを完了できるプロトコルにのみ切り替えることができます)。
サーバーは、 426
Upgrade Required
レスポンスの一部としてこのヘッダーを送信することもあります。これはサーバーが現在のプロトコルではリクエストを実行しないが、プロトコルが変更されれば実行するかもしれないことを示すものです。クライアントは上記の手順でプロトコルの変更を要求することができます。
より詳細な情報と例は、プロトコルのアップグレードメカニズムに記載されています。
構文
Connection: upgrade Upgrade: protocol_name[/protocol_version]
メモ:
Connection
ヘッダーで種別をupgrade
に指定することが、Upgrade
ヘッダーを送信する上で常に必要です(前述の通り)。- プロトコルはカンマ区切りで、優先度順に列挙してください。プロトコルのバージョンは省略可能です。例を挙げます。
Connection: upgrade Upgrade: a_protocol/1, example ,another_protocol/2.2
ディレクティブ
- カンマ区切りのプロトコル名のリスト(それぞれに省略可能でプロトコルバージョン)
-
プロトコル名に省略可能で("/" で区切って)バージョンをつけたものを 1 つ以上。プロトコルは優先度の降順で列挙します。
例
Connection: upgrade Upgrade: HTTP/2.0, SHTTP/1.3, IRC/6.9, RTA/x11
Connection: Upgrade Upgrade: websocket
仕様書
Specification |
---|
HTTP Semantics # field.upgrade |
HTTP Semantics # status.426 |
HTTP/2 # informational-responses |
ブラウザーの互換性
BCD tables only load in the browser
関連情報
- プロトコルのアップグレードメカニズム
101
Switching Protocol
426
Upgrade Required
Connection