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
- Para usar os exemplos de linha de comando deste guia, faça o seguinte:
- Instale ou atualize para a versão mais recente da Google Cloud CLI.
- Defina uma região e uma zona padrão.
Como visualizar uma lista das zonas disponíveis
Console
Veja uma lista de zonas na página "Zonas", no console do Google Cloud.
gcloud
Usando a Google Cloud CLI, execute o comando gcloud compute zones list
:
gcloud compute zones list
API
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.
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
API
Para receber uma
lista de regiões, faça uma solicitação GET
ao
método regions.get
. 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.
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
API
Faça uma solicitação GET
ao
método regions.list
para ver uma
descrição das regiões disponíveis. 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
- Saiba mais sobre Regiões e zonas
- Saiba mais sobre Como alterar a região ou a zona padrão
- Saiba mais sobre Recursos globais, regionais e zonais