Intestazioni delle richieste

ID regione

REGION_ID è un codice abbreviato assegnato da Google in base alla regione selezionata quando crei l'app. Il codice non corrisponde a un paese o a una provincia, anche se alcuni ID regione possono sembrare simili ai codici di paesi e province di uso comune. Per le app create dopo febbraio 2020, REGION_ID.r è incluso negli URL di App Engine. Per le app esistenti create prima di questa data, l'ID regione è facoltativo nell'URL.

Scopri di più sugli ID regione.

Consulta questa pagina di riferimento per informazioni dettagliate sulle intestazioni HTTP supportate. Per comprendere in che modo App Engine riceve richiede e invia risposte, consulta la sezione Come vengono Gestito.

Intestazioni delle richieste

Una richiesta HTTP in arrivo include le intestazioni HTTP inviate dal client. Per motivi di sicurezza, alcune intestazioni vengono sottoposte a sanificazione, modificate o rimosse dai proxy intermedi prima di raggiungere l'applicazione.

Intestazioni rimosse dalle richieste in entrata

Le seguenti intestazioni vengono rimosse dalle richieste in entrata se un client le invia:

  • Intestazioni con nomi corrispondenti al pattern X-Google-*. Questo pattern del nome è riservata a Google.

  • Intestazioni con nomi corrispondenti alle intestazioni specifiche di App Engine. Verranno rimosse solo le corrispondenze esatte senza distinzione tra maiuscole e minuscole. Ad esempio, intestazioni denominate X-Appengine-Country o X-AppEngine-Country verranno rimossi, ma X-Appengine-Cntry no.

Intestazioni specifiche di App Engine

Come servizio per l'app, App Engine aggiunge le seguenti intestazioni a tutte le richieste:

X-Appengine-Country
Paese da cui ha avuto origine la richiesta, come ISO 3166-1 alpha-2, il codice paese. App Engine determina questo codice dall'indirizzo IP del client. Tieni presente che le informazioni sul paese non derivano dal database WHOIS. È possibile che un indirizzo IP con informazioni sul paese nel database WHOIS non abbia informazioni sul paese nell'intestazione X-Appengine-Country. L'applicazione dovrebbe gestire il codice paese speciale ZZ (paese sconosciuto).
X-Appengine-Region
Nome della regione da cui ha avuto origine la richiesta. Questo valore ha senso solo nel contesto del paese in X -Appengine-Country. Ad esempio, se il paese è "US" e la regione è "ca", ovvero "ca" significa "California", non in Canada. L'elenco completo dei valori di regione validi è disponibile nella standard ISO-3166-2.
X-Appengine-City
Nome della città da cui ha avuto origine la richiesta. Ad esempio, una richiesta proveniente dalla città di Mountain View potrebbe avere il valore dell'intestazione mountain view. Non esiste un elenco canonico di valori validi per questa intestazione. Se la città non può essere risolta, il valore dell'intestazione viene impostato su ?.
X-Appengine-CityLatLong
Latitudine e longitudine della città da cui ha avuto origine la richiesta. Questo la stringa potrebbe essere simile a "37.386051,-122.083851" per una richiesta da Mountain View. Se la città non può essere risolta, il valore dell'intestazione è impostato su 0.000000,0.000000.
X-Cloud-Trace-Context
Un identificatore univoco per la richiesta utilizzata per Cloud Trace e Cloud Logging. Non è possibile disattivare questo intestazione o scegliere la frequenza di campionamento per il monitoraggio, poiché tutte le app dell'ambiente standard di App Engine vengono monitorate automaticamente.
X-Forwarded-For: [CLIENT_IP(s)], [global forwarding rule IP]

Un elenco di indirizzi IP, delimitato da virgole, attraverso i quali è stata inviata la richiesta del client. è stato indirizzato. Il primo IP di questo elenco è di solito l'IP del client ha creato la richiesta. Gli IP successivi forniscono informazioni sui server proxy che gestisce la richiesta prima che raggiungesse il server delle applicazioni. Per esempio:

X-Forwarded-For: clientIp, proxy1Ip, proxy2Ip
X-Forwarded-Proto [http | https]

Mostra http o https in base al protocollo utilizzato dal client per connettersi alla tua applicazione.

Il bilanciatore del carico di Google Cloud termina tutte le connessioni https, quindi inoltra il traffico alle istanze App Engine tramite http. Ad esempio, se un utente richiede l'accesso al tuo sito tramite https://PROJECT_ID.REGION_ID.r.appspot.com, il valore dell'intestazione X-Forwarded-Proto è https.

Inoltre, App Engine potrebbe impostare le seguenti intestazioni per uso interno di 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