Points de terminaison de service globaux et régionaux

Cette page décrit les points de terminaison de service globaux 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 globaux et régionaux. Vous pouvez utiliser un point de terminaison de service global ou régional pour envoyer des requêtes à Spanner.

Utilisez le point de terminaison global si vous n'avez pas de restrictions régionales strictes. 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 global de Spanner est spanner.googleapis.com. Le point de terminaison de l'API par défaut accède au point de terminaison global.

Un point de terminaison régional applique les 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 que les données stockées et traitées sont limitées à la configuration d'instance régionale Spanner dans laquelle se trouve 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é afin de respecter les exigences réglementaires. Vous ne pouvez pas utiliser un point de terminaison régional pour accéder aux 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.

Un point de terminaison régional Spanner n'est disponible que dans la configuration d'instance régionale me-central2 de Dammam. 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 par rapport à 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 qui appartiennent à 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 bi-régionale ou multirégionale avec un point de terminaison régional. Vous devez utiliser le point de terminaison global pour accéder à vos configurations d'instance birégionale ou multirégionale. 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 de l'instance, le déplacement de l'instance affecte toutes les requêtes qui utilisent le point de terminaison régional, car l'application des règles régionales bloque l'accès aux instances interrégionales. Les requêtes utilisant un point de terminaison global 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'appellation que les noms de configuration d'instance régionale. 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 me-central2. Par conséquent, le point de terminaison régional est spanner.me-central2.rep.googleapis.com.

Seul me-central2 est disponible en tant que point de terminaison régional.

Spécifier un point de terminaison régional

Vous pouvez spécifier un point de terminaison régional Spanner à l'aide de requêtes API REST, RPC ou Google Cloud CLI.

gcloud

Pour spécifier un point de terminaison régional et remplacer le point de terminaison global, 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 en tant que 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 en point de terminaison global, 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 global. Pour utiliser un point de terminaison régional, configurez-le sur l'adresse du point de terminaison régional à l'aide du 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 la page API REST.

API RPC

Le point de terminaison de l'API par défaut accède au point de terminaison global. Pour utiliser un point de terminaison régional, configurez-le sur l'adresse du point de terminaison régional à l'aide du 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 la section API RPC.

Étape suivante