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.
Selecione a guia para como planeja usar as amostras nesta página:
Console
Quando você usa o console do Google Cloud para acessar os serviços e as APIs do Google Cloud, não é necessário configurar a autenticação.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Defina uma região e uma zona padrão.
REST
Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
-
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é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 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é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 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é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.
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