Viewing available regions and zones


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 haven't already, set up authentication. Authentication is the process by which your identity is verified for access to Google Cloud services and APIs. To run code or samples from a local development environment, you can authenticate to Compute Engine as follows.

    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. Install the Google Cloud CLI, then initialize it by running the following command:

      gcloud init
    2. Set a default region and zone.

    REST

    To use the REST API samples on this page in a local development environment, you use the credentials you provide to the gcloud CLI.

      Install the Google Cloud CLI, then initialize it by running the following command:

      gcloud init

Viewing a list of available zones

Console

View a list of zones on the Zones page in the Google Cloud console.

Go to Zones

gcloud

Using the Google Cloud CLI, run the gcloud compute zones list command:

gcloud compute zones list

REST

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.

Go to Zones

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

REST

Make a GET request to the regions.list 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.

Go to Zones

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

REST

Make a GET request to the regions.get method to get information about a region. 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