Présentation des points de terminaison de l'API Google Cloud

Un point de terminaison d'API, ou point de terminaison de service, est une URL qui spécifie l'adresse réseau d'un Google Cloud service d'API, tel que bigquery.googleapis.com. Google Cloud Les services permettent d'accéder aux ressources à l'aide de différents types de points de terminaison d'API, y compris régionaux, multirégionaux, mondiaux et locaux. La compatibilité avec chaque type de point de terminaison dépend du service.

Ce document décrit brièvement chaque type de point de terminaison pour clarifier leurs différences et vous aider à choisir le type de point de terminaison à utiliser.

Points de terminaison régionaux

Les points de terminaison d'API régionaux permettent d'accéder aux Google Cloud services via un point de terminaison d'API limité à une seule Google Cloud région. Le trafic envoyé à un point de terminaison régional est traité et la session TLS est terminée entièrement dans la région spécifiée.

Pour la plupart des services, vous pouvez utiliser des points de terminaison régionaux pour travailler avec des ressources régionales dans la région spécifiée. Google Cloud Les opérations sur les ressources mondiales, les ressources multirégionales et les ressources régionales hors région ne sont généralement pas compatibles avec le point de terminaison régional.

Les points de terminaison d'API régionaux spécifient l'emplacement en tant que sous-domaine. Les points de terminaison régionaux publics sont au format suivant :

SERVICE.REGION.rep.googleapis.com

  • SERVICE : nom du service, tel que Google Cloud , storage, ou compute.bigquery
  • REGION : nom de la région, tel que us-central1 ou europe-west1. Google Cloud

Les points de terminaison d'API régionaux privés sont au format suivant :

SERVICE.REGION.p.rep.googleapis.com

  • SERVICE : nom du service, tel que Google Cloud , storage, ou compute.bigquery
  • REGION : nom de la région, tel que us-central1 ou europe-west1. Google Cloud
  • .p.: indique une cible privée destinée à la connectivité Private Service Connect.

Points de terminaison multirégionaux

Les points de terminaison d'API multirégionaux permettent d'accéder aux Google Cloud services via un point de terminaison d'API limité à un ensemble de Google Cloud régions d'un même pays (États-Unis, Inde ou Canada, par exemple) ou d'une même juridiction (Union européenne, par exemple) . Le trafic envoyé à un point de terminaison multirégional est traité et la session TLS est terminée entièrement dans la juridiction spécifiée.

Pour la plupart des Google Cloud services, vous pouvez utiliser des points de terminaison multirégionaux pour travailler avec des ressources multirégionales dans la multirégion spécifiée. Les opérations sur les ressources mondiales, les ressources régionales et les ressources multirégionales d'autres juridictions ne sont généralement pas compatibles.

Les points de terminaison d'API multirégionaux spécifient la juridiction en tant que sous-domaine. Les points de terminaison multirégionaux publics sont au format suivant :

SERVICE.MULTIREGION.rep.googleapis.com

  • SERVICE : nom du service, tel que Google Cloud , storage, ou compute.bigquery
  • MULTIREGION : nom de la multirégion, tel que Google Cloud ou eu.us

Les points de terminaison d'API multirégionaux privés sont au format suivant :

SERVICE.MULTIREGION.p.rep.googleapis.com

  • SERVICE : nom du service, tel que Google Cloud , storage, ou compute.bigquery
  • MULTIREGION : nom de la multirégion, tel que us ou eu. Google Cloud
  • .p.: indique une cible privée destinée à la connectivité Private Service Connect.

Points de terminaison mondiaux

Les points de terminaison d'API mondiaux ne spécifient pas l'emplacement dans le nom d'hôte de l'URL. Ces points de terminaison à portée mondiale fournissent des points de terminaison de service à haute disponibilité qui mettent fin à la session TLS aussi près que possible du client, ce qui minimise la latence lors du traitement des appels d'API provenant d'une population de clients dispersée sur Internet. Toutefois, ces points de terminaison ne fournissent aucune isolation régionale ni aucune conformité avec la résidence des données.

Pour les applications qui peuvent gérer les dépendances mondiales et qui ont besoin de performances rapides sur le réseau mondial de Google, vous pouvez utiliser des points de terminaison mondiaux.

Les points de terminaison mondiaux sont au format suivant :

SERVICE.googleapis.com

Où SERVICE est le nom du Google Cloud service, tel que storage, compute, ou bigquery.

Points de terminaison localisés

Les points de terminaison d'API régionaux remplacent les points de terminaison localisés. Les points de terminaison localisés sont des noms d'hôte de service régionaux ou multirégionaux que vous pouvez utiliser pour accéder aux données dans un emplacement donné.

Toutefois, les points de terminaison localisés ne sont pas compatibles avec les fonctionnalités suivantes :

  • Connexions conformes à la résidence des données depuis un environnement sur site via Internet
  • Isolation des domaines de défaillance

Les points de terminaison localisés spécifient l'emplacement dans le nom d'hôte de l'URL et sont au format suivant :

LOCATION-SERVICE.googleapis.com

  • LOCATION: nom de la Google Cloud région, tel que us-central1, europe-west1 ou us.
  • SERVICE : nom du service, tel que Google Cloud , storage, ou compute.bigquery

Documentation de référence

Étape suivante