Visualiza las regiones y zonas disponibles

En esta página, se explica cómo ver una lista de regiones y zonas disponibles y cómo obtener información sobre una región específica.

Para obtener más información sobre las regiones y zonas, lee la documentación Regiones y zonas.

Para obtener más información sobre los recursos globales, regionales y zonales de Compute Engine, lee la documentación Recursos globales, regionales y zonales.

Antes de comenzar

  • Si aún no lo hiciste, configura la autenticación. La autenticación verifica tu identidad para acceder a los servicios y las APIs de Google Cloud . Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    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. Instala Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI ejecutando el siguiente comando: 

      gcloud init

      Si usas un proveedor de identidad externo (IdP), primero debes acceder a gcloud CLI con tu identidad federada.

    2. Set a default region and zone.

    REST

    Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a gcloud CLI.

      Instala Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI ejecutando el siguiente comando: 

      gcloud init

      Si usas un proveedor de identidad externo (IdP), primero debes acceder a gcloud CLI con tu identidad federada.

    Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Google Cloud .

Roles requeridos

Para obtener los permisos que necesitas para ver las regiones y zonas disponibles, pídele a tu administrador que te otorgue el rol de Visualizador de Compute (roles/compute.viewer) de IAM en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Consulta una lista de las zonas disponibles

Console

Consulta una lista de zonas en la página Zonas en la Google Cloud consola.

Ir a Zonas

gcloud

Con Google Cloud CLI, ejecuta el comando gcloud compute zones list:

gcloud compute zones list

REST

Realiza una solicitud GET al método zones.list para obtener una lista de zonas para un proyecto. Reemplaza PROJECT_ID con tu PROJECT_ID.

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

Consulta una lista de las zonas de GPU

Para ver una lista de las zonas que admiten GPU, puedes usar gcloud CLI o REST.

gcloud

Busca por tipo de GPU

Para buscar por tipo de GPU, usa el comando gcloud compute accelerator-types list con la marca --filter para encontrar las zonas disponibles.

Por ejemplo, para buscar todas las zonas con GPU H100, ejecuta los siguientes comandos:

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

El resultado muestra una lista de las GPU disponibles organizadas por zona. Luego, puedes usar el comando gcloud compute accelerator-types describe para obtener una descripción de cada modelo de GPU que se devolvió.

Cómo buscar por tipo de máquina

Los tipos de máquinas optimizadas para aceleradores A3, A2 o G2 tienen GPU conectadas automáticamente a las VMs. Para estos tipos de máquinas, puedes usar el comando gcloud compute machine-types list con la marca --filter para encontrar las zonas disponibles. Por ejemplo, para buscar todas las zonas con tipos de máquina A3 High, ejecuta el siguiente comando:

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

REST

Busca por tipo de GPU

Para ver las zonas disponibles de un modelo de GPU específico, envía una solicitud GET al método acceleratorTypes.aggregatedList con el parámetro --filter.

Por ejemplo, para buscar todas las zonas con GPU H100, ejecuta las siguientes consultas:

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

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

Cómo buscar por tipo de máquina

Los tipos de máquinas optimizadas para aceleradores A3, A2 o G2 tienen GPU conectadas automáticamente a las VMs. Para estos tipos de máquinas, puedes usar el método machineTypes.aggregatedList con el parámetro --filter para encontrar las zonas disponibles.

Por ejemplo, para buscar todas las zonas con tipos de máquina A3 High, ejecuta el siguiente comando:

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

Reemplaza PROJECT_ID por el ID del proyecto.

El resultado muestra una lista de las GPUs disponibles y una descripción de cada modelo de GPU, organizadas por zona.

Consulta una lista de las regiones disponibles

Console

Consulta una lista de regiones en la página Zonas de la Google Cloud consola.

Ir a Zonas

gcloud

Con Google Cloud CLI, ejecuta el comando gcloud compute regions list:

gcloud compute regions list

Con el comando se enumeran todas las regiones disponibles y se proporciona información, como las cuotas y el estado de la región.

Por ejemplo:

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

Realiza una solicitud GET al método regions.list para obtener una lista de regiones. Reemplaza PROJECT_ID con tu PROJECT_ID.

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

Cómo ver información sobre una región

Console

Puedes obtener información sobre las regiones en la página Zonas de la Google Cloud consola.

Ir a Zonas

gcloud

Para obtener información sobre una sola región, ejecuta el comando gcloud compute regions describe, en el que REGION es el nombre de la región sobre la que quieres obtener más información:

gcloud compute regions describe REGION

Así sería una respuesta:

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

Realiza una solicitud GET al método regions.get para obtener información sobre una región. Reemplaza PROJECT_ID por tu PROJECT_ID y REGION por la región sobre la que quieres obtener más información.

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

¿Qué sigue?