View and manage quotas

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

Limitations

Cloud Quotas has the following limitations:

  • In most cases, quotaincrease adjustments must be made at theproject-level.A limited number of products supportorganization-levelquota increase adjustments. To see if a Google Cloud product supportsorganization-level quota increase adjustments, refer to the documentationfor that product.

  • You can request quotadecrease adjustments forproject-, organization-, andfolder-levelquotas.

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, seeManage 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 theRequired 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 withcustom roles or otherpredefined roles.

View quotas in the Google Cloud console

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

View the quotas for your project

TheIAM & Admin > Quotas & System Limits page displays a tablewith configurable columns. TheService andQuota columns provide generalinformation about which quota is being described.For example, theService might beCloud Logging API and theQuotamight beLog ingestion requests per minute. TheQuota field alsodescribes how the quota is evaluated. Rate quotas are evaluated per minute, per100 seconds, or per day. Quotas without any of these statements are allocationquotas.

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

Console

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

    Go to Quotas & System Limits

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

    • To filter the list, enter the properties and values in the field. Forexample, to view the BigQuery API quotas, selectService, and then selectBigQuery API.

    • To sort the list, click the heading of the column you want to sort by. Forexample, to sort alphabetically by the quota name, click theQuota column heading.

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

  3. Optional: To inspect the aggregate quota usage at the folder andorganization levels, select the organization or folder from the resourceselector.

You can find additional information about the quota by using theMetric,Limit name, andMonitored resource columns. Thesecolumns provide the detailed information needed to chart a quota.

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

  • For per-minute rate quotas:

    • Theaverage per minute usage in the past 10 minutes.
  • For per-day rate quotas:

    • Thetotal usage so far in the current day, according to PacificStandard Time.
  • For allocation quotas:

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

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

You can learn more about quotas for a specific service by reading thedocumentation for that service. For example, Compute Engine quota isdocumented inResource quotas.

View and export quota usage over time

You can view quota usage over time with charts. The Quotas & System Limits pageof the console provides charts for each individual quota or system limit that'sin 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 theIAM & Admin > Quotas & System Limits page:

    Go to Quotas & System Limits

  2. Find the quota or system limit that you're interested in. In the entryfor this quota or system limit, clickShow usage chart. The chart view opens.

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

  4. To export the chart, clickMore chart options, and then selectDownload >Download PNG. The chart downloads as a PNG file.

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

View API-specific quotas

To view detailed quota information for a particular API, including usageover time, visit the quota page for the API in the Google Cloud console.Depending on the API, these limits can includerequests per day,requests per minute, andrequests per minute per user.Some APIs set very low limits until youenable billing on your project.

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

You can view the current limits for a particular API in two different areas ofthe Google Cloud console:on the Google Cloud consoleQuotas & System Limits pageorAPIs & Services page. Use the console view that you prefer:

Console

  • To view API-specific quotas from theQuotas & System Limits page usinga filter:

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

      Go to Quotas & System Limits

    2. ClickFilter and selectService fromthe menu that appears.

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

      The page displays quotas and system limit information for thespecified API. The numbers that appear in theValue column are thedefault quota values, unless you made a quota adjustment.

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

    1. Go to theAPIs & Services page:

      Go to APIs & Services

    2. Select your project.

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

    4. Click theQuotas & System Limits tab.

      The page displays quotas and system limit information for thespecified API. The numbers that appear in theValue column are thedefault quota values, unless you made a quota adjustment.

To see usage over time, clickShow usage chart.

Filter quotas

To filter the list of quotas by specific properties:

Console

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

    Go to Quotas & System Limits

  2. ClickFilter toquery 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 quotavalues of your project up or down. This section describes how to change the provided quotavalues. To see the values, in theDetails column, clickAll Quotas.

Request a quota adjustment

Cloud Quotas adjustment requests are subject to review. If your quotaadjustment request requires review, you receive an email acknowledging receiptof your request. If you need further assistance, respond to the email. Afterreviewing your request, you receive an email notification indicating whetheryour request was approved. You can request a quota adjustment by using the Google Cloud console, theCloud Quotas API, or the Google Cloud CLI. The following instructions showhow to request a new quota value by using the Google Cloud console or by making aREST request to the Cloud Quotas API.

Console

To request a quota adjustment, follow these steps:

  1. In the Google Cloud console, go to theIAM & 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 theQuota changesdialog:

    • Quotas that aren't in the table:

      • Search for your quota in theFilter 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 thetable.
      • Find any entry for your quota in the table. This canbe the default entry or any entry with history regardless of region orzone.
      • In the line for the entry, clickMore actions > Configure additional regions/zones.
      • Select the regionor zone that you want to adjust. ClickEdit.
    • All other quotas:

      • Search for your quota in theFilter search box.
      • In the line for the entry, select the checkbox for your quota.
      • ClickEdit.

    TheQuota changes dialog appears.

  3. If you see a link toApply for higher quota above theNew valuefield and you want to increase your quota value beyond the number indicatedon the screen, follow the link. Fill out the form, submit it, and skip theremaining steps here. Otherwise, continue following this guide.

  4. In theNew value field, enter the increased quota value that youwant. If aRequest description field appears, enter a description.ClickDone.

    • If you see a checkbox with the text "I understand that this request willremove 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 aboutquota overrides.

    If aNext button appears, clickNext and fill out your contactdetails in the screen that follows.

  5. ClickSubmit request.

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

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

Batching requests for quota adjustments

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

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

REST

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

POSTprojects/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 projectnumber. You can find your project number on theWelcomepage of the Google Cloud console or by running the followinggcloud CLI command:

    PROJECT=$(gcloudinfo--format='value(config.project)')gcloudprojectsdescribe${PROJECT}--format="value(projectNumber)"
  • QUOTA_PREFERENCE_ID: The ID of the quotapreference you're updating.

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

  • SERVICE_ID: The ID of the Google Cloud thatthe quota you're adjusting belongs to. This is usually of the formSERVICE_NAME.googleapis.com. For example, theCompute Engine service name iscompute.googleapis.com.

  • DIMENSION_1: The type of dimension that you wantto adjust—for example,region orzone—. You can includemultiple dimensions. Separate each dimension by following its value—for example,VALUE_1—with a comma. To adjustall dimensions of the quota, omit this line.

  • VALUE_1: The value of the preceding dimension. Forexample, if preceding dimension isregion, enter a region such asus-central1.

  • JUSTIFICATION: The reason for this request.

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

Example request

The following is an example of a quota value increase request for theCompute Engine quotaPUS-PER-GPU-FAMILY-per-project-region. It requestsa quota value of 100 for machines of the GPU familyNVIDIA_H100 that arein the regionus-central1.

POSTprojects/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 theGoogle Cloud console.

To see pending quota increase requests:

Console

  1. Ensure that you havepermission to view quota increase requests.

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

    Go to Quotas & System Limits

  3. APending icon appears next to the quota values that are pending adecision on previously submitted increase requests. ClickPending to view details ofthe pending requests.

Pending requests are also shown in theQuota changes form when aquota 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 theIAM & Admin > Quotas & System Limits page:

    Go to Quotas & System Limits

  2. Click theIncrease Requests tab.

  3. ClickFilter toquery your quota increase requests by a specific property.

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

Create a quota override

To restrict usage of a particular resource, create aquota override bychanging the quota value to a value less than the default quota value.Creating a quota override is sometimes referred to ascapping usage.

To create a quota override, follow the steps toupdate a quota value.

Quota overrides are not available to all services. For service-specificinformation, 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 theIAM & Admin > Quotas & System Limits page:

    Go to Quotas & System Limits

  2. Enter text in theFiltersearch box to search for your quota. SetHas override: True toshow only quotas that have an override.

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

  4. To acknowledge that a reset removes your overrides, click the checkboxprecedingReset value and then clickReset value to reset the quota.

To reset a quota manually, follow the same steps as forrequesting a higher quota limit. Make sure that youset theNew value equal to theDefault value displayed below the quotaname in theQuota changes form.

Manage quotas using the Cloud Quotas API

You can use the Cloud Quotas API to get current quota information andset 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 haveinstalledandinitialized the latest version of thegcloud CLI, including thebeta commandscomponent. If you're using Cloud Shell to interact with Google Cloud, thegcloud CLI is installed for you.

Important: Cloud Quotas gcloud CLI commands are inpreview and might change without notice.

See the following sections for more information:

Request project quota

For more information about requesting additionalproject quotas, refer to theProject quota requestssupport article.

What's next

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-18 UTC.