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 extremo global si no tienes requisitos estrictos de restricción regional. Si bien los datos se almacenan en la región seleccionada, es posible que se procesen fuera de ella. El extremo global de Spanner es spanner.googleapis.com
. El extremo de API predeterminado accede al extremo global.
Un extremo regional aplica restricciones regionales. Los datos se almacenan y procesan en la misma región. Los extremos 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 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 recursos que pertenecen a una configuración de instancia diferente. Primero debes crear una instancia en la configuración de instancias regional antes de poder usar el extremo regional para esa configuración de instancias.
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 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 extremos regionales
No puedes acceder a una configuración de instancia birregional o multirregional con un extremo 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 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 extremo de API global
Para ayudar a aplicar el uso de extremos regionales, usa la restricción de política de la organización constraints/gcp.restrictEndpointUsage
para bloquear las solicitudes al extremo de API global. Para obtener más información, consulta Restringe el uso de extremos.
¿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.