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 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 hacer solicitudes a Spanner.
Usa el extremo global si no tienes requisitos estrictos de restricción regional. Aunque los datos se almacenan dentro de la región seleccionada, los datos se pueden procesar 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 y garantizan que los datos almacenados y procesados estén restringidos a la configuración de la instancia regional de Spanner en la que reside la base de datos. Usa extremos regionales si es necesario restringir y controlar la ubicación de tus datos para cumplir con los requisitos reglamentarios. No puedes usar un extremo regional para acceder a recursos que pertenezcan a una configuración de instancia diferente. Primero, debes crear una instancia en la configuración de instancias regionales antes de poder usar el extremo regional para esa configuración.
Un extremo regional de Spanner solo está disponible en la configuración de instancias regionales de Dammam me-central2
. 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 uno global es que proporciona aislamiento y protección regionales para cumplir con los requisitos normativos, de seguridad y de cumplimiento.
Solo puedes usar extremos regionales que pertenezcan a la configuración de esa 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 birregional o multirregional con un extremo regional. Debes usar el extremo global para acceder a la configuración de instancias birregionales o multirregionales. 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 la instancia, mover la instancia afecta a todas las solicitudes que usan el extremo regional, ya que la aplicación regional bloquea el acceso a las instancias entre regiones. Las solicitudes que usan un extremo global no se ven afectadas.
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 las instancias regionales. El extremo regional sigue el formato spanner.<REGION>.rep.googleapis.com
. Por ejemplo, el nombre de la configuración de la instancia regional y 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 un extremo regional posible.
Especifica un extremo regional
Puedes especificar un extremo regional de Spanner con las solicitudes a 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 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 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 extremo regional, configúralo con la dirección del extremo regional mediante el siguiente patrón:
https://spanner.REGION.rep.googleapis.com
Por ejemplo, si deseas aplicar 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 predeterminado de la API accede al extremo global. Para usar un extremo regional, configúralo con la dirección del extremo regional mediante el siguiente patrón:
spanner.REGION.rep.googleapis.com
Por ejemplo, si deseas aplicar 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?
Obtén más información sobre la configuración de instancias de Spanner.
Obtén más información sobre la API de REST de Spanner y los extremos globales y regionales.
Obtén más información sobre la API de RPC de Spanner y los extremos globales y regionales.