View available regions and zones
This page explains how to view a list of available regions and zones and how toget information about a specific region.
To learn more about regions and zones, read theRegions and zones documentation.
To learn more about global, regional, and zonal Compute Engineresources, read theGlobal, regional, and zonal resourcesdocumentation.
Before you begin
- If you haven't already, set upauthentication. Authentication verifies your identity for access to Google Cloud services and APIs. To run code or samples from a local development environment, you can authenticate to Compute Engine by selecting one of the following options:
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
Install the Google Cloud CLI. After installation,initialize the Google Cloud CLI by running the following command:
gcloudinit
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Note: If you installed the gcloud CLI previously, make sure you have the latest version by runninggcloud components update.- 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. After installation,initialize the Google Cloud CLI by running the following command:
gcloudinit
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Note: If you installed the gcloud CLI previously, make sure you have the latest version by runninggcloud components update.For more information, seeAuthenticate for using REST in the Google Cloud authentication documentation.
Required roles
To get the permissions that you need to view available regions and zones, ask your administrator to grant you theCompute Viewer (roles/compute.viewer) IAM role on the project. For more information about granting roles, seeManage access to projects, folders, and organizations.
You might also be able to get the required permissions throughcustom roles or otherpredefined roles.
View 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 thegcloud compute zones list command:
gcloud compute zones list
REST
Make aGET request to thezones.list method to get alist of zones for a project. ReplacePROJECT_IDwith yourPROJECT_ID.
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones
View a list of GPU zones
To view a list of zones that supportGPUs, you can use gcloud CLI or REST.
gcloud
Search by GPU type
To search by GPU type, use thegcloud compute accelerator-types list commandwith the--filter flag to find available zones.
For example to find all zones with H100 GPUs, run the followingcommands:
gcloud compute accelerator-types list --filter="nvidia-h100-80gb"gcloud compute accelerator-types list --filter="nvidia-h100-mega-80gb"
The output returns a list of available GPUs organized by zone. You canthen use thegcloud compute accelerator-types describe commandto get a description of each GPU model returned.
Search by machine type
A3, A2, or G2accelerator-optimized machinetypes have GPUs automatically attached to the VMs.For these machine types, you can use thegcloud compute machine-types list commandwith the--filter flag to find available zones. For example to find allzones with A3 High 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 aGET request to theacceleratorTypes.aggregatedList methodwith the--filter parameter .
For example to find all zones with H100 GPUs, run the following queries:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/acceleratorTypes?filter=name=nvidia-h100-80gb
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/acceleratorTypes?filter=name=nvidia-h100-mega-80gb
Search by machine type
A3, A2, or G2accelerator-optimized machinetypes have GPUs automatically attached to the VMs.For these machine types, you can use themachineTypes.aggregatedList methodwith the--filter parameter to find available zones.
For example to find all zones with A3 High machine types, run thefollowing command:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=a3-higgpu-8
ReplacePROJECT_ID with your Project ID.
The output returns a list of available GPUs and a description of eachGPU 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.
gcloud
Using the Google Cloud CLI, run thegcloud compute regions list command:
gcloud compute regions list
The command lists all available regions and provides information such asquotas and the status of the region itself.
For example:
gcloud compute regions listNAME CPUS DISKS_GB ADDRESSES RESERVED_ADDRESSES STATUSasia-east1 0/24 0/10240 0/23 0/7 UPasia-northeast1 0/24 0/10240 0/23 0/7 UPasia-southeast1 0/24 0/10240 0/23 0/7 UPeurope-west1 0/24 0/10240 2/23 0/7 UPus-central1 0/24 0/10240 0/23 0/7 UPus-east1 0/24 0/10240 0/23 0/7 UPus-west1 0/24 0/10240 0/23 0/7 UP
REST
Make aGET request to theregions.list method toget a list of regions. ReplacePROJECT_IDwith yourPROJECT_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.
gcloud
To get information about a single region, run thegcloud computeregions describe command,whereREGION is the name of the region you want toget more information about:
gcloud compute regions describeREGION
A response would be similar to the following:
creationTimestamp:'2013-09-06T17:54:12.193-07:00'description:us-central1id:'5778272079688511892'kind:compute#regionname:us-central1quotas:-limit:24.0metric:CPUSusage:5.0-limit:5120.0metric:DISKS_TOTAL_GBusage:650.0-limit:7.0metric:STATIC_ADDRESSESusage:4.0-limit:23.0metric:IN_USE_ADDRESSESusage:5.0-limit:1024.0metric:SSD_TOTAL_GBusage:0.0selfLink:https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/us-central1status:UPzones:-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-fREST
Make aGET request to theregions.get method to getinformation about a region. ReplacePROJECT_IDwith yourPROJECT_IDandREGION with the region you want moreinformation about.
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION
What's next
- Learn more aboutRegions and zones
- Learn aboutChanging the default region or zone
- Learn more aboutGlobal, regional, and zonal resources
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-12-09 UTC.