Cette page a été traduite par l'API Cloud Translation.

Afficher les régions et les 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 mondiales, régionales et zonales de Compute Engine, consultez la documentation Ressources mondiales, 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 en sélectionnant l'une des options suivantes:

Select the tab for how you plan to use the samples on this page:
Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

Rôles requis

Pour obtenir les autorisations nécessaires pour afficher les régions et zones disponibles, demandez à votre administrateur de vous accorder le rôle IAM Lecteur de Compute (roles/compute.viewer) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

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.list pour obtenir la liste des zones d'un projet. Remplacez PROJECT_ID par l'ID de votre projet.

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

Afficher la liste des zones de GPU

Pour afficher la liste des zones acceptant des GPU, vous pouvez utiliser gcloud CLI ou REST.

gcloud

Faire une recherche par type de GPU

Pour effectuer une recherche par type de GPU, exécutez la commande gcloud compute accelerator-types list avec l'option --filter afin d'identifier les zones disponibles.

Par exemple, pour trouver toutes les zones proposant des GPU H100 de 80 Go, exécutez la commande suivante :

gcloud compute accelerator-types list --filter="nvidia-h100-80gb"

Le résultat renvoie une liste des GPU disponibles, triée par zones. Vous pouvez ensuite utiliser la commande gcloud compute accelerator-types describe pour obtenir une description de chaque modèle de GPU renvoyé.

Faire une recherche par type de machine

Les types de machines optimisés pour les accélérateurs A3, A2 ou G2 disposent de GPU qui sont automatiquement associés aux VM. Pour ces types de machines, vous pouvez utiliser la commande gcloud compute machine-types list avec l'option --filter pour rechercher les zones disponibles. Par exemple, pour trouver toutes les zones proposant des types de machines A3 High, exécutez la commande suivante :

gcloud compute machine-types list --filter="name=a3-highgpu-8g"

REST

Faire une recherche par type de GPU

Pour afficher les zones disponibles pour un modèle de GPU spécifique, envoyez une requête GET à la méthode acceleratorTypes.aggregatedList avec le paramètre --filter.

Par exemple, pour trouver toutes les zones proposant des GPU H100 de 80 Go, exécutez la commande suivante :

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/acceleratorTypes?filter=name=nvidia-h100-80gb

Faire une recherche par type de machine

Les types de machines optimisés pour les accélérateurs A3, A2 ou G2 disposent de GPU qui sont automatiquement associés aux VM. Pour ces types de machines, vous pouvez utiliser la méthode machineTypes.aggregatedList avec le paramètre --filter pour rechercher les zones disponibles.

Par exemple, pour trouver toutes les zones proposant des types de machines A3 High, exécutez la commande suivante :

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=a3-higgpu-8

Remplacez PROJECT_ID par l'ID de votre projet.

Le résultat renvoie une liste triée par zones des GPU disponibles, avec une description de chaque modèle de GPU.

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.

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

Apprenez-en plus sur les régions et les zones.
Découvrez comment modifier la région ou la zone par défaut.
Apprenez-en plus sur les ressources mondiales, régionales et zonales.