Kurzanleitung: Cloud Location Finder aktivieren und Abfrage ausführen

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

Hinweis

  1. Installieren Sie die Google Cloud CLI.
  2. Führen Sie den folgenden Befehl aus, um die Google Cloud CLI zu initialisieren: 
    gcloud init
  3. Aktivieren Sie die Cloud Location Finder API: 
    gcloud services enable cloudlocationfinder.googleapis.com  --project PROJECT
  4. Fügen Sie die Rolle cloudlocationfinder.viewer hinzu: 
    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:myemail@example.com.
  5. Wenn Sie mit Cloud Location Finder Standorte von Google Distributed Cloud Connected finden möchten, aktivieren Sie die GDC Hardware Management API und fügen Sie die gdchardwaremanagement.reader Rolle hinzu: 
    gcloud projects add-iam-policy-binding PROJECT \
    --member USER_IDENTIFIER \
    --role roles/gdchardwaremanagement.reader

Häufige Cloud Location Finder-Abfragen

Mit Cloud Location Finder können Sie das Cloud-Standort-Repository abfragen, um Cloud-Standorte in der Nähe zu finden. Die Suche kann nach Nähe, Gebietscode oder dem CO2-freien Energieverbrauch (Carbon Free Energy, CFE) von Google erfolgen. In den folgenden Abschnitten finden Sie häufige 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, für die Sie den nächstgelegenen Standort suchen möchten, einschließlich des Präfixes des Cloud-Anbieters. 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 nächstgelegene Google Cloud Zone für einen Cloud-Standort anhand von Nähedaten für einen von Ihnen angegebenen Cloud-Anbieter ermitteln.

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "X-Goog-User-Project: PROJECT "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 mit Google Distributed Cloud verbundenen Zonen in einer Region finden

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

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "X-Goog-User-Project: PROJECT '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 in einem bestimmten Gebiet oder einer bestimmten Gerichtsbarkeit anhand eines von Ihnen angegebenen Gebietscodes ermitteln.

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "X-Goog-User-Project: PROJECT "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 search \
    --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 den CO2-Fußabdruck minimieren

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

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "X-Goog-User-Project: PROJECT "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