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 selecionando uma das seguintes opções:
Select the tab for how you plan to use the samples on this page:
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
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
Veja uma lista de zonas na página "Zonas", no console do Google Cloud.
Usando a Google Cloud CLI, execute o comando gcloud compute zones list
:
gcloud compute zones list
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.
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"
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
Veja uma lista de regiões na página "Zonas", no console do Google Cloud.
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
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
Veja informações sobre regiões na página "Zonas", no console do Google Cloud.
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 describeREGION
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
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