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 es el proceso mediante el cual se 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:
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- 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 proporcionas a la CLI de gcloud.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Para obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud .
-
Roles obligatorios
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 zonas disponibles
Consulta una lista de zonas en la página Zonas en la consola de Google Cloud.
Con Google Cloud CLI, ejecuta el comando gcloud compute zones list
:
gcloud compute zones list
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 zonas de GPU
Para ver una lista de las zonas que admiten GPU, puedes usar gcloud CLI o REST.
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 de 80 GB, ejecuta el siguiente comando:
gcloud compute accelerator-types list --filter="nvidia-h100-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 muestra.
Cómo buscar por tipo de máquina
Los tipos de máquinas A3, A2 o G2 optimizados para aceleradores tienen GPUs 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"
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 de 80 GB, ejecuta el siguiente comando:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID /aggregated/acceleratorTypes?filter=name=nvidia-h100-80gb
Cómo buscar por tipo de máquina
Los tipos de máquinas A3, A2 o G2 optimizados para aceleradores tienen GPUs 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, organizado por zona.
Consulta una lista de regiones disponibles
Consulta una lista de regiones en la página Zonas de la consola de Google Cloud.
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
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
Puedes obtener información sobre regiones en la página Zonas de la consola de Google Cloud.
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 describeREGION
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
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?
- Obtén más información sobre Regiones y zonas.
- Más información para cambiar la región o la zona predeterminadas
- Obtén más información sobre Recursos globales, regionales y zonales.