Cabeçalhos do pedido

ID da região

O REGION_ID é um código abreviado que a Google atribui com base na região que seleciona quando cria a sua app. O código não corresponde a um país ou uma província, embora alguns IDs de regiões possam parecer semelhantes aos códigos de países e províncias usados frequentemente. Para apps criadas após fevereiro de 2020, REGION_ID.r está incluído nos URLs do App Engine. Para apps existentes criadas antes desta data, o ID da região é opcional no URL.

Saiba mais acerca dos IDs de regiões.

Use esta página de referência para ver detalhes sobre os cabeçalhos HTTP suportados . Para compreender como o App Engine recebe pedidos e envia respostas, consulte o artigo Como os pedidos são processados.

Cabeçalhos do pedido

Um pedido HTTP de entrada inclui os cabeçalhos HTTP enviados pelo cliente. Por motivos de segurança, alguns cabeçalhos são limpos, alterados ou removidos por proxies intermédios antes de chegarem à aplicação.

Cabeçalhos removidos de pedidos recebidos

Os seguintes cabeçalhos são removidos dos pedidos recebidos se um cliente os enviar:

  • Cabeçalhos com nomes que correspondem ao padrão X-Google-*. Este padrão de nome está reservado para a Google.

  • Cabeçalhos com nomes que correspondem aos cabeçalhos específicos do App Engine. Apenas as correspondências exatas não sensíveis a maiúsculas e minúsculas são removidas. Por exemplo, os cabeçalhos com os nomes X-Appengine-Country ou X-AppEngine-Country são removidos, mas o cabeçalho com o nome X-Appengine-Cntry não é removido.

Cabeçalhos específicos do App Engine

Como um serviço para a app, o App Engine adiciona os seguintes cabeçalhos a todos os pedidos:

X-Appengine-Country
País de origem do pedido, como um código do país da norma ISO 3166-1 alfa-2. O App Engine determina este código a partir do endereço IP do cliente. Tenha em atenção que as informações do país não são derivadas da base de dados WHOIS. É possível que um endereço IP com informações do país na base de dados WHOIS não tenha informações do país no cabeçalho X-Appengine-Country. A sua aplicação deve processar o código de país especial ZZ (país desconhecido).
X-Appengine-Region
Nome da região de origem do pedido. Este valor só faz sentido no contexto do país em X -Appengine-Country. Por exemplo, se o país for "US" e a região for "ca", esse "ca" significa "Califórnia" e não Canadá. A lista completa de valores de regiões válidos encontra-se na norma ISO-3166-2.
X-Appengine-City
Nome da cidade de origem do pedido. Por exemplo, um pedido da cidade de Mountain View pode ter o valor do cabeçalho mountain view. Não existe uma lista canónica de valores válidos para este cabeçalho. Se não for possível resolver a cidade, o valor do cabeçalho é definido como ?.
X-Appengine-CityLatLong
Latitude e longitude da cidade de origem do pedido. Esta string pode ter o seguinte aspeto: "37.386051,-122.083851" para um pedido de Mountain View. Se não for possível resolver a cidade, o valor do cabeçalho é definido como 0.000000,0.000000.
X-Cloud-Trace-Context
Um identificador exclusivo do pedido usado para o Cloud Trace e o Cloud Logging. Não existe uma opção para desativar este cabeçalho nem escolher a taxa de amostragem para o rastreio, uma vez que todas as apps do ambiente padrão do App Engine são rastreadas automaticamente.
X-Forwarded-For: [CLIENT_IP(s)], [global forwarding rule IP]

Uma lista de endereços IP delimitada por vírgulas através dos quais o pedido do cliente foi encaminhado. Geralmente, o primeiro IP nesta lista é o IP do cliente que criou o pedido. Os IPs subsequentes fornecem informações sobre os servidores proxy que também processaram o pedido antes de chegar ao servidor de aplicações. Por exemplo:

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

Mostra http ou https com base no protocolo que o cliente usou para estabelecer ligação à sua aplicação.

O balanceador de carga do Google Cloud termina todas as ligações https e, em seguida, encaminha o tráfego para as instâncias do App Engine através de http. Por exemplo, se um utilizador pedir acesso ao seu site através de https://PROJECT_ID.REGION_ID.r.appspot.com, o valor do cabeçalho X-Forwarded-Proto é https.

Além disso, o App Engine pode definir os seguintes cabeçalhos que são para utilização interna pelo 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