Points de terminaison régionaux

Cette page décrit les points de terminaison régionaux de Cloud Spanner. Vous pouvez utiliser un point de terminaison de service mondial ou régional pour envoyer des requêtes à Spanner. Utilisez un point de terminaison régional pour appliquer la restriction régionale et garantir que vos données sont stockées et traitées dans la même région.

Un point de terminaison de service est une URL de base qui spécifie l'adresse réseau d'un service d'API. Spanner dispose de points de terminaison mondiaux et régionaux.

Utilisez le point de terminaison mondial si vous n'avez pas d'exigences strictes concernant les restrictions régionales. Bien que les données soient stockées dans la région sélectionnée, dans de rares cas, elles peuvent être traitées en dehors de la région. Le point de terminaison mondial de Spanner est spanner.googleapis.com. Le point de terminaison de l'API par défaut accède au point de terminaison mondial.

Un point de terminaison régional applique des restrictions régionales. Les données sont stockées et traitées dans la même région. Les points de terminaison régionaux pour Spanner garantissent et garantissent que les données stockées et traitées sont limitées à la configuration de l'instance régionale Spanner qui contient la base de données. Utilisez des points de terminaison régionaux si votre emplacement de données doit être restreint et contrôlé pour respecter les exigences réglementaires. Vous ne pouvez pas utiliser un point de terminaison régional pour accéder aux ressources appartenant à une configuration d'instance différente. Vous devez d'abord créer une instance dans la configuration de l'instance régionale avant de pouvoir utiliser le point de terminaison régional pour cette configuration.

Les points de terminaison régionaux de Spanner sont disponibles dans toutes les configurations d'instances régionales. Elles ne sont pas disponibles dans les configurations d'instances multirégionales. Les règles de stockage Spanner sous-jacentes ne changent pas, quel que soit le point de terminaison que vous utilisez.

Sécurité et conformité

L'avantage d'utiliser un point de terminaison régional Spanner sur un point de terminaison mondial est que le point de terminaison régional assure l'isolation et la protection régionales pour répondre aux exigences de sécurité, de conformité et de réglementation.

Vous ne devez utiliser que des points de terminaison régionaux appartenant à cette configuration d'instance régionale. Par exemple, vous ne pouvez pas utiliser us-west1-spanner.googleapis.com pour diffuser des requêtes si l'instance à laquelle vous accédez appartient à la configuration d'instance régionale us-central1. La requête sera rejetée avec une erreur InvalidRegionalRequest.

Limites

Vous ne pouvez pas accéder à la configuration d'une instance multirégionale avec un point de terminaison régional. Vous devez utiliser le point de terminaison mondial pour accéder aux configurations de votre instance multirégionale. Par exemple, si vous disposez d'une instance dans la configuration d'instance multirégionale nam7, qui contient us-central1 comme emplacement d'instance dupliquée, vous ne pouvez pas utiliser le point de terminaison régional us-central1-spanner.googleapis.com pour envoyer des requêtes à votre instance dans nam7.

Si des requêtes actives utilisent des points de terminaison régionaux sur l'une des ressources d'instance, le déplacement de l'instance aura un impact sur toutes les requêtes utilisant le point de terminaison régional, car l'application régionale bloque l'accès aux instances interrégionales. Les requêtes utilisant un point de terminaison mondial ne sont pas affectées.

Sémantique des points finaux régionaux

Les noms des points de terminaison régionaux Spanner suivent la même convention d'attribution de noms que les noms de configuration de l'instance régionale. Le point de terminaison régional suit le format <REGION>-spanner.googleapis.com. Par exemple, le nom de la configuration de l'instance et le nom du point de terminaison régional pour l'Iowa sont tous deux us-central1. Dans ce cas, le point de terminaison régional est us-central1-spanner.googleapis.com. Pour obtenir la liste de toutes les configurations d'instance régionales disponibles, consultez la section Configurations régionales.

Spécifier un point de terminaison régional

Vous pouvez spécifier un point de terminaison régional Spanner qui utilise Google Cloud CLI et les requêtes API REST ou RPC.

gcloud

Pour spécifier un point de terminaison régional et remplacer le point de terminaison mondial, exécutez la commande suivante:

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

Indiquez la valeur suivante :

REGION
Région pour laquelle définir un point de terminaison régional. Par exemple, us-central1 ou europe-west1.

Par exemple, pour configurer le point de terminaison régional en tant que us-central1, exécutez la commande suivante:

gcloud config set api_endpoint_overrides/spanner https://us-central1-spanner.googleapis.com/

Pour reconfigurer un point de terminaison régional sur le point de terminaison mondial, exécutez la commande suivante:

gcloud config unset api_endpoint_overrides/spanner

API REST

Le point de terminaison de l'API par défaut accède au point de terminaison mondial. Pour utiliser un point de terminaison régional, configurez le point de terminaison sur l'adresse du point de terminaison régional en utilisant le modèle suivant:

https://REGION-spanner.googleapis.com

Par exemple, si vous souhaitez appliquer des garanties sur les données dans la configuration d'instance régionale Iowa (us-central1), utilisez:

  https://us-central1-spanner.googleapis.com

Pour en savoir plus, consultez la section API REST.

API RPC

Le point de terminaison de l'API par défaut accède au point de terminaison mondial. Pour utiliser un point de terminaison régional, configurez le point de terminaison sur l'adresse du point de terminaison régional en utilisant le modèle suivant:

REGION-spanner.googleapis.com

Par exemple, si vous souhaitez appliquer des garanties sur les données dans la configuration d'instance régionale Iowa (us-central1), utilisez:

us-central1-spanner.googleapis.com

Pour en savoir plus, consultez la page API RPC.

Étapes suivantes