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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- 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
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.
Papéis obrigatórios
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 como conceder papéis, consulte Gerenciar acesso.Também é possível conseguir as permissões necessárias com papéis personalizados ou 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.
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étodozones.list
para receber uma lista de zonas de um projeto. SubstituaPROJECT_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 padrão A3, 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étodoacceleratorTypes.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 padrão A3, 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.
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étodoregions.list
. SubstituaPROJECT_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.
gcloud
Para receber informações sobre uma única região, execute o comando
gcloud compute regions describe
, em queREGION
é 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étodoregions.get
para receber informações sobre uma região. SubstituaPROJECT_ID
pelo PROJECT_ID eREGION
pela região de que você quer mais informações.https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION
A seguir
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 2024-09-24 UTC.
-