Accéder aux points de terminaison d'API régionaux

Cette page explique comment utiliser les points de terminaison d'API régionaux (points de terminaison régionaux) dansGoogle Cloud, qui sont disponibles pour la région me-central2 (Arabie saoudite).

Les points de terminaison régionaux offrent des fonctionnalités de résidence des données en transit en acheminant et en diffusant le trafic dans la même régionGoogle Cloud que le client. Lorsqu'un client appelle un service à l'aide d'un point de terminaison régional, la session TLS du client se termine dans la région indiquée dans le nom du point de terminaison. Par conséquent, les points de terminaison régionaux ne doivent être utilisés que pour les charges de travail qui n'ont aucune dépendance en dehors d'une seule région ou juridiction.

Vous pouvez vous connecter via Internet à des points de terminaison régionaux publics. Pour le trafic Internet entrant, ces points de terminaison utilisent le routage au mieux pour maintenir le trafic en transit au niveau de la région (ou de la juridiction), car ils n'utilisent pas le Google Front End (GFE) mondial. Au lieu de cela, elles sont résolues en adresses IP qui ne sont annoncées que sur les points d'appairage les plus proches de la région sélectionnée.

Par exemple, un ingénieur de données travaillant en Arabie saoudite peut configurer son client pour qu'il utilise BigQuery dans la région me-central2 (Dammam) à l'aide du point de terminaison de service régional bigquery.me-central2.rep.googleapis.com. Le trafic est acheminé à l'aide du niveau Standard, et la session TLS de leur client sera interrompue dans me-central2.

Dans ce scénario, l'adresse IP virtuelle publique correspondant au point de terminaison de service régional proviendra d'un préfixe IP annoncé par Google sur les points de peering de la région. Ainsi, si l'utilisateur est connecté à un FAI local en Arabie saoudite, le trafic peut être acheminé dans sa juridiction.

Format des points de terminaison régionaux

Les points de terminaison régionaux utilisent le format suivant :

SERVICE_NAME.REGION.rep.googleapis.com

Les valeurs d'espace réservé sont définies comme suit :

SERVICE_NAME : nom de point de terminaison de service compatible, tel que bigquery.
REGION : une région Google Cloud compatible, telle que me-central2.

L'exemple suivant est un point de terminaison régional complet pour BigQuery :

bigquery.me-central2.rep.googleapis.com

Régions et services compatibles

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

Nom de la région	Emplacement
`me-central2`	Dammam, Royaume d'Arabie saoudite (KSA)

Les points de terminaison régionaux sont compatibles avec les services suivants :

Nom du service	Point de terminaison régional
Artifact Registry	`artifactregistry.me-central2.rep.googleapis.com apt.me-central2.rep.pkg.dev docker.me-central2.rep.pkg.dev go.me-central2.rep.pkg.dev googet.me-central2.rep.pkg.dev kfp.me-central2.rep.pkg.dev maven.me-central2.rep.pkg.dev npm.me-central2.rep.pkg.dev python.me-central2.rep.pkg.dev yum.me-central2.rep.pkg.dev`
BigQuery	`bigquery.me-central2.rep.googleapis.com bigquerydatatransfer.me-central2.rep.googleapis.com bigquerymigration.me-central2.rep.googleapis.com bigqueryreservation.me-central2.rep.googleapis.com bigquerystorage.me-central2.rep.googleapis.com`
Bigtable	`bigtable.me-central2.rep.googleapis.com`
Cloud Key Management Service (Cloud KMS)	`cloudkms.me-central2.rep.googleapis.com`
Cloud Logging	`logging.me-central2.rep.googleapis.com`
Spanner	`spanner.me-central2.rep.googleapis.com`
Cloud Storage	`storage.me-central2.rep.googleapis.com`
Dataflow	`dataflow.me-central2.rep.googleapis.com`
Dataproc	`dataproc.me-central2.rep.googleapis.com`
Pub/Sub	`pubsub.me-central2.rep.googleapis.com`

Configurer un client pour accéder aux points de terminaison régionaux depuis l'Internet public

Pour utiliser des points de terminaison régionaux depuis l'Internet public, vous devez d'abord configurer votre client (tel que la Google Cloud CLI ou une bibliothèque cliente Google Cloud SDK) pour qu'il se connecte à un point de terminaison régional spécifique.

Configurer gcloud CLI

Par défaut, gcloud CLI utilise des points de terminaison de service globaux, tels que bigquery.googleapis.com. Pour utiliser un point de terminaison de service régional, vous devez configurer la gcloud CLI pour qu'elle les utilise en procédant comme suit.

Si un service compatible n'a pas encore été activé, activez-le à l'aide de la commande suivante :
```
gcloud services enable SERVICE_NAME
```
Remplacez SERVICE_NAME par le nom d'un service compatible que vous souhaitez utiliser. Exemple :
```
gcloud services enable cloudkms
```
Pour utiliser un point de terminaison de service régional, vous devez configurer la gcloud CLI à l'aide de la commande gcloud config set api_endpoint_overrides :
```
gcloud config set api_endpoint_overrides/SERVICE_NAME REGIONAL_API_URL
```
Remplacez les valeurs suivantes par les vôtres :
- SERVICE_NAME : nom du service compatible que vous souhaitez utiliser. Par exemple : cloudkms
- REGIONAL_API_URL : URL du point de terminaison spécifique. Exemple :
```
https://SERVICE_NAME.REGION_NAME.rep.googleapis.com/SERVICE_NAME/API_VERSION
```
  Remplacez les valeurs suivantes par les vôtres :
  - REGION_NAME : nom de la région Google Cloud requise. Exemple : me-central2
  - API_VERSION : version de l'API du service que vous souhaitez utiliser. Exemple : v1. Remarque : Ce paramètre n'est pas obligatoire pour certains services.
  Voici un exemple de valeur REGIONAL_API_URL :
```
https://cloudkms.me-central2.rep.googleapis.com/cloudkms/v1
```
Voici un exemple de commande gcloud config set api_endpoint_overrides pour Cloud KMS :
```
gcloud config set api_endpoint_overrides/cloudkms https://cloudkms.me-central2.rep.googleapis.com/cloudkms/v1
```

Maintenant que la gcloud CLI a été configurée pour utiliser un point de terminaison de service régional, les commandes futures l'utiliseront par défaut au lieu du point de terminaison de service global.

Configurer les bibliothèques clientes Google Cloud SDK

Par défaut, les bibliothèques clientes Google Cloud SDK utilisent des points de terminaison de service mondiaux, tels que pubsub.googleapis.com. Pour utiliser un point de terminaison de service régional, vous devez configurer les bibliothèques clientes Google Cloud SDK pour qu'elles les utilisent.

Python

Définissez le paramètre api_endpoint dans la classe ClientOptions du package google-api-core :

from google.api_core.client_options import ClientOptions

options = ClientOptions(api_endpoint = "pubsub.me-central2.rep.googleapis.com")
client = pubsub_v1.PublisherClient(client_options=options)

// Alternatively
client = pubsub_v1.PublisherClient(client_options={"api_endpoint": "pubsub.me-central2.rep.googleapis.com")

Java

Utilisez la méthode newBuilder de la classe ImageAnnotatorSettings dans le package com.google.cloud.vision :

ImageAnnotatorSettings settings = ImageAnnotatorSettings.newBuilder()
  .setEndpoint("pubsub.me-central2.rep.googleapis.com")
  .build();
ImageAnnotatorClient client = ImageAnnotatorClient.create(settings);

Go

Utilisez la fonction WithEndpoint dans le package ClientOptions du package api :

client, err := pubsub.NewClient(ctx, projID,
    option.WithEndpoint("pubsub.me-central2.rep.googleapis.com"), // Override endpoint

.NET

Définissez la propriété Endpoint dans la classe ClientBuilder du client dans le package Google.Cloud de la bibliothèque que vous utilisez :

string region = "me-central2";
var client = new DatasetServiceClientBuilder
{
    Endpoint = $"pubsub.{region}.rep.googleapis.com"
}.Build();

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.