Extremos de servicio globales y regionales

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

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

Usa el extremo global si no tienes una configuración regional estricta restricciones de uso. Aunque los datos se almacenan dentro de la región seleccionada, es posible que los datos se procesen 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 procesados dentro de la misma región. Extremos regionales para Spanner garantizar y garantizar que los datos almacenados y procesados se limiten al Configuración de instancias regional de Spanner donde reside la base de datos. Use extremos regionales si la ubicación de sus datos debe ser restringidas y controladas para cumplir con los requisitos reglamentarios. No puedes usar que un extremo regional acceda a los recursos que pertenecen a una instancia diferente configuración. Primero debes crear una instancia en el directorio de la instancia de Compute Engine antes de que puedas usar el extremo regional para esa la configuración de una instancia de Compute Engine.

Un extremo regional de Spanner solo está disponible en Dammam. me-central2 Configuración de instancias regionales. El enfoque Las políticas de almacenamiento de Spanner no cambian, independientemente de la del extremo que usas.

Seguridad y cumplimiento para extremos regionales

El beneficio de usar un extremo regional de Spanner en lugar de uno global extremo es que el extremo regional proporciona aislamiento regional y para satisfacer los requisitos de seguridad, cumplimiento y reglamentaciones.

Solo puedes usar extremos regionales que pertenezcan a esa instancia regional configuración. Por ejemplo, no puedes usar spanner.me-central2.rep.googleapis.com para entregar solicitudes si la instancia a la que pertenece a la configuración de la 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 birregional o multirregional con un extremo regional. Debes usar el extremo global para acceder de instancias administrados o configuraciones de instancias multirregionales. Por ejemplo, si tienes una instancia en la configuración de la instancia multirregional nam7, no puedes usar el spanner.us-central1.rep.googleapis.com para enviar solicitudes a tu en nam7.

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

Convención de nomenclatura del extremo regional

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 formato spanner.<REGION>.rep.googleapis.com. Por ejemplo, tanto el sistema regional el nombre de la configuración de instancia y el nombre del extremo regional para Dammam me-central2. Por lo tanto, el extremo regional spanner.me-central2.rep.googleapis.com.

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

Especifica un extremo regional

Puedes especificar un extremo regional de Spanner con el Solicitudes de Google Cloud CLI, REST o a la API de RPC.

gcloud

Para especificar un extremo regional y anular el global, ejecuta el comando 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 configura un extremo regional. Por ejemplo:me-central2

Por ejemplo, para configurar el extremo regional como me-central2, ejecuta el comando 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 global, ejecuta el siguiente comando:

gcloud config unset api_endpoint_overrides/spanner

API de REST

El extremo predeterminado de la API accede al extremo global. Para usar un servidor configura el extremo en la dirección del extremo regional mediante el siguiente patrón:

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

Por ejemplo, si quieres aplicar garantías de datos en la instancia regional configuración 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 predeterminado de la API accede al extremo global. Para usar un servidor configura el extremo en la dirección del extremo regional mediante el siguiente patrón:

spanner.REGION.rep.googleapis.com

Por ejemplo, si quieres aplicar garantías de datos en la instancia regional configuración 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?