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. A autenticação é o processo de verificação da sua identidade para acesso a serviços e APIs do Google Cloud. Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine da seguinte maneira.

    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. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.

Funções exigidas

Para receber as permissões necessárias a fim de conferir a disponibilidade das regiões e zonas, 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

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 da GPU

Para conferir uma lista de zonas com suporte a GPUs, use a gcloud CLI ou REST.

gcloud

Pesquisar por tipo de GPU

Para pesquisar por tipo de GPU, use o comando gcloud compute accelerator-types list com a flag --filter para encontrar as zonas disponíveis.

Por exemplo, para encontrar todas as zonas com GPUs H100 de 80 GB, execute o seguinte comando:

gcloud compute accelerator-types list --filter="nvidia-h100-80gb"

A saída retorna uma lista de GPUs disponíveis organizadas por zona. Em seguida, use o comando gcloud compute accelerator-types describe para conferir uma descrição de cada modelo de GPU retornado.

Pesquisar por tipo de máquina

Os tipos de máquina com otimização de aceleradores A3, A2 ou G2 têm GPUs automaticamente anexadas às VMs. Para esses tipos de máquina, use o comando gcloud compute machine-types list com a flag --filter para encontrar as zonas disponíveis. Por exemplo, para encontrar todas as zonas com os tipos de máquina A3 High, execute o seguinte comando:

gcloud compute machine-types list --filter="name=a3-highgpu-8g"

REST

Pesquisar por tipo de GPU

Para visualizar as zonas disponíveis para um modelo de GPU específico, envie uma solicitação GET para o método acceleratorTypes.aggregatedList com o parâmetro --filter.

Por exemplo, para encontrar todas as zonas com GPUs H100 de 80 GB, execute o seguinte comando:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/acceleratorTypes?filter=name=nvidia-h100-80gb

Pesquisar por tipo de máquina

Os tipos de máquina com otimização de aceleradores A3, A2 ou G2 têm GPUs automaticamente anexadas às VMs. Para esses tipos de máquina, use o método machineTypes.aggregatedList com o parâmetro --filter para encontrar as zonas disponíveis.

Por exemplo, para localizar todas as zonas com tipos de máquina 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 retorna uma lista de GPUs disponíveis e uma descrição de cada modelo de GPU, organizada por zona.

Conferir uma lista de regiões disponíveis

Console

Veja uma lista de regiões na página "Zonas", no console do Google 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 do Google 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