요청 헤더

리전 ID

REGION_ID는 앱을 만들 때 선택한 리전을 기준으로 Google에서 할당하는 축약된 코드입니다. 일부 리전 ID는 일반적으로 사용되는 국가 및 주/도 코드와 비슷하게 표시될 수 있지만 코드는 국가 또는 주/도와 일치하지 않습니다. 2020년 2월 이후에 생성된 앱의 경우 REGION_ID.r이 App Engine URL에 포함됩니다. 이 날짜 이전에 만든 기존 앱의 경우 URL에서 리전 ID는 선택사항입니다.

리전 ID에 대해 자세히 알아보세요.

이 참조 페이지에서는 지원되는 HTTP 헤더에 대한 자세한 내용을 확인할 수 있습니다. App Engine이 요청을 수신하고 응답을 전송하는 방법은 요청 처리 방법을 참조하세요.

요청 헤더

수신되는 HTTP 요청에는 클라이언트가 전송한 HTTP 헤더가 포함되어 있습니다. 보안을 위해 일부 헤더는 애플리케이션에 도달하기 전에 중간 프록시에 의해 제거, 수정 또는 삭제됩니다.

수신 요청에서 헤더가 삭제됨

클라이언트가 헤더를 보내면 다음 헤더는 수신 요청에서 삭제됩니다.

헤더의 이름이 X-Google-* 패턴과 일치합니다. 이 이름 패턴은 Google에 예약되어 있습니다.
헤더의 이름이 App Engine 관련 헤더와 일치합니다. 대소문자를 구분하지 않는 일치 항목만 삭제됩니다. 예를 들어 X-Appengine-Country 또는 X-AppEngine-Country라는 헤더는 삭제되지만 X-Appengine-Cntry는 삭제되지 않습니다.

App Engine 관련 헤더

앱에 대한 서비스로서, App Engine은 다음 헤더를 모든 요청에 추가합니다.

X-Appengine-Country

ISO 3166-1 alpha-2 국가 코드로 표시되는 요청이 시작된 국가입니다. App Engine은 클라이언트의 IP 주소로부터 이 코드를 확인합니다. 국가 정보는 WHOIS 데이터베이스에서 파생되지 않습니다. 따라서 WHOIS 데이터베이스의 국가 정보가 포함된 IP 주소가 X-Appengine-Country 헤더에 국가 정보가 없을 가능성이 있습니다. 애플리케이션은 특수 국가 코드 ZZ(알 수 없는 국가)를 처리해야 합니다.

X-Appengine-Region

요청이 시작된 리전의 이름입니다. 이 값은 X -Appengine-Country에 지정된 국가를 기준으로 적용됩니다. 예를 들어 국가가 'US'이고 지역이 'ca'일 때, 'ca'는 캐나다가 아닌 '캘리포니아'를 의미합니다. 유효한 리전 값의 전체 목록은 ISO-3166-2 표준을 참조하세요.

X-Appengine-City

요청이 시작된 도시의 이름입니다. 예를 들어 Mountain View 시의 요청은 헤더 값 mountain view를 가질 수 있습니다. 이 헤더에 유효한 값의 표준 목록은 없습니다. 도시를 확인할 수 없는 경우 헤더 값이 ?으로 설정됩니다.

X-Appengine-CityLatLong

요청이 시작된 도시의 위도 및 경도입니다. 이 문자열은 Mountain View에서의 요청의 경우 '37.386051,-122.083851'과 같이 표시될 수 있습니다. 도시를 확인할 수 없는 경우 헤더 값이 0.000000,0.000000으로 설정됩니다.

X-Cloud-Trace-Context

Cloud Trace 및 Cloud Logging에 사용된 요청의 고유 식별자입니다. 모든 App Engine 표준 환경 앱이 자동으로 추적되므로 이 헤더를 중지하거나 trace용 샘플링 레이트를 선택할 수 있는 옵션이 없습니다.

X-Forwarded-For: [CLIENT_IP(s)], [global forwarding rule IP]

클라이언트 요청의 경로를 지정할 때 사용된 쉼표로 구분된 IP 주소 목록입니다. 이 목록의 첫 번째 IP는 일반적으로 요청을 만든 클라이언트의 IP입니다. 이후 IP는 애플리케이션 서버에 도달하기 전 요청을 처리하는 데 사용된 프록시 서버에 대한 정보를 제공합니다. 예를 들면 다음과 같습니다.

X-Forwarded-For: clientIp, proxy1Ip, proxy2Ip

X-Forwarded-Proto [http | https]

클라이언트가 애플리케이션에 연결하는 데 사용한 프로토콜을 기반으로 http 또는 https를 표시합니다.

Google Cloud 부하 분산기는 모든 https 연결을 종료한 후 http을 통해 App Engine 인스턴스로 트래픽을 전달합니다. 예를 들어 사용자가 https://PROJECT_ID.REGION_ID.r.appspot.com을 통해 사이트에 대한 액세스를 요청하면 X-Forwarded-Proto 헤더 값은 https가 됩니다.

또한 App Engine은 App Engine에서 내부적으로 사용하는 다음 헤더를 설정할 수 있습니다.

X-Appengine-Https
X-Appengine-User-IP
X-Appengine-Api-Ticket
X-Appengine-Request-Log-Id
X-Appengine-Default-Version-Hostname
X-Appengine-Timeout-Ms