Extremos de servicio globales y regionales

En esta página, se describen los extremos de servicio globales y regionales de Spanner y cómo usarlos.

Un extremo de servicio es una URL base que especifica la dirección de la red de un servicio de la API. Spanner tiene extremos globales y regionales. Puedes usar un extremo de servicio global o regional para realizar solicitudes a Spanner.

Usa el extremo global si no tienes requisitos de restricción regional estrictos. Aunque los datos se almacenan dentro de la región seleccionada, pueden procesarse fuera de la región. El extremo global de Spanner es spanner.googleapis.com. El extremo predeterminado de la API accede al extremo global.

Un extremo regional aplica restricciones regionales. Los datos se almacenan y procesan dentro de la misma región. Los extremos regionales para Spanner garantizan que los datos almacenados y procesados estén restringidos a la configuración de instancias regional de Spanner en la que reside la base de datos. Usa extremos regionales si la ubicación de tus datos debe restringirse y controlarse para cumplir con los requisitos reglamentarios. No puedes usar un extremo regional para acceder a los recursos que pertenecen a una configuración de instancia diferente. Debes crear una instancia en la configuración de instancias regional antes de poder usar el extremo regional para esa configuración.

Un extremo regional de Spanner solo está disponible en la configuración de instancia regional me-central2 de Dammam. Las políticas de almacenamiento subyacentes de Spanner no cambian sin importar el extremo que uses.

Seguridad y cumplimiento de los extremos regionales

El beneficio de usar un extremo regional de Spanner en lugar de uno global es que proporciona aislamiento y protección regionales para cumplir con los requisitos regulatorios, de seguridad y de cumplimiento.

Solo puedes usar extremos regionales que pertenezcan a esa configuración de instancia regional. Por ejemplo, no puedes usar spanner.me-central2.rep.googleapis.com para entregar solicitudes si la instancia a la que accedes pertenece a la configuración de instancia regional us-central1. La solicitud se rechazará con un error InvalidRegionalRequest.

Limitaciones de los extremos regionales

No puedes acceder a la configuración de una instancia multirregional con un extremo regional. Debes usar el extremo global para acceder a la configuración de las instancias multirregionales. Por ejemplo, si tienes una instancia en la configuración de instancias multirregional nam7, no puedes usar el extremo regional spanner.us-central1.rep.googleapis.com para enviar solicitudes a tu instancia en nam7.

Si tienes solicitudes activas que usan extremos regionales en cualquiera de los recursos de la instancia, mover la instancia afecta a todas las solicitudes que usen el extremo regional, ya que la aplicación regional bloquea el acceso a instancias entre regiones. Las solicitudes que usan un extremo global no se ven afectadas.

Convención de nombres de extremos regionales

Los nombres de extremos regionales de Spanner siguen la misma convención de nombres que los nombres de configuración de instancias regionales. El extremo regional sigue el formato spanner.<REGION>.rep.googleapis.com. Por ejemplo, tanto el nombre de configuración de la instancia regional como el nombre del extremo regional de Dammam son me-central2. Por lo tanto, el extremo regional es spanner.me-central2.rep.googleapis.com.

Solo me-central2 está disponible como posible extremo regional.

Especifica un extremo regional

Puedes especificar un extremo regional de Spanner mediante las solicitudes a la API de Google Cloud CLI, REST o RPC.

gcloud

Para especificar un extremo regional y anular el global, ejecuta el siguiente comando:

gcloud config set api_endpoint_overrides/spanner https://spanner.REGION.rep.googleapis.com/

Ingresa el siguiente valor:

REGION
La región para la que se configura un extremo regional. Por ejemplo:me-central2

Por ejemplo, para configurar el extremo regional como me-central2, ejecuta el siguiente comando:

gcloud config set api_endpoint_overrides/spanner https://spanner.me-central2.rep.googleapis.com/

Para volver a configurar un extremo regional en el extremo global, ejecuta el siguiente comando:

gcloud config unset api_endpoint_overrides/spanner

API de REST

El extremo de API predeterminado accede al extremo global. Para usar un extremo regional, configúralo en la dirección del extremo regional con el siguiente patrón:

https://spanner.REGION.rep.googleapis.com

Por ejemplo, si deseas aplicar las garantías de datos en la configuración de instancias regional Dammam (me-central2), usa lo siguiente:

  https://spanner.me-central2.rep.googleapis.com

Consulta la API de REST para obtener más información.

API de RPC

El extremo de API predeterminado accede al extremo global. Para usar un extremo regional, configúralo en la dirección del extremo regional con el siguiente patrón:

spanner.REGION.rep.googleapis.com

Por ejemplo, si deseas aplicar las garantías de datos en la configuración de instancias regional Dammam (me-central2), usa lo siguiente:

spanner.me-central2.rep.googleapis.com

Consulta la API de RPC para obtener más información.

¿Qué sigue?