Afficher les régions et zones disponibles

Cette page explique comment afficher une liste des régions et zones disponibles et comment obtenir des informations sur une région spécifique.

Pour en savoir plus sur les régions et les zones, consultez la documentation Régions et zones.

Pour en savoir plus sur les ressources globales, régionales et zonales de Compute Engine, consultez la documentation Ressources globales, régionales et zonales.

Avant de commencer

  • Si ce n'est pas déjà fait, configurez l'authentification. L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Google Cloud. Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine comme suit :

    Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :

    Console

    Lorsque vous utilisez la console Google Cloud pour accéder aux services et aux API Google Cloud, vous n'avez pas besoin de configurer l'authentification.

    gcloud

    1. Installez Google Cloud CLI, puis initialisez-la en exécutant la commande suivante : 

      gcloud init
    2. Définissez une région et une zone par défaut.

    REST

    Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.

      Installez Google Cloud CLI, puis initialisez-la en exécutant la commande suivante : 

      gcloud init

Afficher la liste des zones disponibles

Console

Affichez la liste des zones sur la page "Zones" de la console Google Cloud.

Accéder à la page "Zones"

gcloud

À l'aide de Google Cloud CLI, exécutez la commande gcloud compute zones list :

gcloud compute zones list

REST

Envoyez une requête GET à la méthode zones.get pour obtenir la liste des zones. Remplacez PROJECT_ID par l'ID de votre projet.

https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones

Afficher la liste des régions disponibles

Console

Affichez la liste des régions sur la page "Zones" de la console Google Cloud.

Accéder à la page "Zones"

gcloud

À l'aide de Google Cloud CLI, exécutez la commande gcloud compute regions list :

gcloud compute regions list

La commande répertorie toutes les régions disponibles, et fournit des informations telles que les quotas et l'état de la région elle-même.

Par exemple :

gcloud compute regions list
NAME             CPUS   DISKS_GB     ADDRESSES  RESERVED_ADDRESSES  STATUS
asia-east1       0/24   0/10240           0/23       0/7                 UP
asia-northeast1  0/24   0/10240           0/23       0/7                 UP
asia-southeast1  0/24   0/10240           0/23       0/7                 UP
europe-west1     0/24   0/10240           2/23       0/7                 UP
us-central1      0/24   0/10240           0/23       0/7                 UP
us-east1         0/24   0/10240           0/23       0/7                 UP
us-west1         0/24   0/10240           0/23       0/7                 UP

REST

Envoyez une requête GET à la méthode regions.list pour obtenir la liste des régions. Remplacez PROJECT_ID par l'ID de votre projet.

https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions

Afficher les informations sur une région

Console

Vous pouvez afficher des informations sur les régions sur la page "Zones" de la console Google Cloud.

Accéder à la page "Zones"

gcloud

Pour obtenir des informations sur une seule région, exécutez la commande gcloud compute regions describe, où REGION correspond au nom de la région pour laquelle vous souhaitez obtenir plus d'informations :

gcloud compute regions describe REGION

La réponse devrait être semblable à ce qui suit :

creationTimestamp: '2013-09-06T17:54:12.193-07:00'
description: us-central1
id: '5778272079688511892'
kind: compute#region
name: us-central1
quotas:
- limit: 24.0
    metric: CPUS
    usage: 5.0
- limit: 5120.0
    metric: DISKS_TOTAL_GB
    usage: 650.0
- limit: 7.0
    metric: STATIC_ADDRESSES
    usage: 4.0
- limit: 23.0
    metric: IN_USE_ADDRESSES
    usage: 5.0
- limit: 1024.0
    metric: SSD_TOTAL_GB
    usage: 0.0
selfLink: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/us-central1
status: UP
zones:
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-b
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-c
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-f

REST

Envoyez une requête GET à la méthode regions.get pour obtenir des informations sur une région. Remplacez PROJECT_ID par l'ID de votre projet et REGION par la région pour laquelle vous souhaitez obtenir plus d'informations.

https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION

Étape suivante