Como visualizar 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.

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

    Console

    Quando você usa o console do Google Cloud para acessar os serviços e as APIs do Google Cloud, não é necessário configurar a autenticação.

    gcloud

    1. Instale a Google Cloud CLI e inicialize-a executando o seguinte comando: 

      gcloud init
    2. 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 inicialize-a executando o seguinte comando: 

      gcloud init

Como visualizar uma lista das zonas disponíveis

Console

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

Acesse Zonas

gcloud

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

gcloud compute zones list

REST

Para receber uma lista de zonas, faça uma solicitação GET ao método zones.get. Substitua PROJECT_ID pelo PROJECT_ID.

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

Ver uma lista das regiões disponíveis

Console

Veja uma lista de regiões na página "Zonas", no console do Google Cloud.

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

Ver informações sobre uma região

Console

Veja informações sobre regiões na página "Zonas", no console do Google Cloud.

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