Encabezados de solicitud

ID de región

El REGION_ID es un código abreviado que Google asigna en función de la región que selecciones al crear tu aplicación. El código no corresponde a un país o provincia, aunque algunos IDs de región pueden parecerse a los códigos de país y provincia que se usan habitualmente. En las aplicaciones creadas después de febrero del 2020, REGION_ID.r se incluye en las URLs de App Engine. En las aplicaciones creadas antes de esa fecha, el ID de región es opcional en la URL.

Más información sobre los IDs de región

Consulta esta página de referencia para obtener información sobre los encabezados HTTP admitidos. Para saber cómo recibe solicitudes y envía respuestas App Engine, consulta el artículo Cómo se gestionan las solicitudes.

Encabezados de solicitud

Una solicitud HTTP entrante incluye las cabeceras HTTP enviadas por el cliente. Por motivos de seguridad, los proxies intermedios sanitizan, modifican o eliminan algunos encabezados antes de que lleguen a la aplicación.

Encabezados eliminados de las solicitudes entrantes

Los siguientes encabezados se eliminan de las solicitudes entrantes si un cliente los envía:

  • Encabezados con nombres que coincidan con el patrón X-Google-*. Este patrón de nombre está reservado para Google.

  • Encabezados con nombres que coincidan con los encabezados específicos de App Engine. Solo se eliminan las coincidencias exactas que no distinguen entre mayúsculas y minúsculas. Por ejemplo, se eliminarán los encabezados llamados X-Appengine-Country o X-AppEngine-Country, pero no X-Appengine-Cntry.

Encabezados específicos de App Engine

Como servicio para la aplicación, App Engine añade los siguientes encabezados a todas las solicitudes:

X-Appengine-Country
País desde el que se ha originado la solicitud, como código de país ISO 3166-1 alfa-2. App Engine determina este código a partir de la dirección IP del cliente. Ten en cuenta que la información del país no se obtiene de la base de datos WHOIS. Es posible que una dirección IP con información del país en la base de datos WHOIS no tenga información del país en el encabezado X-Appengine-Country. Tu aplicación debe gestionar el código de país especial ZZ (país desconocido).
X-Appengine-Region
Nombre de la región desde la que se ha originado la solicitud. Este valor solo tiene sentido en el contexto del país indicado en X -Appengine-Country. Por ejemplo, si el país es "US" y la región es "ca", "ca" significa "California", no Canadá. La lista completa de valores de región válidos se encuentra en la norma ISO-3166-2.
X-Appengine-City
Nombre de la ciudad desde la que se ha originado la solicitud. Por ejemplo, una solicitud de la ciudad de Mountain View podría tener el valor de encabezado mountain view. No hay ninguna lista canónica de valores válidos para este encabezado. Si no se puede resolver la ciudad, el valor del encabezado se define como ?.
X-Appengine-CityLatLong
Latitud y longitud de la ciudad desde la que se ha enviado la solicitud. Esta cadena podría ser "37.386051,-122.083851" en una solicitud de Mountain View. Si no se puede determinar la ciudad, el valor del encabezado se define como 0.000000,0.000000.
X-Cloud-Trace-Context
Identificador único de la solicitud que se usa en Cloud Trace y Cloud Logging. No hay ninguna opción para inhabilitar este encabezado ni para elegir la frecuencia de muestreo del rastreo, ya que todas las aplicaciones del entorno estándar de App Engine se rastrean automáticamente.
X-Forwarded-For: [CLIENT_IP(s)], [global forwarding rule IP]

Lista delimitada por comas de las direcciones IP por las que se ha encaminado la solicitud del cliente. La primera IP de esta lista suele ser la del cliente que ha creado la solicitud. Las IPs posteriores proporcionan información sobre los servidores proxy que también gestionaron la solicitud antes de que llegara al servidor de aplicaciones. Por ejemplo:

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

Muestra http o https en función del protocolo que haya usado el cliente para conectarse a tu aplicación.

El balanceador de carga de Google Cloud finaliza todas las conexiones https y, a continuación, reenvía el tráfico a las instancias de App Engine a través de http. Por ejemplo, si un usuario solicita acceso a su sitio a través de https://PROJECT_ID.REGION_ID.r.appspot.com, el valor del encabezado X-Forwarded-Proto es https.

Además, App Engine puede definir los siguientes encabezados, que son para uso interno de 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