View and manage quotas

This document describes how you can view quota values in the Google Cloud console. You can also manage quotas from the Google Cloud console, Cloud Quotas API, and Google Cloud CLI (gcloud CLI).

Limitations

Cloud Quotas has the following limitations:

  • In most cases, quota increase adjustments must be made at the project-level. A limited number of products support organization-level quota increase adjustments. To see if a Google Cloud product supports organization-level quota increase adjustments, refer to the documentation for that product.

  • You can request quota decrease adjustments for project-, organization-, and folder-level quotas.

Before you begin

The tasks in this document require Identity and Access Management (IAM) roles.

Required roles

To get the permissions that you need to request quota adjustments, ask your administrator to grant you the following IAM roles on the project, folder, or organization:

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

These predefined roles contain the permissions required to request quota adjustments. To see the exact permissions that are required, expand the Required permissions section:

Required permissions

The following permissions are required to request quota adjustments:

  • To request quota adjustments: serviceusage.quotas.update

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

View quotas in the Google Cloud console

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

View the quotas for your project

The IAM & Admin > Quotas & System Limits 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.

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

Console

  1. In the Google Cloud console, go to the IAM & Admin > Quotas & System Limits page:

    Go to Quotas & System Limits

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

    • To filter the list, enter the properties and values in the 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 quotas that are at risk of being exceeded.

  3. Optional: To inspect the aggregate quota usage at the folder and organization levels, select the organization or folder from the resource selector.

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.

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 and export quota usage over time

You can view quota usage over time with charts. The Quotas & System Limits page of the console provides charts for each individual quota or system limit that's in the Quotas & System Limits table. After you view a chart, you can export it. To view and export a chart, follow these steps:

Console

  1. In the Google Cloud console, go to the IAM & Admin > Quotas & System Limits page:

    Go to Quotas & System Limits

  2. Find the quota or system limit that you're interested in. In the entry for this quota or system limit, click Show usage chart. The chart view opens.

  3. In the chart view, set the time period. The default is 7 days. To change this, click the time period menu and select your time period.

  4. To export the chart, click More chart options, and then select Download > Download PNG. The chart downloads as a PNG file.

To do more with charts, see Set up quota alerts and monitoring.

View API-specific quotas

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.

If there is no value for a given quota, the value appears as Unlimited.

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 & System Limits page or APIs & Services page. Use the console view that you prefer:

Console

  • To view API-specific quotas from the Quotas & System Limits page using a filter:

    1. In the Google Cloud console, go to the IAM & Admin > Quotas & System Limits page:

      Go to Quotas & System Limits

    2. Click Filter and select Service from the menu that appears.

    3. Select or enter the service name that you want to view.

      The page displays quotas and system limit information for the specified API. The numbers that appear in the Value column are the default quota values, unless you made a quota adjustment.

  • To view API-specific quotas from the APIs & Services page:

    1. Go to the APIs & Services page:

      Go to APIs & Services

    2. Select your project.

    3. Click the API name for the service you want to view.

    4. Click the Quotas & System Limits tab.

      The page displays quotas and system limit information for the specified API. The numbers that appear in the Value column are the default quota values, unless you made a quota adjustment.

To see usage over time, click Show usage chart.

Filter quotas

To filter the list of quotas by specific properties:

Console

  1. In the Google Cloud console, go to the IAM & Admin > Quotas & System Limits page:

    Go to Quotas & System Limits

  2. Click Filter to query your quotas by a specific property name or value.

Manage your quotas using the 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.

Request a quota adjustment

Cloud Quotas adjustment requests are subject to review. If your quota adjustment request requires review, you receive an email acknowledging receipt of your request. If you need further assistance, respond to the email. After reviewing your request, you receive an email notification indicating whether your request was approved. You can request a quota adjustment by using the Google Cloud console, the Cloud Quotas API, or the Google Cloud CLI. The following instructions show how to request a new quota value by using the Google Cloud console or by making a REST request to the Cloud Quotas API.

Console

To request a quota adjustment, follow these steps:

  1. In the Google Cloud console, go to the IAM & Admin > Quotas & System Limits page:

    Go to Quotas & System Limits

    If prompted to select a project, select the project that you want to adjust.

  2. Find the quota that you want to adjust and open the Quota changes dialog:

    • Quotas that aren't in the table:

      • Search for your quota in the Filter search box. Don't specify the region or zone (if applicable) because quotas that don't have use or adjusted values don't show in the table.
      • Find any entry for your quota in the table. This can be the default entry or any entry with history regardless of region or zone.
      • In the line for the entry, click More actions > Configure additional regions/zones.
      • Select the region or zone that you want to adjust. Click Edit.

    • All other quotas:

      • Search for your quota in the Filter search box.
      • In the line for the entry, select the checkbox for your quota.
      • Click Edit.

    The Quota changes dialog appears.

  3. If you see a link to Apply for higher quota above the New value field and you want to increase your quota value beyond the number indicated on the screen, follow the link. Fill out the form, submit it, and skip the remaining steps here. Otherwise, continue following this guide.

  4. In the New value field, enter the increased quota value that you want. If a Request description field appears, enter a description. Click Done.

    • If you see a checkbox with the text "I understand that this request will remove any overrides," your quota value is set below the default. Adjusting the quota value to or beyond the default removes the override. To proceed, select the checkbox. Learn more about quota overrides.

    If a Next button appears, click Next and fill out your contact details in the screen that follows.

  5. Click Submit request.

If you find that you can't request an adjustment from the console, request the increase from Cloud Customer Care.

To learn more about how the quota increase process works, see About quota adjustments.

Batching requests for quota adjustments

You can batch requests for quota adjustments by selecting the checkbox for each quota that you want to include. However, batching requests can increase the amount of time it takes for Google Cloud to review your request.

To reduce review time, group quota adjustment requests by product and area. For example, if you want to request adjustments to networking and Compute Engine VM quotas, create one request for the networking quotas and another request for the Compute Engine VM quotas.

REST

To request a quota adjustment from the Cloud Quotas API, use the following code sample. Fill in the editable placeholders with your values. To learn about the placeholder fields, see the descriptions following the code sample.

POST projects/PROJECT_NUMBER/locations/global/quotaPreferences?quotaPreferenceId=QUOTA_PREFERENCE_ID {
    "service": "SERVICE_ID",
    "quotaId": "QUOTA_ID",
    "quotaConfig": { "preferredValue": "NEW_QUOTA_VALUE" },
    "dimensions": { "DIMENSION_1": "VALUE_1", "DIMENSION_2": "VALUE_2" },
    "justification": "JUSTIFICATION",
    "contactEmail": "EMAIL"
}

Replace the following:

  • PROJECT_NUMBER: Your Google Cloud project number. You can find your project number on the Welcome page of the Google Cloud console or by running the following gcloud CLI command:

    PROJECT=$(gcloud info --format='value(config.project)')
gcloud projects describe ${PROJECT} --format="value(projectNumber)"

  • QUOTA_PREFERENCE_ID: The ID of the quota preference you're updating.

  • QUOTA_ID: The ID of the quota that you're updating.

  • SERVICE_ID: The ID of the Google Cloud that the quota you're adjusting belongs to. This is usually of the form SERVICE_NAME.googleapis.com. For example, the Compute Engine service name is compute.googleapis.com.

  • DIMENSION_1: The type of dimension that you want to adjust—for example, region or zone—. You can include multiple dimensions. Separate each dimension by following its value— for example, VALUE_1—with a comma. To adjust all dimensions of the quota, omit this line.

  • VALUE_1: The value of the preceding dimension. For example, if preceding dimension is region, enter a region such as us-central1.

  • JUSTIFICATION: The reason for this request.

  • EMAIL: An email address that can be used as a contact, in case Google Cloud needs more information to make a decision before additional quota can be granted.

Example request

The following is an example of a quota value increase request for the Compute Engine quota PUS-PER-GPU-FAMILY-per-project-region. It requests a quota value of 100 for machines of the GPU family NVIDIA_H100 that are in the region us-central1.

POST projects/123/locations/global/quotaPreferences?quotaPreferenceId=my_quota_preference_ID {
    "service": "compute.googleapis.com",
    "quotaId": "GPUS-PER-GPU-FAMILY-per-project-region",
    "quotaConfig": { "preferredValue": 100 },
    "dimensions": { "region": "us-central1", "gpu_family": "NVIDIA_H100" },
    "justification": "My justification.",
    "contactEmail": "222larabrown@gmail.com"
}

View quota increase requests

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

To see pending quota increase requests:

Console

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

  2. In the Google Cloud console, go to the IAM & Admin > Quotas & System Limits page:

    Go to Quotas & System Limits

  3. A Pending icon appears next to the quota values that are pending a decision on previously submitted increase requests. Click Pending to view details of the pending requests.

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

To view all quota increase requests, which includes pending and past requests:

Console

  1. In the Google Cloud console, go to the IAM & Admin > Quotas & System Limits page:

    Go to Quotas & System Limits

  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.

Create a quota override

To restrict usage of a particular resource, create a quota override by changing the quota value to a value less than the default quota value. Creating a quota override is sometimes referred to as capping usage.

To create a quota override, follow the steps to update a quota value.

Quota overrides are not available to all services. For service-specific information, check the quota and system limits documentation for your service.

Reset a quota value

To reset the quota value after an override has been applied, follow these steps:

Console

  1. In the Google Cloud console, go to the IAM & Admin > Quotas & System Limits page:

    Go to Quotas & System Limits

  2. Enter text in the Filter search box to search for your quota. Set Has override: True to show only quotas that have an override.

  3. On the Quotas page, Override appears next to the quota limits that have an override. Click Override to view details of this quota and an option to reset the value.

  4. To acknowledge that a reset removes your overrides, click the checkbox preceding Reset value and then click Reset value to reset the quota.

To reset a quota manually, follow the same steps as for requesting a higher quota limit. Make sure that you set the New value equal to the Default value displayed below the quota name in the Quota changes form.

Manage quotas using the Cloud Quotas API

You can use the Cloud Quotas API to get current quota information and set quota preferences for Google Cloud APIs and services. For more information, see the following:

Manage quotas using the gcloud CLI

To use the gcloud CLI, make sure you have installed and initialized the latest version of the gcloud CLI, including the beta commands component. If you're using Cloud Shell to interact with Google Cloud, the gcloud CLI is installed for you.

See the following sections for more information:

Request project quota

For more information about requesting additional project quotas, refer to the Project quota requests support article.

What's next