Enable quota adjuster

This document explains how you can automatically submit quota increase requests for your project by using Capacity Planner.

When using Capacity Planner, you can enable quota adjuster for the Compute Engine resources in your project. This allows Google Cloud to automatically submit quota increase requests on your behalf when your quota nears a limit. Enabling quota adjuster is helpful to proactively respond to planned or unplanned growths in consumption, prevent outages when reaching a quota limit, and reduce the need to submit manual quota increase requests.

If you want to disable quota adjuster in your project, see Disable quota adjuster instead.

Before you begin

  • If you can't access Capacity Planner or quota adjuster in the Google Cloud console, your project might not be eligible to access and use these products. To enable your project to use Capacity Planner and quota adjuster, contact your Technical Account Manager or the Sales team.

  • If you haven't already, review how Capacity Planner works.

Required roles

To get the permissions that you need to manage quota adjuster in Capacity Planner, ask your administrator to grant you the following IAM roles:

  • To access and view Capacity Planner: Capacity Planner Viewer (roles/capacityplanner.viewer) on the project
  • To access and manage quota adjuster in your project: Quota Administrator (roles/servicemanagement.quotaAdmin) on the project

For more information about granting roles, see Manage access.

These predefined roles contain the permissions required to manage quota adjuster in Capacity Planner. To see the exact permissions that are required, expand the Required permissions section:

Required permissions

The following permissions are required to manage quota adjuster in Capacity Planner:

  • To view the forecasted usage of your VMs or persistent disks: capacityplanner.forecasts.list on the project
  • To view the actual usage of your VMs or persistent disks: capacityplanner.usageHistories.list on the project
  • To summarize the actual usage of your VMs or persistent disks: capacityplanner.usageHistories.summarize on the project
  • To view quota adjuster settings: cloudquotas.quotas.get on the project
  • To enable or disable quota adjuster: cloudquotas.quotas.update on the project
  • To access your project's quota usage: monitoring.timeseries.list on the project
  • To view your project's quota:
    • serviceusage.quotas.get on the project
    • serviceusage.services.get on the project

You might also be able to get these permissions with custom roles or other predefined roles.

Limitations

The following limitations apply for quota adjuster:

  • You can't enable quota adjuster for an organization.

  • You can enable quota adjuster in your project only if your project has sufficient usage data.

  • You can enable quota adjuster for specific Compute Engine resources only. For more information, see Availability.

Enable quota adjuster

To enable quota adjuster in your project using the Google Cloud console, do the following:

  1. In the Google Cloud console, go to the Capacity Planner page.

    Go to Capacity Planner

  2. Click the Virtual machine tab (default).

  3. In the Usage and forecast by machine family graph, do the following:

    1. To view your project's quota for your resources, click View quota (default).

    2. Click Enable quota adjuster.

    The Quotas page opens and the Configurations tab is selected.

  4. To enable quota adjuster, click Enable.

After you've enabled quota adjuster, you can monitor quota adjuster by creating alert policies.

What's next