Conferir regiões e zonas disponíveis

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. Com isso, você confirma sua identidade para acesso a serviços e APIs do Cloud de Confiance by S3NS . Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine selecionando uma das seguintes opções:

    Selecione a guia para como planeja usar as amostras nesta página:

    Console

    Quando você usa o console Cloud de Confiance para acessar serviços Cloud de Confiance by S3NS e APIs, não é necessário configurar a autenticação.

    gcloud

    1. Instale a Google Cloud CLI e faça login na CLI gcloud com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando: 

      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.

      Instale a Google Cloud CLI e faça login na CLI gcloud com sua identidade federada.

    Saiba mais em Autenticar para usar REST na documentação de autenticação do Cloud de Confiance .

Funções exigidas

Para receber as permissões necessárias para ver as regiões e zonas disponíveis, 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

Uma zona é uma área de implantação em uma região. Algumas regiões têm zonas especializadas que oferecem capacidade significativa para aceleradores de alta demanda (GPUs e TPUs). Essas zonas especializadas são chamadas de zonas de IA, ideais para cargas de trabalho de IA e ML.

Para conferir uma lista de zonas disponíveis, incluindo as de IA, use uma das seguintes opções:

Console

Veja uma lista de zonas na página Zonas, no console do Cloud de Confiance .

Acesse Zonas

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 que aceitam aceleradores (GPUs e TPUs)

Para conferir uma lista de zonas que aceitam aceleradores (GPUs e TPUs), use um dos seguintes métodos:

Pesquisar zonas de IA

Se você quiser executar cargas de trabalho de IA e ML, considere usar zonas de IA. É possível identificar uma zona de IA pela string ai no nome dela. Por exemplo, us-central1-ai1a é uma zona de IA na região us-central1, com us-central1-a como zona principal. Para saber mais, consulte Zonas de IA.

O console Cloud de Confiance lista as zonas de IA com outras zonas, agrupadas por regiões. Para conferir uma lista de zonas de IA disponíveis, use a CLI gcloud ou a API REST.

Console

No console Cloud de Confiance , a página Zonas lista as zonas de IA em uma região onde elas têm suporte. É possível identificar uma zona de IA pela string AI no nome dela. Por exemplo, a região us-central1 lista Zone AI1A.

Acesse Zonas

gcloud

Use o comando gcloud compute zones list e filtre as zonas que contêm a string ai:

gcloud compute zones list \
    --filter="name~'-ai'"

REST

Faça uma solicitação GET ao método zones.list. Para corresponder a zonas que contenham ai no nome, use o parâmetro de consulta filter com a expressão regular name eq '.*-ai.*'.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones?filter=name%20eq%20'.*-ai.*'

Substitua PROJECT_ID pelo PROJECT_ID.

Pesquisar por tipo de acelerador

A pesquisa por um tipo de acelerador retorna todas as zonas, incluindo as de IA, em que esse acelerador é compatível.

gcloud

Para pesquisar por tipo de acelerador, use o comando gcloud compute accelerator-types list com a flag --filter.

Por exemplo, para encontrar todas as zonas com um acelerador específico, como uma GPU NVIDIA B200 ou uma Cloud TPU v6e (Trillium), execute um dos seguintes comandos:

  • NVIDIA B200

      gcloud compute accelerator-types list \
      --filter="name=nvidia-b200" \
      --format="value(zone)"

  • Cloud TPU v6e (Trillium)

      gcloud compute accelerator-types list \
      --filter="name=ct6e" \
      --format="value(zone)"

Substitua o tipo de acelerador no exemplo pelo tipo que você quer pesquisar.

REST

Para pesquisar por tipo de acelerador, envie uma solicitação GET para o método acceleratorTypes.aggregatedList com o parâmetro filter.

Por exemplo, para encontrar todas as zonas com um acelerador específico, como uma GPU NVIDIA B200 ou uma Cloud TPU v6e (Trillium), execute um dos seguintes comandos:

  • NVIDIA B200 

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

  • Cloud TPU v6e (Trillium) 

      GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/acceleratorTypes?filter=name=ct6e

Substitua o tipo de acelerador no exemplo pelo tipo que você quer pesquisar.

Pesquisar por tipo de máquina

A pesquisa por um tipo de máquina retorna todas as zonas, incluindo as de IA, em que esse tipo de máquina é compatível.

gcloud

Para pesquisar por tipo de máquina, use o comando gcloud compute machine-types list com a flag --filter.

Por exemplo, para encontrar todas as zonas com um tipo de máquina específico, como a4-highgpu-8g A4 ou ct6e-standard-4t Cloud TPU v6e (Trillium), execute um dos seguintes comandos:

  • a4-highgpu-8g Tipo de máquina A4

      gcloud compute machine-types list \
      --filter="name=a4-highgpu-8g" \
      --format="value(zone)"

  • Tipo de máquina ct6e-standard-4t Cloud TPU v6e (Trillium)

      gcloud compute machine-types list \
      --filter="name=ct6e-standard-4t" \
      --format="value(zone)"

Substitua o tipo de máquina no exemplo pelo tipo de máquina que você quer pesquisar.

REST

Para pesquisar por tipo de máquina, faça uma solicitação GET ao método machineTypes.aggregatedList com o parâmetro filter.

Por exemplo, para encontrar todas as zonas com um tipo de máquina específico, como a4-highgpu-8g A4 ou ct6e-standard-4t Cloud TPU v6e (Trillium), execute um dos seguintes comandos:

  • a4-highgpu-8g Tipo de máquina A4

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=a4-highgpu-8g

  • Tipo de máquina ct6e-standard-4t Cloud TPU v6e (Trillium)

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=ct6e-standard-4t

Substitua PROJECT_ID pelo ID do projeto e o tipo de máquina pelo tipo que você quer pesquisar.

Excluir zonas de IA das listas

Se você tiver acesso às zonas de IA, mas não quiser que elas apareçam nas listagens de zonas, use filtros para excluí-las. Isso pode acontecer se você estiver usando serviços que as zonas de IA não oferecem suporte ou se tiver uma automação que depende da lista de zonas. É possível identificar as zonas de IA pelo sufixo -ai nos nomes delas.

gcloud

Para excluir zonas de IA da lista de zonas disponíveis, use o comando gcloud compute zones list e filtre as zonas que contêm a string -ai:

gcloud compute zones list --filter 'name !~ ".*-ai.*"'

Para filtrar as zonas de IA ao listar tipos de máquinas, use o comando gcloud compute machine-types list e filtre as zonas que contêm a string -ai:

gcloud compute machine-types list --filter 'zone !~ ".*-ai.*"'

REST

Para excluir zonas de IA dos resultados da API, use a expressão regular name ne ".*-ai.*" no parâmetro de consulta de filtro. Ao adicionar esse filtro a um URL, você precisa codificar o parâmetro de consulta do filtro como filter=name%20ne%20%22.%2A-ai.%2A%22.

https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones?filter=name%20ne%20%22.%2A-ai.%2A%22

Substitua PROJECT_ID pelo PROJECT_ID.

Terraform

Para excluir zonas de IA da lista de zonas disponíveis, crie uma função local, como no exemplo a seguir:

# Fetch zones from API
data "google_compute_zones" "available" {
  project = var.my_project_id
  region  = var.my_region
  status  = "UP"
}

locals {
  # Filter the list in Terraform
  non_ai_zones = [
    for zone in data.google_compute_zones.available.names : zone
    if !strcontains(zone, "-ai")
  ]
}

# Example usage
output "standard_gce_zones" {
  description = "List of zones, excluding AI/ML zones."
  value       = locals.non_ai_zones
}

Conferir uma lista de regiões disponíveis

Console

Consulte as regiões disponíveis na página Zonas do consoleCloud de Confiance .

Acesse Zonas

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 doCloud de Confiance .

Acesse Zonas

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