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
-
Configura la autenticación si aún no lo hiciste.
La autenticación verifica tu identidad para acceder a los Google Cloud servicios y las APIs. 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 según cómo planeas usar las muestras en esta página:
Console
Cuando usas la Google Cloud consola para acceder a los Google Cloud servicios y las APIs, no necesitas configurar la autenticación.
gcloud
-
Instala la Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI con el siguiente comando:
gcloud initSi usas un proveedor de identidad (IdP) externo, primero debes acceder a 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 la Google Cloud CLI.
Si usas un proveedor de identidad (IdP) externo, 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 obligatorios
Para obtener los permisos que
necesitas para ver las regiones y zonas disponibles,
pídele a tu administrador que te otorgue el
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
Una zona es un área de implementación dentro de una región. Algunas regiones tienen zonas especializadas que proporcionan una capacidad significativa para aceleradores de alta demanda (GPU y TPU). Estas zonas especializadas se denominan zonas de IA, que 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 en la Google Cloud consola.
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
por tu PROJECT_ID.
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones
Consulta una lista de zonas que admiten aceleradores (GPU y TPU)
Para ver una lista de las zonas que admiten aceleradores (GPU y TPU), 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.
Busca 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 su zona superior. Para obtener más información, consulta
Zonas de IA.
La Google Cloud consola 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 Google Cloud consola, 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 muestra Zone AI1A.
gcloud
Usa el gcloud compute zones list comando
y filtra las zonas que contengan la cadena ai:
gcloud compute zones list \
--filter="name~'-ai'"
REST
Realiza una GET solicitud al
zones.list
método. Para que coincidan las zonas que contienen ai en su nombre, usa el parámetro de consulta filter query
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
por tu PROJECT_ID.
Busca por tipo de acelerador
Si buscas por tipo de acelerador, se muestran todas las zonas, incluidas las zonas de IA, en las que se admite ese acelerador.
gcloud
Para buscar por tipo de acelerador, usa el
gcloud compute accelerator-types list comando
con la --filter marca.
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
acceleratorTypes.aggregatedList método
con el filter parámetro.
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.
Busca por tipo de máquina
Si buscas por tipo de máquina, se muestran 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
gcloud compute machine-types list comando
con la --filter marca.
Por ejemplo, para encontrar 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:
Tipo de máquina
a4-highgpu-8gA4gcloud compute machine-types list \ --filter="name=a4-highgpu-8g" \ --format="value(zone)"Tipo de máquina
ct6e-standard-4tCloud TPU v6e (Trillium)gcloud compute machine-types list \ --filter="name=ct6e-standard-4t" \ --format="value(zone)"
Reemplaza el tipo de máquina en el ejemplo por el tipo de máquina por el que deseas buscar.
REST
Para buscar por tipo de máquina, realiza una GET solicitud al
machineTypes.aggregatedList método
con el filter parámetro.
Por ejemplo, para encontrar 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:
Tipo de máquina
a4-highgpu-8gA4GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=a4-highgpu-8g
Tipo de máquina
ct6e-standard-4tCloud TPU v6e (Trillium)GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=ct6e-standard-4t
Reemplaza PROJECT_ID por el ID del proyecto y el tipo de máquina por el tipo de máquina por el que deseas buscar.
Excluye las 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
gcloud compute zones list comando
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
gcloud compute machine-types list comando
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 name ne ".*-ai.*" expresión
regular 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
por 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 regiones disponibles
Console
Puedes ver las regiones disponibles en la página Zonas en la Google Cloud consola.
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 GET solicitud al
regions.list método para
obtener una lista de regiones. Reemplaza PROJECT_ID
por tu PROJECT_ID.
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions
Obtén información sobre una región
Console
Puedes obtener información sobre regiones en la página Zonas en la Google Cloud consola.
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
regions.get método 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.