View and manage quotas

This page describes how you can view quota values in both the Google Cloud console and the API dashboard. You can also manage quota from the Google Cloud console, Google Cloud CLI, and Service Usage API.

View quotas in the Google Cloud console

You can view your current quota values in two different areas of the Google Cloud console:

• The Quotas page, which lists all quota usage and values for your project.
• The Google Cloud console API dashboard, which lists quota information for a particular API, including resource usage over time.

View the quotas for your project

To view quota usage and values for all resources in your project, follow these steps:

1. In the Google Cloud console, go to the Quotas page.

   Go to Quotas

   The remaining steps will appear automatically in the Google Cloud console.

2. To focus on the information that you need, you can filter and sort the list as follows:

   • To filter the list, enter the desired properties and values in the Filter field. For example, to view the BigQuery API quotas, select Service, and then select BigQuery API.

   • To sort the list, click the heading of the column you want to sort by. For example, to sort alphabetically by the quota name, click the Quota column heading.

     By default, the list is sorted to show your most used quotas first, which helps you see limits that are at risk of being exceeded.

The Quotas page displays a table with configurable columns. The Service and Quota columns provide general information about which quota is being described. For example, the Service might be Cloud Logging API and the Quota might be Log ingestion requests per minute. The Quota field also describes how the quota is evaluated. Rate quotas are evaluated per minute, per 100 seconds, or per day. Quotas without any of these statements are allocation quotas.

You can find additional information about the quota by using the Metric, Limit name, and Monitored resource columns. These columns provide the detailed information needed to chart a quota.

For information about your quota usage, view the Current usage percentage and Current usage columns. Current usage is calculated according to the following criteria:

• For per-minute rate quotas:

  • The average per minute usage in the past 10 minutes.

• For per-day rate quotas:

  • The total usage so far in the current day, according to Pacific Standard Time.

• For allocation quotas:

  • The most recent value. For example, this number might show the number of load balancers in use by your project.

• For concurrent quotas:

  • The most recent value. For example, this number might show the number of in-flight insert_operations for a given service.

To view a usage chart, click the chart icon in the far right column.

You can learn more about quotas for a specific service by reading the documentation for that service. For example, Compute Engine quota is documented in Resource quotas.

View API-specific quota

To view detailed quota information for a particular API, including usage over time, visit the quota page for the API in the Google Cloud console. Depending on the API, these limits can include requests per day, requests per minute, and requests per minute per user. Some APIs set very low limits until you enable billing on your project.

You can view the current limits for a particular API in two different areas of the Google Cloud console:

• On the Google Cloud console Quotas page.

• On the Google Cloud console APIs & Services Dashboard page. On this page, select your project, click the API name, and then click Quotas. The Quotas page shows the quota names for the API. You can click the Show usage chart icon for each quota to see detailed usage over time. By default, the values displayed are imposed by Google. You can cap usage as described in the Cap usage section. If there is no Google-imposed value on a given quota, the value is displayed as Unlimited.

Manage your quota using the Google Cloud console

Depending on your resource usage, you might want to adjust the quota values of your project up or down. This section describes how to change the provided quota values. To see the values, in the Details column, click All Quotas.

Filter quotas

To filter the list of quotas by specific properties:

1. Go to the Quotas page in the Google Cloud console:

   Go to Quotas

2. Click Filter to query your quota by a specific property.

Request a higher quota

To request a higher quota value using the Google Cloud console:

1. Go to the Quotas page:

   Go to Quotas

   The remaining steps will appear automatically in the Google Cloud console.

2. On the Quotas page, find the quota you want to increase in the Quota column.

   You can use the Filter search box to search for your quota.

3. Select the checkbox to the left of your quota.

4. Click EDIT QUOTAS. The Quota changes form displays.

5. In the Quota changes form, enter the increased quota that you want for your project in the New limit field.

6. Complete any additional fields in the form, and then click DONE.

7. Click SUBMIT REQUEST.

While the previous procedure applies to most quota increase requests, you might encounter one of the following exceptions:

• In the case where there is an existing usage cap, the usage cap must be removed before the quota can be increased. You will be presented with a disclosure and agreement. The disclosure states that the usage cap will be deleted and the limit will be updated to the default limit immediately. Your quota increase request will then be processed by Google Cloud normally.
• Sometimes, the Google Cloud console redirects you to a separate form to request an increased limit. After you submit the form, Google Cloud acknowledges your request by email.
• Some quotas cannot be updated using the Google Cloud console. If you find that you cannot change a quota from the console, request the increase from Cloud Customer Care. The Billing team does not handle quota limit increases.

Google recommends that you create a different quota increase request for each class of resources. For example, you should separate the per-project network quota increases from the non-networking Compute Engine quota increases. If different classes of requests are combined, one increase request can delay the batch if its approval requires more evaluation time.

If your quota increase request requires approval, you can expect to receive an email from Google Cloud acknowledging receipt of your request. If you need further assistance, you can respond to the email . Cloud Customer Care typically processes your request within 2-3 business days. Cloud Customer Care then sends you a second email notifying you whether the quota increase was approved or denied. The email provides the effective date of the increase, if applicable.

To find out more about how the quota increase process works, see About quota increase requests.

View quota increase requests

You can see pending and past quota increase requests in the Google Cloud console.

To see pending quota increase requests:

1. Ensure that you have permission to view quota increase requests.

2. Go to the Quotas page:

   Go to Quotas

3. On the Quotas page, Pending is shown next to the quota values that are pending a decision on previously submitted increase requests. You can click Pending to view details of the pending requests.

Pending requests are also shown in the Quota changes form when a new quota increase request is about to be submitted.

To view all quota increase requests (currently pending and past requests):

1. Go to the Quotas page:

   Go to Quotas

2. Click the Increase Requests tab.

3. Click Filter to query your quota increase requests by a specific property.

When an organization or folder is selected, the page shows all quota increase requests for all projects within the organization or folder.

Cap usage

You might want to limit usage of a particular resource by setting your own quota values. For example, to prevent getting billed for usage beyond the free courtesy usage, you can request per-day caps.

To cap a quota, follow the same steps as for requesting a higher quota.

Capping usage with quotas does not apply to all services. Check the specific quota page for your service for more information.

Note: Usage caps are sometimes referred to as overrides.

Manage your quota using the Google Cloud CLI

You can use the Google Cloud CLI to get current quotas values and limit usage for some Google Cloud APIs and services. Including project-, folder-, and organization-level quotas where available.

To use this approach, first ensure that you have installed and initialized the latest version of the Google Cloud CLI, including the alpha commands component. If you're using Cloud Shell to interact with Google Cloud, the Google Cloud CLI is installed for you.

To view a quota for a particular service, run the following command, substituting your project ID and service name:

gcloud alpha services quota list \
   --service=SERVICE_NAME.googleapis.com \
   --consumer=projects/PROJECT_ID

To view the same service's quota details for an organization:

gcloud alpha services quota list \
   --service=SERVICE_NAME.googleapis.com \
   --consumer=organizations/ORG_ID

For a complete list of gcloud quota commands and flags, see the Google Cloud CLI reference.

In addition to gcloud quota, some services have their own command-line access to quota and resource usage information. For example, Compute Engine lets you access quota information with gcloud compute.

Manage your quota using the Service Usage API

You can use the Service Usage APIs to get current quotas values and limit the quota usage for some Google Cloud APIs and services. For more information about Service Usage, see the following:

• For an overview, see What is Service Usage?
• For an API reference, see APIs and reference.
• For usage guides, see How-to guides.

You cannot use the Service Usage API to request a higher quota. For this activity, you must use the Google Cloud console.