Upgrade

Der Upgrade-Header kann von Clients verwendet werden, um einen Server einzuladen, zu einem (oder mehreren) der aufgelisteten Protokolle zu wechseln, in absteigender Reihenfolge der Präferenz.

Beispielsweise könnte der Client eine GET-Anfrage wie gezeigt senden und die bevorzugten Protokolle, zu denen gewechselt werden soll, angeben (in diesem Fall „example/1“ und „foo/2“):

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

Der Server kann die Anfrage aus beliebigem Grund ignorieren, in welchem Fall er einfach so antworten sollte, als wäre der Upgrade-Header nicht gesendet worden (zum Beispiel mit einem 200 OK).

Wenn der Server sich entscheidet, die Verbindung zu aktualisieren, muss er:

1. Einen 101 Switching Protocols-Antwortstatus mit einem Upgrade-Header senden, der das oder die Protokolle angibt, zu denen gewechselt wird. Zum Beispiel:

   http

   HTTP/1.1 101 Switching Protocols
   Upgrade: foo/2
   Connection: Upgrade
   

2. Eine Antwort auf die ursprüngliche Anfrage unter Verwendung des neuen Protokolls senden (der Server darf nur zu einem Protokoll wechseln, mit dem er die ursprüngliche Anfrage abschließen kann).

Ein Server kann den Header auch als Teil einer 426 Upgrade Required-Antwort senden, um anzuzeigen, dass der Server die Anfrage mit dem aktuellen Protokoll nicht ausführen wird, dies jedoch möglicherweise tut, wenn das Protokoll geändert wird. Der Client kann dann einen Protokollwechsel mit dem oben beschriebenen Prozess anfordern.

Weitere Details und Beispiele finden Sie im Thema Protokoll-Upgrade-Mechanismus.

Connection: upgrade
Upgrade: protocol_name[/protocol_version]

Anmerkungen:

• Der Connection-Header mit dem Typ upgrade muss immer zusammen mit dem Upgrade-Header gesendet werden (wie oben gezeigt).
• Protokolle werden kommasepariert in absteigender Präferenz aufgelistet. Die Protokollversion ist optional. Zum Beispiel:

Connection: upgrade
Upgrade: a_protocol/1, example, another_protocol/2.2

jede kommaseparierte Liste von Protokollnamen (jeweils mit optionaler Protokollversion)

Ein oder mehrere Protokollnamen mit optionaler Version (durch "/" getrennt). Die Protokolle sind in absteigender Präferenzreihenfolge aufgeführt.

• Protokoll-Upgrade-Mechanismus
• 101 Switching Protocol
• 426 Upgrade Required
• Connection