Cabeçalhos de solicitação

ID da região

O REGION_ID é um código abreviado que o Google atribui com base na região que você selecionou ao criar o aplicativo. O código não corresponde a um país ou estado, ainda que alguns IDs de região sejam semelhantes aos códigos de país e estado geralmente usados. Para apps criados após fevereiro de 2020, o REGION_ID.r está incluído nos URLs do App Engine. Para apps existentes criados antes dessa data, o ID da região é opcional no URL.

Saiba mais sobre IDs de região.

Use esta página de referência para consultar detalhes sobre os cabeçalhos HTTP compatíveis. Para entender como o App Engine recebe solicitações e envia respostas, consulte Como as solicitações são processadas.

Cabeçalhos de solicitação

Uma solicitação HTTP recebida inclui os cabeçalhos HTTP enviados pelo cliente. Para fins de segurança, alguns cabeçalhos são limpos, alterados ou removidos por proxies intermediários antes de chegar ao app.

Cabeçalhos removidos de solicitações recebidas

Os seguintes cabeçalhos são removidos das solicitações recebidas se um cliente as enviar:

  • Cabeçalhos com nomes que correspondem ao padrão X-Google-*. Esse padrão de nome é reservado para o Google.

  • Cabeçalhos com nomes que correspondem a cabeçalhos específicos do App Engine. Somente correspondências exatas e indiferentes a maiúsculas são removidas. Por exemplo, os cabeçalhos chamados X-Appengine-Country ou X-AppEngine-Country serão removidos, mas X-Appengine-Cntry, não.

Cabeçalhos específicos do App Engine

Como um serviço ao aplicativo, o App Engine adiciona estes cabeçalhos a todas as solicitações:

X-Appengine-Country
País de origem da solicitação, como um código do país ISO 3166-1 alfa-2. O App Engine determina esse código com base no endereço IP do cliente. Observe que as informações do país não são derivadas do banco de dados WHOIS. É possível que um endereço IP com informações de país no banco de dados WHOIS não tenha informações de país no cabeçalho X-Appengine-Country. O app precisa processar o código especial de país ZZ (país desconhecido).
X-Appengine-Region
Nome da região de origem da solicitação. Esse valor só faz sentido no contexto do país em X -Appengine-Country. Por exemplo, se o país é "US" e a região é "ca", esse "ca" significa "Califórnia", e não Canadá. É possível encontrar a lista completa de valores regionais válidos no padrão ISO-3166-2.
X-Appengine-City
Nome da cidade de origem da solicitação. Por exemplo, uma solicitação da cidade de Mountain View pode ter o valor de cabeçalho mountain view. Não há uma lista canônica de valores válidos para esse cabeçalho. Se não for possível resolver a cidade, o valor do cabeçalho será definido como ?.
X-Appengine-CityLatLong
Latitude e longitude da cidade de origem da solicitação. Essa string pode ser "37.386051, -122.083851" para uma solicitação de Mountain View. Se não for possível resolver a cidade, o valor do cabeçalho será definido como 0.000000,0.000000.
X-Cloud-Trace-Context
Um identificador exclusivo da solicitação usada para o Cloud Trace e o Cloud Logging. Não há a opção de desativar esse cabeçalho ou escolher a taxa de amostragem para rastreamento, porque todos os aplicativos do ambiente padrão do App Engine são rastreados automaticamente.
X-Forwarded-For: [CLIENT_IP(s)], [global forwarding rule IP]

Uma lista delimitada por vírgulas de endereços IP por meio dos quais a solicitação do cliente foi roteada. O primeiro IP da lista geralmente é o IP do cliente que criou a solicitação. Os IPs subsequentes fornecem informações sobre servidores proxy que também processaram a solicitação antes de ela chegar ao servidor do app. 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 se conectar ao app.

O balanceador de carga do Google Cloud encerra todas as conexões de https e, em seguida, encaminha o tráfego para as instâncias do App Engine em http. Por exemplo, se um usuário solicitar acesso ao site por meio de https://PROJECT_ID.REGION_ID.r.appspot.com, o valor do cabeçalho X- Forwarded-Proto será https.

Além disso, o App Engine pode definir os seguintes cabeçalhos para uso interno:

  • 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