Conferir regiões e zonas disponíveis

Nesta página, você aprenderá a listar as regiões e zonas disponíveis e a conseguir informações sobre uma determinada região.

Leia a documentação Regiões e zonas para saber mais sobre elas.

Leia a documentação Recursos globais, regionais e por zonas para saber mais sobre esses recursos do Compute Engine.

Antes de começar

Configure a autenticação, caso ainda não tenha feito isso. Com isso, você confirma sua identidade para acesso a serviços e APIs do Google Cloud . Para executar código ou exemplos em um ambiente de desenvolvimento local, faça a autenticação no Compute Engine com um destes métodos:
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. Instale a CLI do Google Cloud. Após a instalação, inicialize a CLI do Google Cloud executando o seguinte comando:
  gcloud init
  Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.
  
  Observação: se você já instalou a gcloud CLI, execute o comando gcloud components update para verificar se você tem a versão mais recente.
2. Set a default region and zone.
REST

Para usar as amostras da API REST desta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.
Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .

Funções exigidas

Para receber as permissões necessárias para ver as regiões e zonas disponíveis, peça ao administrador para conceder a você o papel do IAM de Leitor do Compute (roles/compute.viewer) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

Exibir uma lista de zonas disponíveis

Uma zona é uma área de implantação em uma região. Algumas regiões têm zonas especializadas que oferecem capacidade significativa para aceleradores de alta demanda (GPUs e TPUs). Essas zonas especializadas são chamadas de zonas de IA, que são ideais para cargas de trabalho de IA e ML.

Para conferir uma lista de zonas disponíveis, incluindo as de IA, use uma das seguintes opções:

Console

Veja uma lista de zonas na página Zonas, no console do Google Cloud .

Acesse Zonas

gcloud

Usando a Google Cloud CLI, execute o comando gcloud compute zones list:

gcloud compute zones list

REST

Faça uma solicitação GET ao método zones.list para receber uma lista de zonas de um projeto. Substitua PROJECT_ID pelo PROJECT_ID.

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

Conferir uma lista de zonas que aceitam aceleradores (GPUs e TPUs)

Para conferir uma lista de zonas que aceitam aceleradores (GPUs e TPUs), use um dos seguintes métodos:

Para encontrar zonas de IA que oferecem capacidade significativa para aceleradores, pesquise zonas de IA.
Para encontrar todas as zonas que oferecem suporte a um acelerador específico, pesquise por tipo de acelerador.
Para encontrar todas as zonas que oferecem suporte a um tipo de máquina específico com um acelerador, pesquise por tipo de máquina.

Pesquisar zonas de IA

Se você quiser executar cargas de trabalho de IA e ML, considere usar zonas de IA. É possível identificar uma zona de IA pela string ai no nome dela. Por exemplo, us-west4-ai1b é uma zona de IA na região us-west4, com us-west4-b como zona principal. Para saber mais, consulte Zona de IA.

O console Google Cloud lista as zonas de IA junto com outras zonas, agrupadas por regiões. Para conferir uma lista de zonas de IA disponíveis, use a CLI gcloud ou a API REST.

Console

No console Google Cloud , a página Zonas lista as zonas de IA em uma região onde elas têm suporte. É possível identificar uma zona de IA pela string AI no nome dela. Por exemplo, a região us-west4 lista Zone AI2B.

Acesse Zonas

gcloud

Use o comando gcloud compute zones list e filtre as zonas que contêm a string ai:

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

REST

Faça uma solicitação GET ao método zones.list. Para corresponder a zonas que contenham ai no nome, use o parâmetro de consulta filter com a expressão regular name eq '.*-ai.*'.

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

Substitua PROJECT_ID pelo PROJECT_ID.

Pesquisar por tipo de acelerador

A pesquisa por um tipo de acelerador retorna todas as zonas, incluindo as de IA, em que esse acelerador é compatível.

gcloud

Para pesquisar por tipo de acelerador, use o comando gcloud compute accelerator-types list com a flag --filter.

Por exemplo, para encontrar todas as zonas com um acelerador específico, como uma GPU NVIDIA B200 ou uma TPU do Cloud v6e (Trillium), execute um dos seguintes 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)"

Substitua o tipo de acelerador no exemplo pelo tipo que você quer pesquisar.

REST

Para pesquisar por tipo de acelerador, envie uma solicitação GET para o método acceleratorTypes.aggregatedList com o parâmetro filter.

Por exemplo, para encontrar todas as zonas com um acelerador específico, como uma GPU NVIDIA B200 ou uma TPU do Cloud v6e (Trillium), execute um dos seguintes 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

Substitua o tipo de acelerador no exemplo pelo tipo que você quer pesquisar.

Pesquisar por tipo de máquina

A pesquisa por um tipo de máquina retorna todas as zonas, incluindo as de IA, em que esse tipo de máquina é compatível.

gcloud

Para pesquisar por tipo de máquina, use o comando gcloud compute machine-types list com a flag --filter.

Por exemplo, para encontrar todas as zonas com um tipo de máquina específico, como a4-highgpu-8g A4 ou ct6e-standard-4t Cloud TPU v6e (Trillium), execute um dos seguintes comandos:

a4-highgpu-8g Tipo de máquina A4

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

Tipo de máquina ct6e-standard-4t Cloud TPU v6e (Trillium)

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

Substitua o tipo de máquina no exemplo pelo tipo de máquina que você quer pesquisar.

REST

Para pesquisar por tipo de máquina, faça uma solicitação GET ao método machineTypes.aggregatedList com o parâmetro filter.

Por exemplo, para encontrar todas as zonas com um tipo de máquina específico, como a4-highgpu-8g A4 ou ct6e-standard-4t Cloud TPU v6e (Trillium), execute um dos seguintes comandos:

a4-highgpu-8g Tipo de máquina A4

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

Tipo de máquina ct6e-standard-4t Cloud TPU v6e (Trillium)

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

Substitua PROJECT_ID pelo ID do projeto e o tipo de máquina pelo tipo que você quer pesquisar.

Conferir uma lista de regiões disponíveis

Console

Consulte as regiões disponíveis na página Zonas do consoleGoogle Cloud .

Acesse Zonas

gcloud

Usando a Google Cloud CLI, execute o comando gcloud compute regions list:

gcloud compute regions list

Com esse comando, todas as regiões disponíveis são listadas e você recebe informações como cotas e status da região.

Exemplo:

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

Para receber uma lista de regiões, faça uma solicitação GET ao método regions.list. Substitua PROJECT_ID pelo PROJECT_ID.

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

Conferir informações sobre uma região

Console

Veja informações sobre regiões na página Zonas, no console doGoogle Cloud .

Acesse Zonas

gcloud

Para receber informações sobre uma única região, execute o comando gcloud compute regions describe, em que REGION é o nome dessa região:

gcloud compute regions describe REGION

A resposta será semelhante a esta:

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

Faça uma solicitação GET ao método regions.get para receber informações sobre uma região. Substitua PROJECT_ID pelo PROJECT_ID e REGION pela região de que você quer mais informações.

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

A seguir

Saiba mais sobre Regiões e zonas
Saiba mais sobre Como alterar a região ou a zona padrão
Saiba mais sobre Recursos globais, regionais e zonais

Conferir regiões e zonas disponíveis Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Console

gcloud

REST

Funções exigidas

Exibir uma lista de zonas disponíveis

Console

gcloud

REST

Conferir uma lista de zonas que aceitam aceleradores (GPUs e TPUs)

Pesquisar zonas de IA

Console

gcloud

REST

Pesquisar por tipo de acelerador

gcloud

REST

Pesquisar por tipo de máquina

gcloud

REST

Conferir uma lista de regiões disponíveis

Console

gcloud

REST

Conferir informações sobre uma região

Console

gcloud

REST

A seguir

Conferir regiões e zonas disponíveis