Guide de démarrage rapide : activer Cloud Location Finder et exécuter une requête

Cette page explique comment activer Cloud Location Finder à l'aide de Google Cloud CLI et comment trouver des emplacements cloud par proximité, juridiction et empreinte carbone. Vous pouvez trouver des emplacements à l'aide de requêtes HTTP ou de commandes Google Cloud CLI.

Avant de commencer

Installez la Google Cloud CLI.
Pour initialiser Google Cloud CLI, exécutez la commande suivante :
```
gcloud init
```

Activez l'API Cloud Location Finder :

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

Ajoutez le rôle cloudlocationfinder.viewer :
```
gcloud projects add-iam-policy-binding PROJECT \
    --member USER_IDENTIFIER \
    --role roles/cloudlocationfinder.viewer
```
- Remplacez PROJECT par l'ID de votre projet.
- Remplacez USER_IDENTIFIER par l'identifiant de votre compte utilisateur. Par exemple, user:myemail@example.com.
Si vous prévoyez de trouver des emplacements Google Distributed Cloud connectés à l'aide de Cloud Location Finder, activez l'API GDC Hardware Management et ajoutez le rôle gdchardwaremanagement.reader :
```
gcloud projects add-iam-policy-binding PROJECT \
    --member USER_IDENTIFIER \
    --role roles/gdchardwaremanagement.reader
```

Découvrir les requêtes Cloud Location Finder courantes

Cloud Location Finder vous permet d'interroger le dépôt d'emplacements cloud pour identifier les emplacements cloud à proximité en fonction de la proximité, code de territoire, ou consommation d'énergie sans carbone (CFE%) de Google. Les sections suivantes fournissent des exemples courants d'interaction avec le dépôt Cloud Location Finder.

Cloud Location Finder utilise la syntaxe de transcodage gRPC.

Remplacez PROJECT par l'ID de votre projet.
Remplacez CLOUD_REGION par la région cloud source pour trouver l'emplacement le plus proche, y compris le préfixe du fournisseur cloud. Par exemple, gcp-us-central1 ou aws-us-east-1.
Remplacez CLOUD_PROVIDER par le cloud fournisseur pour trouver l'emplacement le plus proche. Par exemple, AWS ou GCP.

Trouver la zone cloud la plus proche

Utilisez cette requête pour identifier la zone la plus proche d'un emplacement cloud à l'aide des données de proximité d'un fournisseur cloud que vous spécifiez. Google Cloud

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

Trouver toutes les zones Google Distributed Cloud connectées dans une région

Utilisez cette requête pour répertorier les zones Distributed Cloud connectées dans une région spécifique.

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

Trouver des régions dans un territoire spécifique

Utilisez cette requête pour identifier les régions d'un territoire ou d'une juridiction spécifique à l'aide d'un code de territoire que vous fournissez.

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

Répertorier les emplacements cloud qui minimisent l'empreinte carbone

Utilisez cette requête pour identifier les régions présentant la plus faible empreinte carbone en fonction de l'énergie sans carbone pour les Google Cloud régions.

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

Étape suivante

Consulter les emplacements compatibles
En savoir plus sur la syntaxe des requêtes de recherche d'emplacements
Consulter la documentation de référence de l'API