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 red de un servicio de API. Spanner tiene extremos globales y regionales. Puedes usar un extremo de servicio global o regional para realizar solicitudes a Spanner.

Usa el endpoint global si no tienes requisitos de cumplimiento de reglamentaciones relacionados con la ubicación o el procesamiento de datos. El extremo global de Spanner es spanner.googleapis.com. El extremo de API predeterminado accede al extremo global.

Un endpoint regional aplica restricciones regionales. Los datos se almacenan y procesan en la misma región. Los endpoints regionales de Spanner garantizan que los datos almacenados y procesados se restrinjan a la configuración de la instancia regional de Spanner en la que reside la instancia. Los extremos regionales son obligatorios si tus cargas de trabajo deben cumplir con los requisitos reglamentarios de residencia o jurisdiccionales. No puedes usar un extremo regional para acceder a recursos que pertenecen a una configuración de instancia diferente. Primero debes crear una instancia en la configuración de instancia regional antes de poder usar el extremo regional para esa configuración de instancia.

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

Seguridad y cumplimiento para extremos regionales

El beneficio de usar un extremo regional de Spanner en lugar de un extremo global es que el extremo regional proporciona aislamiento y protección regionales para satisfacer los requisitos de seguridad, cumplimiento y reglamentarios.

Solo puedes usar extremos regionales que coincidan con la configuración de la instancia a la que accedes. Por ejemplo, no puedes usar spanner.me-central2.rep.googleapis.com para atender solicitudes si la instancia está configurada con el extremo regional us-central1. Se rechaza la solicitud con un error InvalidRegionalRequest.

Limitaciones de los extremos regionales

No puedes acceder a la configuración de una instancia birregional o multirregional con un endpoint regional. Debes usar el extremo global para acceder a la configuración de tu instancia birregional o multirregional. Por ejemplo, si tienes una instancia en la configuración de instancia 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 instancias, mover la instancia afectará todas las solicitudes que usen el extremo regional, ya que la aplicación de la política regional bloqueará el acceso a las instancias entre regiones. Las solicitudes que usan un extremo global no se ven afectadas.

Convención de nombres de extremos regionales

Los nombres de los extremos regionales de Spanner siguen la misma convención de nomenclatura 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 la configuración de la instancia regional como el nombre del extremo regional para Dammam son me-central2. Por lo tanto, el extremo regional es spanner.me-central2.rep.googleapis.com.

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

Especifica un extremo regional

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

gcloud

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

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

Ingresa el siguiente valor:

REGION
Es la región para la que se establecerá 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 como 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 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

Consulta la API de REST y las regiones disponibles para los extremos regionales 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 garantías de datos en la configuración de la instancia regional Dammam (me-central2), usa lo siguiente:

spanner.me-central2.rep.googleapis.com

Consulta la API de RPC y las regiones disponibles para los extremos regionales para obtener más información.

Regiones disponibles para los extremos regionales

Los extremos 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 Virginia del Norte
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

Restringe el uso del endpoint de API global

Para ayudar a aplicar de manera forzosa el uso de extremos regionales, usa la restricción de políticas de la organización constraints/gcp.restrictEndpointUsage para bloquear las solicitudes al extremo de API global. Para obtener más información, consulta Cómo restringir el uso de extremos.

¿Qué sigue?