Puntos finales de servicio globales y regionales

En esta página se describen los endpoints de servicio globales y regionales de Spanner, así como su uso.

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

Usa el endpoint global si no tienes requisitos estrictos de restricción regional. Aunque los datos se almacenan en la región seleccionada, es posible que se traten fuera de ella. El endpoint global de Spanner es spanner.googleapis.com. El punto de conexión de la API predeterminado accede al punto de conexión global.

Un endpoint regional aplica restricciones regionales. Los datos se almacenan y procesan en la misma región. Los endpoints regionales de Spanner aseguran y garantizan que los datos almacenados y tratados se limiten a la configuración de la instancia regional de Spanner en la que se encuentra la base de datos. Usa endpoints regionales si la ubicación de tus datos debe estar restringida y controlada para cumplir los requisitos normativos. No puedes usar un endpoint regional para acceder a recursos que pertenezcan a una configuración de instancia diferente. Primero debes crear una instancia en la configuración de la instancia regional para poder usar el endpoint regional de esa configuración.

Para saber qué regiones puedes usar, consulta Regiones disponibles para los endpoints regionales. Las políticas de almacenamiento subyacentes de Spanner no cambian independientemente del endpoint que utilices.

Seguridad y cumplimiento para endpoints regionales

La ventaja de usar un endpoint regional de Spanner en lugar de un endpoint global es que el endpoint regional proporciona aislamiento y protección regionales para cumplir los requisitos de seguridad, cumplimiento y normativos.

Solo puedes usar los endpoints regionales que pertenezcan a esa configuración de instancia regional. Por ejemplo, no puedes usar spanner.me-central2.rep.googleapis.com para atender 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 endpoints regionales

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

Si tienes solicitudes activas que usan endpoints regionales en alguno de los recursos de instancia, mover la instancia afectará a todas las solicitudes que usen el endpoint regional, ya que la aplicación regional bloquea el acceso a las instancias de otras regiones. Las solicitudes que usen un endpoint global no se verán afectadas.

Convención de nomenclatura de los endpoints regionales

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

Para obtener más información, consulta Regiones disponibles para los endpoints regionales.

Especificar un endpoint regional

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

gcloud

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

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

Proporciona el siguiente valor:

REGION
La región para la que se va a definir un endpoint regional. Por ejemplo, me-central2.

Por ejemplo, para configurar el endpoint 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 endpoint regional como endpoint global, ejecuta lo siguiente:

gcloud config unset api_endpoint_overrides/spanner

API REST

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

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

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

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

Para obtener más información, consulta la API REST y las regiones disponibles para los endpoints regionales.

API de RPC

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

spanner.REGION.rep.googleapis.com

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

spanner.me-central2.rep.googleapis.com

Para obtener más información, consulta API RPC y Regiones disponibles para los endpoints regionales.

Regiones disponibles para los endpoints regionales

Los endpoints regionales de Spanner están disponibles en las siguientes regiones:

Nombre regional base Descripción de la región
América
us-central1 Iowa
us-central2 Oklahoma
us-east1 Carolina del Sur
us-east4 Norte de Virginia
us-east5 Columbus
us-east7 Alabama
us-south1 Dallas
us-west1 Oregón
us-west2 Los Ángeles
us-west3 Salt Lake City
us-west4 Las Vegas
us-west8 Phoenix
Oriente Medio
me-central2 Dammam
Europa
europe-west8 Milán

Restringir el uso de endpoints de API globales

Para ayudar a aplicar el uso de endpoints regionales, usa la restricción de la política de organización constraints/gcp.restrictEndpointUsage para bloquear las solicitudes al endpoint de la API global. Para obtener más información, consulta Restringir el uso de endpoints.

Siguientes pasos