Ver regiões e zonas disponíveis


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

    1. 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.

    2. Set a default region and zone.
    3. 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.

Vá para zonas

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é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 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é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

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.

Vá para 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 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 ao regions.list para obter uma lista de regiões. Substitua PROJECT_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.

Vá para 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 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 ao 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 você deseja obter mais informações.

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

O que vem a seguir