Kurzanleitung: Cloud Location Finder aktivieren und Abfrage ausführen

Kurzanleitung: Cloud Location Finder aktivieren und Abfrage ausführen

Vorschau

Dieses Produkt unterliegt den Bedingungen für Pre‑GA-Angebote im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie in den Beschreibungen der Produkteinführungsphasen.

Auf dieser Seite erfahren Sie, wie Sie Cloud Location Finder über die Google Cloud CLI aktivieren und Cloud-Standorte nach Nähe, Gerichtsbarkeit und CO2-Fußabdruck suchen. Sie können Standorte mit HTTP-Anfragen oder Google Cloud CLI-Befehlen ermitteln.

Hinweise

1. Installieren Sie die Google Cloud CLI.
2. Führen Sie den folgenden Befehl aus, um die Google Cloud CLI zu initialisieren:

   gcloud init
   

Wenn Sie die Google Cloud CLI bereits installiert haben, prüfen Sie, ob Sie die neueste verfügbare Version nutzen. Führen Sie dazu gcloud components update aus.

3. Aktivieren Sie die Cloud Location Finder API:

   gcloud services enable cloudlocationfinder.googleapis.com  --project PROJECT
   

4. Rolle cloudlocationfinder.viewer hinzufügen

   gcloud projects add-iam-policy-binding PROJECT \
       --member USER_IDENTIFIER \
       --role roles/cloudlocationfinder.viewer
   

   • Ersetzen Sie PROJECT durch Ihre Projekt-ID.
   • Ersetzen Sie USER_IDENTIFIER durch die ID für Ihr Nutzerkonto. Beispiel: user:[e-mail].

Häufige Cloud Location Finder-Anfragen

Mit Cloud Location Finder können Sie das Cloud-Standort-Repository abfragen, um nahegelegene Cloud-Standorte basierend auf Nähe, Gebietscode oder Google-Verbrauch von CO2-freier Energie (CFE%) zu ermitteln. In den folgenden Abschnitten finden Sie gängige Beispiele für die Interaktion mit dem Cloud Location Finder-Repository.

Cloud Location Finder verwendet die Syntax der gRPC-Transcodierung.

• Ersetzen Sie PROJECT durch Ihre Projekt-ID.
• Ersetzen Sie CLOUD_REGION durch die Quell-Cloud-Region, um den nächstgelegenen Standort zu finden, einschließlich des Cloud-Anbieterpräfixes. Beispiel: gcp-us-central1 oder aws-us-east-1
• Ersetzen Sie CLOUD_PROVIDER durch den Cloud-Anbieter, für den Sie den nächstgelegenen Standort suchen möchten. Beispiel: AWS oder GCP

Nächstgelegene Cloud-Zone finden

Mit dieser Abfrage können Sie die Google Cloud -Zone ermitteln, die einem Cloud-Standort am nächsten ist. Dazu werden Daten zur Nähe für einen von Ihnen angegebenen Cloud-Anbieter verwendet.

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" "https://cloudlocationfinder.googleapis.com/v1alpha/projects/PROJECT/locations/global/cloudLocations:search?source_cloud_location=projects/PROJECT/locations/global/cloudLocations/CLOUD_REGION&query=cloud_provider=CLOUD_PROVIDER_CLOUD_PROVIDER%20AND%20cloud_location_type=CLOUD_LOCATION_TYPE_ZONE&page_size=1"

gcloud

gcloud alpha cloudlocationfinder cloud-locations search \
    --source-cloud-location=CLOUD_REGION \
    --query="cloud_provider=CLOUD_PROVIDER_CLOUD_PROVIDER AND cloud_location_type=CLOUD_LOCATION_TYPE_ZONE" \
    --limit=1

Alle Google Distributed Cloud Connected-Zonen in einer Region finden

Mit dieser Abfrage können Sie mit Distributed Cloud verbundene Zonen in einer bestimmten Region auflisten.

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" 'https://cloudlocationfinder.googleapis.com/v1alpha/projects/PROJECT/locations/global/cloudLocations?filter=containing_cloud_location="projects/PROJECT/locations/global/cloudLocations/CLOUD_REGION%20AND%20cloud_provider=CLOUD_PROVIDER_GCP%20AND%20cloud_location_type=CLOUD_LOCATION_TYPE_GDCC_ZONE"'

gcloud

gcloud cloudlocationfinder cloud-locations list --filter='cloud_provider=CLOUD_PROVIDER_GCP AND cloud_location_type=CLOUD_LOCATION_TYPE_GDCC_ZONE AND containing_cloud_location="projects/PROJECT/locations/global/cloudLocations/CLOUD_REGION"'

Regionen in einem bestimmten Gebiet finden

Mit dieser Abfrage können Sie Regionen innerhalb eines bestimmten Gebiets oder einer bestimmten Gerichtsbarkeit anhand eines von Ihnen angegebenen Gebietscodes identifizieren.

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" "https://cloudlocationfinder.googleapis.com/v1alpha/projects/PROJECT/locations/global/cloudLocations:search?source_cloud_location=projects/PROJECT/locations/global/cloudLocations/CLOUD_REGION&query=cloud_provider=CLOUD_PROVIDER_CLOUD_PROVIDER%20AND%20cloud_location_type=CLOUD_LOCATION_TYPE_REGION%20AND%20territory_code=TERRITORY_CODE&page_size=1"

gcloud

gcloud alpha cloudlocationfinder cloud-locations list \
    --source-cloud-location=CLOUD_REGION \
    --filter="cloud_provider=CLOUD_PROVIDER_CLOUD_PROVIDER AND cloud_location_type=CLOUD_LOCATION_TYPE_REGION" AND filter="territory_code=\"TERRITORY_CODE\"" \
    --limit=1

Cloud-Standorte auflisten, die die CO2-Bilanz minimieren

Mit dieser Abfrage können Sie Regionen mit dem niedrigsten CO2-Fußabdruck basierend auf CO2-freie Energie für Google Cloud Regionen ermitteln.

Hinweis :CFE-Daten sind nur für Google Cloud Standorte verfügbar.

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" "https://cloudlocationfinder.googleapis.com/v1alpha/projects/PROJECT/locations/global/cloudLocations?query=cloud_provider=CLOUD_PROVIDER_CLOUD_PROVIDER%20AND%20cloud_location_type=CLOUD_LOCATION_TYPE_REGION&page_size=5"

gcloud

gcloud alpha cloudlocationfinder cloud-locations list \
    --filter="cloud_provider=CLOUD_PROVIDER_CLOUD_PROVIDER AND cloud_location_type=CLOUD_LOCATION_TYPE_REGION" \
    --limit=5

Nächste Schritte

• Unterstützte Standorte ansehen
• Informationen zur Syntax von Standortsuchanfragen
• API-Referenz