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 permet de valider votre identité pour accéder aux Google Cloud services et aux API. 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 :

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

    Console

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

    gcloud

    1. Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisezla en exécutant la commande suivante : 

      gcloud init

      Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

  • Définissez une région et une zone par défaut.

    • REST

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

      Installez la Google Cloud CLI.

      Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

    Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l' Google Cloud authentification.

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

Une zone est un espace de déploiement au sein d'une région. Certaines régions disposent de zones spécialisées qui offrent une capacité importante pour les accélérateurs à forte demande (GPU et TPU). Ces zones spécialisées sont appelées zones d'IA et sont idéales pour les charges de travail d'IA et de ML

Pour afficher la liste des zones disponibles, y compris les zones d'IA, utilisez l'une des options suivantes :

Console

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

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 PROJECT_ID.

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

Afficher la liste des zones compatibles avec les accélérateurs (GPU et TPU)

Pour afficher la liste des zones compatibles avec les accélérateurs (GPU et TPU), utilisez l'une des méthodes suivantes :

Rechercher des zones d'IA

Si vous souhaitez exécuter des charges de travail d'IA et de ML, envisagez d'utiliser des zones d'IA. Vous pouvez identifier une zone d'IA par la chaîne ai dans son nom. Par exemple, us-central1-ai1a est une zone d'IA dans la région us-central1, avec us-central1-a comme zone parente. Pour en savoir plus, consultez Zones d'IA.

La Google Cloud console répertorie les zones d'IA avec d'autres zones, regroupées par régions. Pour afficher la liste des zones d'IA disponibles, utilisez la gcloud CLI ou l'API REST.

Console

Dans la Google Cloud console, la page Zones répertorie les zones d'IA dans une région où ces zones sont compatibles. Vous pouvez identifier une zone d'IA par la chaîne AI dans son nom. Par exemple, la région us-central1 répertorie Zone AI1A.

Accéder à la page "Zones"

gcloud

Utilisez la commande gcloud compute zones list et filtrez les zones contenant la chaîne ai :

gcloud compute zones list \
    --filter="name~'-ai'"

REST

Envoyez une GET requête à la zones.list méthode. Pour faire correspondre les zones contenant ai dans leur nom, utilisez le paramètre de requête filter avec l'expression régulière name eq '.*-ai.*'.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones?filter=name%20eq%20'.*-ai.*'

Remplacez PROJECT_ID par l'ID de votre PROJECT_ID.

Rechercher par type d'accélérateur

La recherche par type d'accélérateur renvoie toutes les zones, y compris les zones d'IA, où cet accélérateur est compatible.

gcloud

Pour effectuer une recherche par type d'accélérateur, exécutez la gcloud compute accelerator-types list commande avec l'option --filter flag.

Par exemple, pour trouver toutes les zones avec un accélérateur spécifique, tel qu'un GPU NVIDIA B200 ou un Cloud TPU v6e (Trillium), exécutez l'une des commandes suivantes :

  • NVIDIA B200

      gcloud compute accelerator-types list \
      --filter="name=nvidia-b200" \
      --format="value(zone)"

  • Cloud TPU v6e (Trillium)

      gcloud compute accelerator-types list \
      --filter="name=ct6e" \
      --format="value(zone)"

Remplacez le type d'accélérateur dans l'exemple par le type d'accélérateur que vous souhaitez rechercher.

REST

Pour effectuer une recherche par type d'accélérateur, envoyez une GET requête à la acceleratorTypes.aggregatedList méthode avec le filter paramètre.

Par exemple, pour trouver toutes les zones avec un accélérateur spécifique, tel qu'un GPU NVIDIA B200 ou un Cloud TPU v6e (Trillium), exécutez l'une des commandes suivantes :

  • NVIDIA B200 

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

  • Cloud TPU v6e (Trillium) 

      GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/acceleratorTypes?filter=name=ct6e

Remplacez le type d'accélérateur dans l'exemple par le type d'accélérateur que vous souhaitez rechercher.

Rechercher par type de machine

La recherche par type de machine renvoie toutes les zones, y compris les zones d'IA, où ce type de machine est compatible.

gcloud

Pour effectuer une recherche par type de machine, exécutez la gcloud compute machine-types list commande avec l'option --filter

Par exemple, pour trouver toutes les zones avec un type de machine spécifique, tel qu'un type de machine A4 a4-highgpu-8g ou un type de machine Cloud TPU v6e (Trillium) ct6e-standard-4t, exécutez l'une des commandes suivantes :

  • Type de machine A4 a4-highgpu-8g

      gcloud compute machine-types list \
      --filter="name=a4-highgpu-8g" \
      --format="value(zone)"

  • Type de machine Cloud TPU v6e (Trillium) ct6e-standard-4t

      gcloud compute machine-types list \
      --filter="name=ct6e-standard-4t" \
      --format="value(zone)"

Remplacez le type de machine dans l'exemple par le type de machine que vous souhaitez rechercher.

REST

Pour effectuer une recherche par type de machine, envoyez une GET requête à la machineTypes.aggregatedList méthode avec le filter paramètre.

Par exemple, pour trouver toutes les zones avec un type de machine spécifique, tel qu'un type de machine A4 a4-highgpu-8g ou un type de machine Cloud TPU v6e (Trillium) ct6e-standard-4t, exécutez l'une des commandes suivantes :

  • Type de machine A4 a4-highgpu-8g

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=a4-highgpu-8g

  • Type de machine Cloud TPU v6e (Trillium) ct6e-standard-4t

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=ct6e-standard-4t

Remplacez PROJECT_ID par l'ID de votre projet et le type de machine par le type de machine que vous souhaitez rechercher.

Exclure les zones d'IA des listes

Si vous avez accès aux zones d'IA, mais que vous ne souhaitez pas les voir dans vos listes de zones, utilisez des filtres pour les exclure. Cela peut être le cas si vous utilisez des services non compatibles avec les zones d'IA ou si vous disposez d'une automatisation existante qui dépend de la liste des zones. Vous pouvez identifier les zones d'IA par le suffixe -ai dans leur nom.

gcloud

Pour exclure les zones d'IA de la liste des zones disponibles, utilisez la gcloud compute zones list commande et filtrez les zones contenant la chaîne -ai :

gcloud compute zones list --filter 'name !~ ".*-ai.*"'

Pour filtrer les zones d'IA lors de la liste des types de machines, exécutez la gcloud compute machine-types list commande et filtrez les zones contenant la chaîne -ai :

gcloud compute machine-types list --filter 'zone !~ ".*-ai.*"'

REST

Pour exclure les zones d'IA des résultats de l'API, utilisez l'name ne ".*-ai.*" expression régulière dans le paramètre de requête de filtre. Lorsque vous ajoutez ce filtre dans une URL, vous devez encoder le paramètre de requête de filtre en tant que filter=name%20ne%20%22.%2A-ai.%2A%22.

https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones?filter=name%20ne%20%22.%2A-ai.%2A%22

Remplacez PROJECT_ID par l'ID de votre PROJECT_ID.

Terraform

Pour exclure les zones d'IA de la liste des zones disponibles, créez une fonction locale comme dans l'exemple suivant :

# Fetch zones from API
data "google_compute_zones" "available" {
  project = var.my_project_id
  region  = var.my_region
  status  = "UP"
}

locals {
  # Filter the list in Terraform
  non_ai_zones = [
    for zone in data.google_compute_zones.available.names : zone
    if !strcontains(zone, "-ai")
  ]
}

# Example usage
output "standard_gce_zones" {
  description = "List of zones, excluding AI/ML zones."
  value       = locals.non_ai_zones
}

Afficher la liste des régions disponibles

Console

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

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 regions.list méthode pour obtenir la liste des régions. Remplacez PROJECT_ID par l'ID de votre PROJECT_ID.

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 dans la Google Cloud console.

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