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:
Selecciona la pestaña que corresponda a la forma en que planeas usar las muestras de esta página:
Console
Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud , no necesitas configurar la autenticación.
gcloud
-
Instala Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI con el siguiente comando:
gcloud initSi usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.
-
- Configura una región y una zona predeterminadas.
REST
Para usar las muestras de la API de REST incluidas en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la gcloud CLI.
Instala Google Cloud CLI.
Si usas un proveedor de identidad externo (IdP), primero debes acceder a la 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 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 las zonas disponibles
Una zona es un área de implementación dentro de una región. Algunas regiones tienen zonas especializadas que proporcionan una capacidad significativa para los aceleradores de alta demanda (GPU y TPU). Estas zonas especializadas se denominan zonas de IA y son ideales para cargas de trabajo de IA y AA.
Para ver una lista de las zonas disponibles, incluidas las zonas de IA, usa una de las siguientes opciones:
Console
Consulta una lista de zonas en la página Zonas de la consola. Google Cloud
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 que admiten aceleradores (GPUs y TPUs)
Para ver una lista de las zonas que admiten aceleradores (GPUs y TPUs), usa uno de los siguientes métodos:
- Para encontrar zonas de IA que proporcionen una capacidad significativa para los aceleradores, busca zonas de IA.
- Para encontrar todas las zonas que admiten un acelerador específico, busca por tipo de acelerador.
- Para encontrar todas las zonas que admiten un tipo de máquina específico con un acelerador, busca por tipo de máquina.
Cómo buscar zonas de IA
Si deseas ejecutar cargas de trabajo de IA y AA, considera usar zonas de IA. Puedes identificar una zona de IA por la cadena ai en su nombre. Por ejemplo, us-central1-ai1a es una zona de IA en la región us-central1, con us-central1-a como zona principal. Para obtener más información, consulta Zonas de IA.
La consola de Google Cloud muestra las zonas de IA junto con otras zonas, agrupadas por regiones. Para ver una lista de las zonas de IA disponibles, usa gcloud CLI o la API de REST.
Console
En la consola de Google Cloud , la página Zonas muestra las zonas de IA en una región en la que se admiten estas zonas. Puedes identificar una zona de IA por la cadena AI en su nombre, por ejemplo, la región us-central1 enumera Zone AI1A.
gcloud
Usa el comando gcloud compute zones list y filtra las zonas que contengan la cadena ai:
gcloud compute zones list \
--filter="name~'-ai'"
REST
Realiza una solicitud GET al método zones.list. Para hacer coincidir las zonas que contienen ai en su nombre, usa el parámetro de consulta filter con la expresión regular name eq '.*-ai.*'.
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones?filter=name%20eq%20'.*-ai.*'
Reemplaza PROJECT_ID con tu PROJECT_ID.
Cómo buscar por tipo de acelerador
Si buscas por un tipo de acelerador, se mostrarán todas las zonas, incluidas las zonas de IA, en las que se admite ese acelerador.
gcloud
Para buscar por tipo de acelerador, usa el comando gcloud compute accelerator-types list con la marca --filter.
Por ejemplo, para encontrar todas las zonas con un acelerador específico, como una GPU NVIDIA B200 o una Cloud TPU v6e (Trillium), ejecuta uno de los siguientes comandos:
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)"
Reemplaza el tipo de acelerador en el ejemplo por el tipo de acelerador por el que deseas buscar.
REST
Para buscar por tipo de acelerador, envía una solicitud GET al método acceleratorTypes.aggregatedList con el parámetro filter.
Por ejemplo, para encontrar todas las zonas con un acelerador específico, como una GPU NVIDIA B200 o una Cloud TPU v6e (Trillium), ejecuta uno de los siguientes comandos:
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
Reemplaza el tipo de acelerador en el ejemplo por el tipo de acelerador por el que deseas buscar.
Cómo buscar por tipo de máquina
Si buscas por un tipo de máquina, se mostrarán todas las zonas, incluidas las zonas de IA, en las que se admite ese tipo de máquina.
gcloud
Para buscar por tipo de máquina, usa el comando gcloud compute machine-types list con la marca --filter.
Por ejemplo, para buscar todas las zonas con un tipo de máquina específico, como el tipo de máquina a4-highgpu-8g A4 o el tipo de máquina ct6e-standard-4t Cloud TPU v6e (Trillium), ejecuta uno de los siguientes comandos:
a4-highgpu-8gTipo de máquina A4gcloud compute machine-types list \ --filter="name=a4-highgpu-8g" \ --format="value(zone)"Tipo de máquina de Cloud TPU v6e (Trillium)
ct6e-standard-4tgcloud compute machine-types list \ --filter="name=ct6e-standard-4t" \ --format="value(zone)"
Reemplaza el tipo de máquina del ejemplo por el tipo de máquina por el que deseas buscar.
REST
Para buscar por tipo de máquina, realiza una solicitud GET al método machineTypes.aggregatedList con el parámetro filter.
Por ejemplo, para buscar todas las zonas con un tipo de máquina específico, como el tipo de máquina a4-highgpu-8g A4 o el tipo de máquina ct6e-standard-4t Cloud TPU v6e (Trillium), ejecuta uno de los siguientes comandos:
a4-highgpu-8gTipo de máquina A4GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=a4-highgpu-8g
Tipo de máquina de Cloud TPU v6e (Trillium)
ct6e-standard-4tGET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=ct6e-standard-4t
Reemplaza PROJECT_ID por el ID de tu proyecto y el tipo de máquina por el tipo de máquina que deseas buscar.
Cómo excluir zonas de IA de las listas
Si tienes acceso a las zonas de IA, pero no quieres verlas en tus listas de zonas, usa filtros para excluirlas. Este podría ser el caso si usas servicios que no admiten las zonas de IA o si tienes una automatización existente que depende de la lista de zonas. Puedes identificar las zonas de IA por el sufijo -ai en sus nombres.
gcloud
Para excluir las zonas de IA de la lista de zonas disponibles, usa el comando gcloud compute zones list y filtra las zonas que contengan la cadena -ai:
gcloud compute zones list --filter 'name !~ ".*-ai.*"'
Para filtrar las zonas de IA cuando enumeres los tipos de máquinas, usa el comando gcloud compute machine-types list y filtra las zonas que contengan la cadena -ai:
gcloud compute machine-types list --filter 'zone !~ ".*-ai.*"'
REST
Para excluir las zonas de IA de los resultados de la API, usa la expresión regular name ne ".*-ai.*" dentro del parámetro de consulta del filtro. Cuando agregues este filtro a una URL, debes codificar el parámetro de consulta del filtro como 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
Reemplaza PROJECT_ID con tu PROJECT_ID.
Terraform
Para excluir las zonas de IA de la lista de zonas disponibles, crea una función local como en el siguiente ejemplo:
# 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
}
Consulta una lista de las regiones disponibles
Console
Puedes ver las regiones disponibles en la página Zonas de la consola deGoogle Cloud .
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 consola deGoogle Cloud .
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?
- 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.