Guida rapida: attiva Cloud Location Finder ed esegui una query

Questa pagina mostra come attivare Cloud Location Finder utilizzando Google Cloud CLI e trovare le posizioni 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

Installa Google Cloud CLI.
Per inizializzare Google Cloud CLI, esegui questo comando:
```
gcloud init
```

Abilita l'API Cloud Location Finder:

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

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.
Se prevedi di trovare le posizioni di Google Distributed Cloud connesso utilizzando Cloud Location Finder, attiva 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à, al codice del territorio o al 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 posizione 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.

Trova 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 che specifichi.

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

Elenco delle 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 .

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.