Esta página explica como visualizar 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 sobre regiões e zonas .
Para saber mais sobre os recursos globais, regionais e zonais do Compute Engine, leia a documentação sobre recursos globais, regionais e zonais .
Antes de começar
- Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar 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
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
- Saiba mais sobre regiões e zonas
- Saiba mais sobre como alterar a região ou 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.
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.
Funções obrigatórias
Para obter as permissões necessárias para visualizar regiões e zonas disponíveis, peça ao administrador para conceder a você a função do IAM Compute Viewer (
roles/compute.viewer
) no projeto. Para obter mais informações sobre a concessão de funções, consulte Gerenciar acesso a projetos, pastas e organizações .Você também poderá obter as permissões necessárias por meio de funções personalizadas ou outras funções predefinidas .
Ver uma lista de zonas disponíveis
Console
Veja uma lista de zonas na página Zonas no console do Google Cloud.
gcloud
Usando a CLI do Google Cloud, execute o comando
gcloud compute zones list
:gcloud compute zones list
DESCANSAR
Faça uma solicitação
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 GPU
Para visualizar uma lista de zonas compatíveis com GPUs , você pode usar a CLI gcloud ou REST.
gcloud
Pesquise por tipo de GPU
Para pesquisar por tipo de GPU, use o comando
gcloud compute accelerator-types list
com a sinalização--filter
para encontrar 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. Você pode então usar o comando
gcloud compute accelerator-types describe
para obter uma descrição de cada modelo de GPU retornado.Pesquise por tipo de máquina
Os tipos de máquinas otimizadas para aceleradores A3, A2 ou G2 têm GPUs anexadas automaticamente às VMs. Para esses tipos de máquina, você pode usar o comando
gcloud compute machine-types list
com a sinalização--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"
DESCANSAR
Pesquise 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
Pesquise por tipo de máquina
Os tipos de máquinas otimizadas para aceleradores A3, A2 ou G2 têm GPUs anexadas automaticamente às VMs. Para esses tipos de máquina, você pode usar o método
machineTypes.aggregatedList
com o parâmetro--filter
para localizar 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 seu projeto.A saída retorna 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
Console
Veja uma lista de regiões na página Zonas no console do Google Cloud.
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 cotas e o status 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
DESCANSAR
Faça uma solicitação
GET
aoregions.list
para obter uma lista de regiões. SubstituaPROJECT_ID
pelo seu PROJECT_ID .https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions
Ver informações sobre uma região
Console
Você pode visualizar informações sobre regiões na página Zonas no console do Google Cloud.
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 você deseja 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
DESCANSAR
Faça uma solicitação
GET
aoregions.get
para obter informações sobre uma região. SubstituaPROJECT_ID
pelo seu PROJECT_ID eREGION
pela região sobre a qual você deseja obter mais informações.https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION
O que vem 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 2025-04-21 UTC.
-