Enable the quota adjuster in Capacity Planner

Private preview

This product is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products are available "as is" and might have limited support. For more information, see the launch stage descriptions.

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.

To disable the quota adjuster in your project, see Disable the quota adjuster.

Before you begin

• If you can't access Capacity Planner in the Google Cloud console, then your organization might not be eligible to access and use Capacity Planner. To request access, contact your Technical Account Manager (TAM) 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:

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

For more information about granting roles, see Manage access to projects, folders, and organizations.

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 usage of your Compute Engine resources: capacityplanner.usageHistories.list on the project
• To summarize the 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 folder or 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. Optional: To change project, in the project picker at the top of the page, select another project.

3. On the Virtual machine tab (default), in the Usage and forecast by machine family graph, click Enable quota adjuster.

   

   The Quotas page opens and the Configurations tab is selected.

4. 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

• Read an overview of quotas and limits for Compute Engine.

• Learn how to audit logging information for Capacity Planner.