Esta página explica como ver uma lista de regiões e zonas disponíveis e como obter informações sobre uma região específica.
Para saber mais sobre regiões e zonas, leia a documentação Regiões e zonas.
Para saber mais sobre os recursos globais, regionais e zonais do Motor de Cálculo, consulte a documentação Recursos globais, regionais e zonais.
Antes de começar
-
Se ainda não o tiver feito, configure a autenticação.
A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-se no Compute Engine selecionando uma das seguintes opções:
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
-
Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando:
gcloud init
Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.
- Set a default region and zone.
REST
Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.
Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando:
gcloud init
Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.
Para mais informações, consulte o artigo Autenticar para usar REST na Google Cloud documentação de autenticação.
Funções necessárias
Para receber as autorizações de que precisa para ver as regiões e as zonas disponíveis, peça ao seu administrador que lhe conceda a função do IAM Leitor de computação (
roles/compute.viewer
) no projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.
Veja uma lista de zonas disponíveis
Consola
Veja uma lista de zonas na página Zonas da Google Cloud consola.
gcloud
Usando a CLI do Google Cloud, execute o comando
gcloud compute zones list
:gcloud compute zones list
REST
Faça um pedido
GET
ao métodozones.list
para obter uma lista de zonas de um projeto. SubstituaPROJECT_ID
pelo seu PROJECT_ID.https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones
Veja uma lista de zonas de GPU
Para ver uma lista de zonas que suportam GPUs, pode usar a CLI gcloud ou o REST.
gcloud
Pesquise por tipo de GPU
Para pesquisar por tipo de GPU, use o comando
gcloud compute accelerator-types list
com a flag--filter
para encontrar zonas disponíveis.Por exemplo, para encontrar todas as zonas com GPUs H100, execute os seguintes comandos:
gcloud compute accelerator-types list --filter="nvidia-h100-80gb" gcloud compute accelerator-types list --filter="nvidia-h100-mega-80gb"
A saída devolve uma lista de GPUs disponíveis organizadas por zona. Em seguida, pode usar o comando
gcloud compute accelerator-types describe
para obter uma descrição de cada modelo de GPU devolvido.Pesquise por tipo de máquina
Os tipos de máquinas A3, A2 ou G2 otimizados para aceleradores têm GPUs anexadas automaticamente às VMs. Para estes tipos de máquinas, pode usar o comando
gcloud compute machine-types list
com a flag--filter
para encontrar zonas disponíveis. Por exemplo, para encontrar todas as zonas com tipos de máquinas A3 High, execute o seguinte comando:gcloud compute machine-types list --filter="name=a3-highgpu-8g"
REST
Pesquise por tipo de GPU
Para ver as zonas disponíveis para um modelo de GPU específico, envie um pedido
GET
para o métodoacceleratorTypes.aggregatedList
com o parâmetro--filter
.Por exemplo, para encontrar todas as zonas com GPUs H100, execute as seguintes 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
Pesquise por tipo de máquina
Os tipos de máquinas A3, A2 ou G2 otimizados para aceleradores têm GPUs anexadas automaticamente às VMs. Para estes tipos de máquinas, pode usar o método
machineTypes.aggregatedList
com o parâmetro--filter
para encontrar zonas disponíveis.Por exemplo, para encontrar todas as zonas com tipos de máquinas A3 High, execute o seguinte comando:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=a3-higgpu-8
Substitua
PROJECT_ID
pelo ID do projeto.A saída devolve uma lista de GPUs disponíveis e uma descrição de cada modelo de GPU, organizada por zona.
Veja uma lista de regiões disponíveis
Consola
Veja uma lista de regiões na página Zonas da Google Cloud consola.
gcloud
Usando a CLI do Google Cloud, execute o comando
gcloud compute regions list
:gcloud compute regions list
O comando lista todas as regiões disponíveis e fornece informações como as quotas e o estado da própria região.
Por 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
Faça um pedido
GET
ao métodoregions.list
para receber uma lista de regiões. SubstituaPROJECT_ID
pelo seu PROJECT_ID.https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions
Veja informações sobre uma região
Consola
Pode ver informações sobre regiões na página Zonas na Google Cloud consola.
gcloud
Para obter informações sobre uma única região, execute o comando
gcloud compute regions describe
, ondeREGION
é o nome da região sobre a qual quer obter mais informações:gcloud compute regions describe REGION
Uma resposta seria semelhante à seguinte:
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 um pedido
GET
ao métodoregions.get
para obter informações sobre uma região. SubstituaPROJECT_ID
pelo seu PROJECT_ID eREGION
pela região sobre a qual quer mais informações.https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION
O que se segue?
- Saiba mais sobre regiões e zonas
- Saiba como alterar a região ou a zona predefinida
- Saiba mais sobre os recursos globais, regionais e zonais
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-09-23 UTC.
-