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

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

Preview

Ce produit est soumis aux "Conditions des Offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les produits de pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Cette page explique comment activer le Localisateur de régions Cloud à l'aide de Google Cloud CLI et comment trouver des régions 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

1. Installez la Google Cloud CLI.
2. Pour initialiser Google Cloud CLI, exécutez la commande suivante :

   gcloud init
   

Si vous avez déjà installé Google Cloud CLI, assurez-vous de disposer de la dernière version disponible en exécutant la commande gcloud components update.

3. Activez l'API Cloud Location Finder :

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

4. 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 du projet.
   • Remplacez USER_IDENTIFIER par l'identifiant de votre compte utilisateur. Par exemple, user:[e-mail].

Explorer 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é, du code de territoire ou de la consommation d'énergie décarbonée de Google (CFE%). 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 du projet.
• Remplacez CLOUD_REGION par la région cloud source pour trouver l'emplacement le plus proche, y compris le préfixe du fournisseur de services cloud. Par exemple, gcp-us-central1 ou aws-us-east-1.
• Remplacez CLOUD_PROVIDER par le fournisseur de services cloud pour lequel vous souhaitez 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 Google Cloud la plus proche d'un emplacement cloud à l'aide des données de proximité d'un fournisseur de services cloud que vous spécifiez.

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

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

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

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

Rechercher 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écifiques à l'aide d'un code de territoire que vous fournissez.

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

Lister les emplacements cloud qui minimisent l'empreinte carbone

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

Remarque : Les données CFE ne sont disponibles que pour Google Cloud emplacements.

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

Étapes suivantes

• Consultez les emplacements compatibles.
• En savoir plus sur la syntaxe des requêtes de recherche de lieux
• Consultez la documentation de référence de l'API.