Enable the quota adjuster in Capacity Planner

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 the 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 the 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 the quota adjuster in your project, then see Disable the quota adjuster instead.

Before you begin

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

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

Required roles

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

For more information about granting roles, see Manage access.

These predefined roles contain the permissions required to manage the 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 the quota adjuster in Capacity Planner:

  • To view the forecasted usage of your Compute Engine resources: capacityplanner.forecasts.list on the project
  • To view the actual usage of your Compute Engine resources: capacityplanner.usageHistories.list on the project
  • To summarize the actual usage of your Compute Engine resources: capacityplanner.usageHistories.summarize on the project
  • To view the quota adjuster settings: cloudquotas.quotas.get on the project
  • To enable or disable the 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 the quota adjuster:

  • You can't enable the quota adjuster for a Google Cloud organization.

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

  • You can enable the quota adjuster for specific Compute Engine resources only. For more information, see Availability in the Cloud Quotas documentation.

Enable the quota adjuster

To enable the quota adjuster in your project, do the following:

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

    Go to Capacity Planner

  2. On the Virtual machine tab (default), 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.

  3. To enable the quota adjuster, click Enable.

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

What's next