Regionale Endpunkte konfigurieren

Mit regionalen Endpunkten können Sie Ihre App Hub-Arbeitslasten so ausführen, dass sie den Anforderungen an den Datenstandort und die Datenhoheit entsprechen, wobei Ihr Anfragetraffic direkt an die im Endpunkt angegebene Region weitergeleitet wird.

Was sind regionale Endpunkte?

Regionale Endpunkte sind Anfrageendpunkte, die nur Anfragen zulassen, wenn die betroffene Ressource am vom Endpunkt angegebenen Standort vorhanden ist. Wenn Sie beispielsweise den Endpunkt https://apphub.us-central1.rep.googleapis.com in einer Anfrage zum Verwalten von Ressourcen verwenden, wird die Anfrage nur fortgesetzt, wenn sich die Anwendung oder registrierte Komponente in us-central1 befindet.

Im Gegensatz zu globalen Endpunkten, bei denen Anfragen an einem anderen Standort als dem der Ressource verarbeitet werden können, werden Anfragen bei regionalen Endpunkten nur innerhalb des durch den Endpunkt angegebenen Standorts verarbeitet. Regionale Endpunkte beenden TLS-Sitzungen an dem vom Endpunkt angegebenen Standort für Anfragen aus dem Internet, anderen Google Cloud -Ressourcen wie virtuellen Compute Engine-Maschinen, lokalen Diensten mit VPN oder Interconnect und Virtual Private Clouds (VPCs).

Regionale Endpunkte unterstützen den Datenstandort, indem die Metadaten Ihrer Anwendung sowohl im Ruhezustand als auch bei der Übertragung in der angegebenen Region bleiben.

Beschränkungen

Sie können keine regionalen Endpunkte verwenden, um globale Ressourcen in App Hub zu verwalten, z. B. globale Anwendungen, Perimeter, Dienstprojektanhänge (SPAs) und Grenzen.

API-Anfragen im Zusammenhang mit diesen globalen Ressourcen, die einen regionalen Endpunkt verwenden, schlagen fehl, da diese Anfragen den Standort /global/ im API-Pfad enthalten. Beispielsweise wird die Anfrage GET .../locations/global/applications/globalApp abgelehnt.

Verwenden Sie zum Verwalten globaler Ressourcen den globalen Standardendpunkt https://apphub.googleapis.com.

Unterstützte Standorte

Sie können regionale Endpunkte für alle regionalen Standorte verwenden, an denen App Hub verfügbar ist. Eine Liste der unterstützten Regionen finden Sie unter Standorte.

Tools für die Verwendung regionaler Endpunkte

Sie können die Google Cloud CLI konfigurieren oder direkte REST- oder RPC-API-Anfragen über regionale Endpunkte stellen.

Google Cloud CLI

Führen Sie die folgenden Schritte aus, um die Google Cloud CLI für die Verwendung mit regionalen Endpunkten zu konfigurieren:

  1. Sie benötigen die Google Cloud CLI-Version 402.0.0 oder höher.

  2. Setzen Sie das Attribut api_endpoint_overrides/apphub auf den regionalen Endpunkt, den Sie verwenden möchten:

    gcloud config set api_endpoint_overrides/apphub https://apphub.LOCATION.rep.googleapis.com/

    Ersetzen Sie LOCATION durch eine unterstützte Region, z. B. us-central1.

Alternativ können Sie die Umgebungsvariable CLOUDSDK_API_ENDPOINT_OVERRIDES_APPHUB auf den Endpunkt festlegen:

CLOUDSDK_API_ENDPOINT_OVERRIDES_APPHUB=https://apphub.LOCATION.rep.googleapis.com/
gcloud apphub applications list

REST APIs

Verwenden Sie für Anfragen an regionale Endpunkte den folgenden URI und ersetzen Sie LOCATION durch eine unterstützte Region:

https://apphub.LOCATION.rep.googleapis.com

Sie können beispielsweise den folgenden Endpunkt verwenden, um auf App Hub in der Region us-central1 zuzugreifen:

https://apphub.us-central1.rep.googleapis.com

Terraform

Wenn Sie regionale Endpunkte mit Terraform verwenden möchten, müssen Sie den App Hub-Endpunkt im Google-Anbieterblock überschreiben.

Wenn Sie einen regionalen Endpunkt als benutzerdefinierten Endpunkt festlegen, können Sie Terraform nicht zum Verwalten globaler Ressourcen wie google_apphub_service_project_attachment verwenden.

provider "google" {
  project = "project-id"
  region = "us-central1"
  # Override the App Hub API endpoint to use a regional endpoint
  apphub_custom_endpoint = "https://apphub.us-central1.rep.googleapis.com/"
}

Clientbibliotheken

Wenn Sie regionale Endpunkte mit Clientbibliotheken verwenden möchten, müssen Sie das Attribut api_endpoint in den Clientoptionen überschreiben.

Im folgenden Beispiel wird die Python-Clientbibliothek verwendet.

from google.cloud import apphub_v1
from google.api_core import client_options

rep_endpoint = "apphub.us-central1.rep.googleapis.com"
options = client_options.ClientOptions(api_endpoint=rep_endpoint)

# Instantiate the client
client = apphub_v1.AppHubClient(client_options=options)

Nutzung globaler API-Endpunkte einschränken

Um die Verwendung regionaler Endpunkte zu erzwingen, können Sie die Einschränkung der Organisationsrichtlinie constraints/gcp.restrictEndpointUsage verwenden, um Anfragen an den globalen API-Endpunkt zu blockieren. Weitere Informationen zum Einschränken der Endpunktnutzung finden Sie unter Endpunktnutzung einschränken.