Veja as regiões e as zonas disponíveis

Esta página explica como ver 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 Regiões e zonas.

Para saber mais sobre os recursos globais, regionais e zonais do Motor de Cálculo, consulte a documentação Recursos globais, regionais e zonais.

Antes de começar

  • Se ainda não o tiver feito, configure a autenticação. A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-se 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

    1. Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando:

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    2. Set a default region and zone.

    REST

    Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

      Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando:

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

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

Funções necessárias

Para receber as autorizações de que precisa para ver as regiões e as zonas disponíveis, peça ao seu administrador que lhe conceda a função do IAM Leitor de computação (roles/compute.viewer) no projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Veja uma lista de zonas disponíveis

Consola

Veja uma lista de zonas na página Zonas da Google Cloud consola.

Aceda a Zonas

gcloud

Usando a CLI do Google Cloud, execute o comando gcloud compute zones list:

gcloud compute zones list

REST

Faça um pedido GET ao método zones.list para obter uma lista de zonas de um projeto. Substitua PROJECT_ID pelo seu PROJECT_ID.

https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones

Veja uma lista de zonas de GPU

Para ver uma lista de zonas que suportam GPUs, pode usar a CLI gcloud ou o REST.

gcloud

Pesquise por tipo de GPU

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

Por exemplo, para encontrar todas as zonas com GPUs H100, execute os seguintes comandos:

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

A saída devolve uma lista de GPUs disponíveis organizadas por zona. Em seguida, pode usar o comando gcloud compute accelerator-types describe para obter uma descrição de cada modelo de GPU devolvido.

Pesquise por tipo de máquina

Os tipos de máquinas A3, A2 ou G2 otimizados para aceleradores têm GPUs anexadas automaticamente às VMs. Para estes tipos de máquinas, pode usar o comando gcloud compute machine-types list com a flag --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"

REST

Pesquise por tipo de GPU

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

Por exemplo, para encontrar todas as zonas com GPUs H100, execute as seguintes consultas:

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

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

Pesquise por tipo de máquina

Os tipos de máquinas A3, A2 ou G2 otimizados para aceleradores têm GPUs anexadas automaticamente às VMs. Para estes tipos de máquinas, pode usar o método machineTypes.aggregatedList com o parâmetro --filter para encontrar 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 projeto.

A saída devolve 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

Consola

Veja uma lista de regiões na página Zonas da Google Cloud consola.

Aceda a Zonas

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 as quotas e o estado 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

REST

Faça um pedido GET ao método regions.list para receber uma lista de regiões. Substitua PROJECT_ID pelo seu PROJECT_ID.

https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions

Veja informações sobre uma região

Consola

Pode ver informações sobre regiões na página Zonas na Google Cloud consola.

Aceda a Zonas

gcloud

Para obter informações sobre uma única região, execute o comando gcloud compute regions describe, onde REGION é o nome da região sobre a qual quer 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

REST

Faça um pedido GET ao método regions.get para obter informações sobre uma região. Substitua PROJECT_ID pelo seu PROJECT_ID e REGION pela região sobre a qual quer mais informações.

https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION

O que se segue?