This page explains how to view a list of available regions and zones and how to get information about a specific region.
To learn more about regions and zones, read the Regions and zones documentation.
To learn more about global, regional, and zonal Compute Engine resources, read the Global, regional, and zonal resources documentation.
Before you begin
- If you want to use the command-line examples in this guide, do the following:
- Install or update to the latest version of the Google Cloud CLI.
- Set a default region and zone.
Viewing a list of available zones
Console
View a list of zones on the Zones page in the Google Cloud console.
gcloud
Using the Google Cloud CLI, run the
gcloud compute zones list
command:
gcloud compute zones list
API
Make a GET
request to the
zones.get
method to get a
list of zones. Replace PROJECT_ID
with your PROJECT_ID.
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones
Viewing a list of available regions
Console
View a list of regions on the Zones page in the Google Cloud console.
gcloud
Using the Google Cloud CLI, run the
gcloud compute regions list
command:
gcloud compute regions list
The command lists all available regions and provides information such as quotas and the status of the region itself.
For example:
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
Make a GET
request to the
regions.get
method to get a
list of regions. Replace PROJECT_ID
with your PROJECT_ID.
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions
Viewing information about a region
Console
You can view information about regions on the Zones page in the Google Cloud console.
gcloud
To get information about a single region, run the gcloud compute
regions describe
command,
where REGION
is the name of the region you want to
get more information about:
gcloud compute regions describe REGION
A response would be similar to the following:
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
Make a GET
request to the
regions.list
method to get
a description of available regions. Replace PROJECT_ID
with your PROJECT_ID
and REGION
with the region you want more
information about.
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION
What's next
- Learn more about Regions and zones
- Learn about Changing the default region or zone
- Learn more about Global, regional, and zonal resources