Guida rapida: abilitare Cloud Location Finder ed eseguire una query

Questa pagina mostra come abilitare Cloud Location Finder utilizzando Google Cloud CLI e trovare le località cloud in base a prossimità, giurisdizione e impronta di carbonio. Puoi trovare le località utilizzando le richieste HTTP o i comandi di Google Cloud CLI.

Prima di iniziare

  1. Installa Google Cloud CLI.
  2. Per inizializzare Google Cloud CLI, esegui questo comando: 
    gcloud init
  3. Abilita l'API Cloud Location Finder: 
    gcloud services enable cloudlocationfinder.googleapis.com  --project PROJECT
  4. Aggiungi il ruolo cloudlocationfinder.viewer: 
    gcloud projects add-iam-policy-binding PROJECT \
    --member USER_IDENTIFIER \
    --role roles/cloudlocationfinder.viewer
    • Sostituisci PROJECT con l'ID progetto.
    • Sostituisci USER_IDENTIFIER con l'identificatore del tuo account utente. Ad esempio, user:myemail@example.com.
  5. Se prevedi di trovare le località Google Distributed Cloud connesso utilizzando Cloud Location Finder, abilita l'API GDC Hardware Management e aggiungi il ruolo gdchardwaremanagement.reader: 
    gcloud projects add-iam-policy-binding PROJECT \
    --member USER_IDENTIFIER \
    --role roles/gdchardwaremanagement.reader

Esplorare le query comuni di Cloud Location Finder

Cloud Location Finder ti consente di eseguire query sul repository delle località cloud per identificare le località cloud vicine in base alla prossimità, codice del territorio o al consumo di energia a zero emissioni di CO2 di Google (CFE%). Le sezioni che seguono forniscono esempi comuni di come interagire con il repository di Cloud Location Finder.

Cloud Location Finder utilizza la sintassi di transcodifica gRPC.

  • Sostituisci PROJECT con l'ID progetto.
  • Sostituisci CLOUD_REGION con la regione cloud di origine per trovare la località più vicina, incluso il prefisso del fornitore di servizi cloud. Ad esempio, gcp-us-central1 o aws-us-east-1.
  • Sostituisci CLOUD_PROVIDER con il fornitore di servizi cloud per trovare la località più vicina. Ad esempio, AWS o GCP.

Trovare la zona cloud più vicina

Utilizza questa query per identificare la zona più vicina a una località cloud utilizzando i dati di prossimità per un fornitore di servizi cloud che hai specificato. Google Cloud

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "X-Goog-User-Project: PROJECT "https://cloudlocationfinder.googleapis.com/v1/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 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

Trovare tutte le zone Google Distributed Cloud connesso in una regione

Utilizza questa query per elencare le zone Distributed Cloud connesso all'interno di una regione specifica.

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "X-Goog-User-Project: PROJECT 'https://cloudlocationfinder.googleapis.com/v1/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"'

Trovare le regioni all'interno di un territorio specifico

Utilizza questa query per identificare le regioni all'interno di un territorio o di una giurisdizione specifica utilizzando un codice del territorio che fornisci.

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "X-Goog-User-Project: PROJECT "https://cloudlocationfinder.googleapis.com/v1/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 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

Elencare le località cloud che riducono al minimo l'impronta di carbonio

Utilizza questa query per identificare le regioni con l'impronta di carbonio più bassa in base a energia a zero emissioni di CO2 per Google Cloud le regioni.

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "X-Goog-User-Project: PROJECT "https://cloudlocationfinder.googleapis.com/v1/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 cloudlocationfinder cloud-locations list \
    --filter="cloud_provider=CLOUD_PROVIDER_CLOUD_PROVIDER AND cloud_location_type=CLOUD_LOCATION_TYPE_REGION" \
    --limit=5

Passaggi successivi