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: upgradeUpgrade を送る際に設定する必要があります。

サーバーはどのような理由であろうと、無視することができます。その場合、サーバーは Upgrade ヘッダーが送信されていないかのように応答する必要があります(たとえば 200 OK)。

サーバーが接続をアップグレードすることを決めた場合、次のようにする必要があります。

  1. 101 Switching Protocols レスポンスステータスを返し、そこに切り替え先のプロトコルを示した Upgrade ヘッダーを入れる必要があります。例えば次のようにします。
    http
    HTTP/1.1 101 Switching Protocols
    Upgrade: foo/2
    Connection: Upgrade
    
  2. 元のリクエストに新しいプロトコルを使用してレスポンスを送ります(サーバーは、元のリクエストを完了できるプロトコルにのみ切り替えることができます)。

サーバーは、 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

関連情報