Google Cloud-API-Endpunkt Übersicht

Ein API-Endpunkt oder Dienstendpunkt ist eine URL, die die Netzwerkadresse eines Google Cloud API-Dienstes angibt, z. B. bigquery.googleapis.com. Google Cloud -Dienste ermöglichen den Zugriff auf Ressourcen über verschiedene Arten von API-Endpunkten, darunter regionale, multiregionale, globale und standortbezogene. Die Unterstützung für die einzelnen Endpunkttypen hängt vom Dienst ab.

In diesem Dokument wird jeder Endpunkttyp kurz beschrieben, um die Unterschiede zu verdeutlichen und Hinweise zur Verwendung der einzelnen Endpunkttypen zu geben.

Regionale Endpunkte

Regionale API-Endpunkte ermöglichen den Zugriff auf Google Cloud -Dienste über einen API-Endpunkt, der auf eine einzelne Google Cloud -Region beschränkt ist. Traffic, der an einen regionalen Endpunkt gesendet wird, wird vollständig innerhalb der angegebenen Region verarbeitet und die TLS-Verbindung wird dort beendet.

Für die meisten Google Cloud -Dienste können Sie regionale Endpunkte verwenden, um mit regionalen Ressourcen in der angegebenen Region zu arbeiten. Vorgänge für globale Ressourcen, multiregionale Ressourcen und regionale Ressourcen außerhalb der Region werden in der Regel nicht vom regionalen Endpunkt unterstützt.

Bei regionalen API-Endpunkten wird der Standort als Subdomain angegeben. Öffentliche regionale Endpunkte haben das folgende Format:

SERVICE.REGION.rep.googleapis.com

  • SERVICE: der Name des Google Cloud -Dienstes, z. B. storage, compute oder bigquery.
  • REGION: Der Google Cloud Regionsname, z. B. us-central1 oder europe-west1.

Private regionale API-Endpunkte haben das folgende Format:

SERVICE.REGION.p.rep.googleapis.com

  • SERVICE: der Name des Google Cloud -Dienstes, z. B. storage, compute oder bigquery.
  • REGION: Der Google Cloud Regionsname, z. B. us-central1 oder europe-west1.
  • .p.: Gibt ein privates Ziel für Private Service Connect-Verbindungen an.

Multiregionale Endpunkte

Multiregionale API-Endpunkte ermöglichen den Zugriff auf Google Cloud -Dienste über einen API-Endpunkt, der auf eine Reihe von Google Cloud -Regionen innerhalb desselben Landes (z. B. USA, Indien oder Kanada) oder derselben Gerichtsbarkeit (z. B. Europäische Union) beschränkt ist. Traffic, der an einen multiregionalen Endpunkt gesendet wird, wird vollständig innerhalb der angegebenen Gerichtsbarkeit verarbeitet und die TLS-Verbindung wird dort beendet.

Für die meisten Google Cloud -Dienste können Sie multiregionale Endpunkte verwenden, um mit multiregionalen Ressourcen in der angegebenen multiregionalen Region zu arbeiten. Vorgänge für globale, regionale und multiregionale Ressourcen aus anderen Gerichtsbarkeiten werden in der Regel nicht unterstützt.

Bei multiregionalen API-Endpunkten wird die Gerichtsbarkeit als Subdomain angegeben. Öffentliche multiregionale Endpunkte haben das folgende Format:

SERVICE.MULTIREGION.rep.googleapis.com

  • SERVICE: der Name des Google Cloud -Dienstes, z. B. storage, compute oder bigquery.
  • MULTIREGION: der Name der Google Cloud Multiregion, z. B. us oder eu.

Private multiregionale API-Endpunkte haben das folgende Format:

SERVICE.MULTIREGION.p.rep.googleapis.com

  • SERVICE: der Name des Google Cloud -Dienstes, z. B. storage, compute oder bigquery.
  • MULTIREGION: der Google Cloud Name der Multiregion, z. B. us oder eu.
  • .p.: Gibt ein privates Ziel für Private Service Connect-Verbindungen an.

Globale Endpunkte

Bei globalen API-Endpunkten wird der Standort nicht im URL-Hostnamen angegeben. Diese globalen Endpunkte bieten hochverfügbare Dienstendpunkte, die die TLS-Sitzung so nah wie möglich am Client beenden. Dadurch wird die Latenz beim Bereitstellen von API-Aufrufen von einer verteilten Clientpopulation über das Internet minimiert. Diese Endpunkte bieten jedoch keine regionale Isolation oder Compliance in Bezug auf den Speicherort von Daten.

Für Anwendungen, die globale Abhängigkeiten verarbeiten können und eine schnelle Leistung über das globale Netzwerk von Google benötigen, können Sie globale Endpunkte verwenden.

Globale Endpunkte haben das folgende Format:

SERVICE.googleapis.com

Dabei ist SERVICE der Name des Google Cloud -Dienstes, z. B. storage, compute oder bigquery.

Standortendpunkte

Regionale API-Endpunkte ersetzen standortbezogene Endpunkte. Standortendpunkte sind regionale oder multiregionale Dienst-Hostnamen, mit denen Sie auf Daten an einem bestimmten Standort zugreifen können.

Die folgenden Funktionen werden jedoch nicht von standortbezogenen Endpunkten unterstützt:

  • Datenstandortkonforme Verbindungen aus lokalen Umgebungen über das Internet
  • Isolation von Fehlerdomänen

Bei standortbezogenen Endpunkten wird der Standort im URL-Hostname angegeben. Sie haben das folgende Format:

LOCATION-SERVICE.googleapis.com

  • LOCATION: der Google Cloud Regionsname, z. B. us-central1, europe-west1 oder us.
  • SERVICE: der Name des Google Cloud -Dienstes, z. B. storage, compute oder bigquery.

Referenzdokumentation

Nächste Schritte