Guida rapida: attiva Cloud Location Finder ed esegui una query

Guida rapida: attiva Cloud Location Finder ed esegui una query

Anteprima

Questo prodotto è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini di servizio specifici. I prodotti pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni delle fasi di lancio.

Questa pagina mostra come attivare 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
   

Se hai già installato Google Cloud CLI, assicurati di avere l'ultima versione disponibile eseguendo gcloud components update.

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:[e-mail].

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 a prossimità, codice territorio o consumo di energia a zero emissioni di CO2 di Google (CFE%). Le sezioni seguenti forniscono esempi comuni di interazione con il repository 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 provider di servizi cloud. Ad esempio: gcp-us-central1 o aws-us-east-1.
• Sostituisci CLOUD_PROVIDER con il provider cloud per trovare la posizione più vicina. Ad esempio: AWS o GCP.

Trovare la zona cloud più vicina

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

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

Trovare tutte le zone Google Distributed Cloud connesso in una regione

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

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"'

Trovare regioni all'interno di un territorio specifico

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

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

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

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

Nota: i dati CFE sono disponibili solo per Google Cloud località.

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

Passaggi successivi

• Controlla le località supportate.
• Scopri di più sulla sintassi delle query di ricerca per località
• Consulta il riferimento API.