Points de terminaison de service mondiaux et régionaux

Cette page décrit les points de terminaison de service mondiaux et régionaux de Spanner, et explique comment les utiliser.

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. Vous pouvez utiliser un point de terminaison de service mondial ou régional pour envoyer des requêtes à Spanner.

Utilisez le point de terminaison mondial si vous n'avez pas d'exigences strictes en matière de restriction régionale. Bien que les données soient stockées dans la région sélectionnée, elles peuvent être traitées en dehors de cette région. Le point de terminaison mondial de Spanner est spanner.googleapis.com. Le point de terminaison d'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 de Spanner garantissent que les données stockées et traitées sont limitées à la configuration d'instance régionale Spanner dans laquelle réside la base de données. Utilisez des points de terminaison régionaux si l'emplacement de vos données doit être limité et contrôlé pour répondre aux exigences réglementaires. Vous ne pouvez pas utiliser un point de terminaison régional pour accéder à des ressources appartenant à une autre configuration d'instance. Vous devez d'abord créer une instance dans la configuration d'instance régionale avant de pouvoir utiliser le point de terminaison régional pour cette configuration d'instance.

Pour connaître les régions que vous pouvez utiliser, consultez la section Régions disponibles pour les points de terminaison régionaux. 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é pour les points de terminaison régionaux

L'avantage d'utiliser un point de terminaison régional Spanner plutôt qu'un point de terminaison mondial est qu'il offre une isolation et une protection régionales pour répondre aux exigences de sécurité, de conformité et réglementaires.

Vous ne pouvez utiliser que les points de terminaison régionaux appartenant à cette configuration d'instance régionale. Par exemple, vous ne pouvez pas utiliser spanner.me-central2.rep.googleapis.com pour traiter les 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 des points de terminaison régionaux

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

Si vous avez des requêtes actives qui utilisent des points de terminaison régionaux sur l'une des ressources d'instance, le déplacement de l'instance a 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.

Convention d'attribution de noms aux points de terminaison régionaux

Les noms des points de terminaison régionaux Spanner suivent la même convention d'attribution de noms que les noms des configurations d'instance régionales. Le point de terminaison régional suit le format spanner.REGION.rep.googleapis.com. Par exemple, le nom de la configuration d'instance régionale et le nom du point de terminaison régional pour Dammam sont tous deux me-central2. Par conséquent, le point de terminaison régional est spanner.me-central2.rep.googleapis.com.

Pour en savoir plus, consultez la section Régions disponibles pour les points de terminaison régionaux.

Spécifier un point de terminaison régional

Vous pouvez spécifier un point de terminaison régional Spanner à l'aide de Google Cloud CLI, de l'API REST ou de requêtes d'API 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://spanner.REGION.rep.googleapis.com/

Indiquez la valeur suivante :

REGION
Région pour laquelle définir un point de terminaison régional. Par exemple, me-central2.

Par exemple, pour configurer le point de terminaison régional sur me-central2, exécutez la commande suivante :

gcloud config set api_endpoint_overrides/spanner https://spanner.me-central2.rep.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 d'API par défaut accède au point de terminaison mondial. Pour utiliser un point de terminaison régional, configurez-le sur l'adresse du point de terminaison régional en utilisant le modèle suivant :

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

Par exemple, si vous souhaitez appliquer des garanties de données dans la configuration d'instance régionale Dammam (me-central2), utilisez :

  https://spanner.me-central2.rep.googleapis.com

Pour en savoir plus, consultez API REST et Régions disponibles pour les points de terminaison régionaux pour plus d'informations.

API RPC

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

spanner.REGION.rep.googleapis.com

Par exemple, si vous souhaitez appliquer des garanties de données dans la configuration d'instance régionale Dammam (me-central2), utilisez :

spanner.me-central2.rep.googleapis.com

Pour en savoir plus, consultez API RPC et Régions disponibles pour les points de terminaison régionaux pour

Régions disponibles pour les points de terminaison régionaux

Les points de terminaison régionaux Spanner sont disponibles dans les régions suivantes :

Nom régional de base Description de la région
Amériques
us-central1 Iowa
us-central2 Oklahoma
us-east1 Caroline du Sud
us-east4 Virginie du Nord
us-east5 Columbus
us-east7 Alabama
us-south1 Dallas
us-west1 Oregon
us-west2 Los Angeles
us-west3 Salt Lake City
us-west4 Las Vegas
us-west8 Phoenix
Moyen-Orient
me-central2 Dammam
Europe
europe-west8 Milan

Restreindre l'utilisation des points de terminaison d'API mondiaux

Pour appliquer l'utilisation de points de terminaison régionaux, utilisez la contrainte de règle d'administration constraints/gcp.restrictEndpointUsage afin de bloquer les requêtes envoyées au point de terminaison d'API mondial. Pour en savoir plus, consultez Restreindre l'utilisation des points de terminaison.

Étape suivante