要求標頭

區域 ID

REGION_ID 是 Google 根據您在建立應用程式時選取的地區所指派的簡寫代碼。雖然某些區域 ID 可能看起來與常用的國家/地區代碼相似，但此代碼並非對應國家/地區或省份。如果是 2020 年 2 月後建立的應用程式，App Engine 網址會包含 REGION_ID.r。如果是在此日期之前建立的現有應用程式，網址中則可選擇加入地區 ID。

進一步瞭解區域 ID。

本參考頁面提供有關系統支援 HTTP 標頭的相關細節。如要瞭解 App Engine 如何接收要求及傳送回應，請參閱要求的處理方式。

要求標頭

傳入 HTTP 要求包含用戶端傳送的 HTTP 標頭。基於安全性考量，部分標頭在送達應用程式之前會由中繼 Proxy 進行處理或修改。

從傳入要求中移除的標頭

如果用戶端傳送下列標頭，系統會從傳入要求中移除這些標頭：

  • 名稱符合 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 要求的專屬 ID。所有 App Engine 標準環境應用程式都會自動追蹤，因此沒有選項可用來停用這個標頭或選擇追蹤的取樣率。
X-Forwarded-For: [CLIENT_IP(s)], [global forwarding rule IP]

轉送用戶端要求的 IP 位址清單 (以逗號分隔)。清單中的第一個 IP 通常是建立要求的用戶端 IP。後續 IP 則會針對在要求送達應用程式伺服器之前，曾處理過該要求的 Proxy 伺服器提供相關資訊。例如：

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