View 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

Required roles

To get the permissions that you need to view available regions and zones, ask your administrator to grant you the Compute Viewer (roles/compute.viewer) IAM role on the project. For more information about granting roles, see Manage access.

You might also be able to get the required permissions through custom roles or other predefined roles.

View 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

View a list of GPU zones

To view a list of zones that support GPUs, you can use gcloud CLI or REST.

gcloud

Search by GPU type

To search by GPU type, use the gcloud compute accelerator-types list command with the --filter flag to find available zones.

For example to find all zones with H100 80GB GPUs, run the following command:

gcloud compute accelerator-types list --filter="nvidia-h100-80gb"

The output returns a list of available GPUs organized by zone. You can then use the gcloud compute accelerator-types describe command to get a description of each GPU model returned.

Search by machine type

A3, A2, or G2 accelerator-optimized machine types have GPUs automatically attached to the VMs. For these machine types, you can use the gcloud compute machine-types list command with the --filter flag to find available zones. For example to find all zones with A3 standard machine types, run the following command:

gcloud compute machine-types list --filter="name=a3-highgpu-8g"

REST

Search by GPU type

To view available zones for a specific GPU model, send a GET request to the acceleratorTypes.aggregatedList method with the --filter parameter .

For example to find all zones with H100 80GB GPUs, run the following command:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/acceleratorTypes?filter=name=nvidia-h100-80gb

Search by machine type

A3, A2, or G2 accelerator-optimized machine types have GPUs automatically attached to the VMs. For these machine types, you can use the machineTypes.aggregatedList method with the --filter parameter to find available zones.

For example to find all zones with A3 standard machine types, run the following command:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=a3-higgpu-8

Replace PROJECT_ID with your Project ID.

The output returns a list of available GPUs and a description of each GPU model, organized by zone.

View 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

View 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