Upgrade

개요

Upgrade 헤더 필드는 클라이언트가 서버에게 우선순위가 내림차순으로 나열된 프로토콜 중 하나로 전환할 것을 요청하는데 사용됩니다.

예를 들어 클라이언트는 전환할 선호 프로토콜(아래는 "example/1"과 "foo/2"인 경우)을 나열하여 다음과 같이 GET 요청을 보낼 수 있습니다.

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

참조: Upgrade를 전송할 때마다 Connection: upgrade를 설정해야 합니다.

서버는 어떤 이유로든 요청을 무시하도록 선택할 수 있으며, 이 경우 200 OK와 같이 업그레이드 헤더가 전송되지 않은 것처럼 응답해야 합니다.

만약 서버가 연결을 업그레이드하기로 결정했으면 반드시 업그레이드해야 합니다.

1. 전환할 프로토콜을 명시하는 Upgrade 헤더와 함께 101 Switching Protocols를 반환합니다.

   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

지시어

쉼표로 구분한 프로토콜 이름 목록 (선택적으로 버전 포함)

하나 이상의 프로토콜 이름과 버전(이름과 버전은 "/"로 구분). 프로토콜은 선호도 기준 내림차순으로 나열합니다.

예제

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