Upgrade

Upgrade ヘッダーフィールドは、クライアントがサーバーに対して、優先度の降順に列挙したプロトコルのうちの 1 つ（以上）に切り替えるよう促すために使用することができます。

例えば、クライアントが下記のような GET リクエストを送信する際に、切り替えるべき推奨プロトコル（この場合は "example/1" および "foo/2"）を列挙することができます。

GET /index.html HTTP/1.1
Host: www.example.com
Connection: upgrade
Upgrade: example/1, foo/2

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

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

1. 101 Switching Protocols レスポンスステータスを返し、そこに切り替え先のプロトコルを示した Upgrade ヘッダーを入れる必要があります。例えば次のようにします。

   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

• プロトコルのアップグレードメカニズム
• 101 Switching Protocol
• 426 Upgrade Required
• Connection