Quotas and system limits

This document lists the quotas and system limits that apply to Cloud Workstations. Quotas specify the amount of a countable, shared resource that you can use, and they are defined by Google Cloud services such as Cloud Workstations. System limits are fixed values that cannot be changed.

Google Cloud uses quotas to help ensure fairness and reduce spikes in resource use and availability. A quota restricts how much of a Google Cloud resource your Google Cloud project can use. Quotas apply to a range of resource types, including hardware, software, and network components. For example, quotas can restrict the number of API calls to a service, the number of load balancers used concurrently by your project, or the number of projects that you can create. Quotas protect the community of Google Cloud users by preventing the overloading of services. Quotas also help you to manage your own Google Cloud resources.

The Cloud Quotas system does the following:

  • Monitors your consumption of Google Cloud products and services
  • Restricts your consumption of those resources
  • Provides a way to request changes to the quota value

In most cases, when you attempt to consume more of a resource than its quota allows, the system blocks access to the resource, and the task that you're trying to perform fails.

Quotas generally apply at the Google Cloud project level. Your use of a resource in one project doesn't affect your available quota in another project. Within a Google Cloud project, quotas are shared across all applications and IP addresses.

There are also system limits on Cloud Workstations resources. System limits can't be changed.

System limits per region per project

The default Cloud Workstations resource limits per region per project are as follows:

Resource limit Value
Workstation clusters 3
Workstation configurations 12
Workstations 9000

Additionally, each workstation cluster supports 3,000 concurrently running workstations.

To restrict the number of workstations per configuration, see Limit the number of workstations per developer.

System limits for API requests

The default rate limit for the Cloud Workstations API per project read and write requests is as follows:

Default rate limit Value
Read requests 180 QPS
Write requests 60 QPS

Quota needed for workstation VMs

For the virtual machines (VMs) that workstations run on, you must allocate the following resources:

  • CPU quota
  • Persistent Disk quota
  • If the VMs have external IP addresses, you need IP address quota
  • Sufficient space in your Virtual Private Cloud (VPC) for the internal IP address for the VM

    To use a workstation configuration, make sure that there are sufficient IP addresses available in your VPC. To calculate how many IP addresses need to be available, add these values:

    • Start by adding 1 for each concurrently running workstation that you expect to create using this configuration.
    • If you enabled Quick start workstations, also add the value that you specified for the Quick start pool size.
    • Lastly, add 1 for the IP address used to establish a connection between the Cloud Workstations controller and your VPC.

Request a quota increase

To adjust most quotas, use the Google Cloud console. For more information, see Request a quota adjustment.