# Quotas and system limits

Service Usage uses quotas and system limits to maintain fair resource
allocation, prevent service overloads, and help you manage resource use.

Quotas and system limits are similar but differ in the following ways:

- *Quotas* have default values, but you can typically request adjustments.
- *System limits* are fixed values that can't be changed.

Google Cloud uses quotas to help maintain fairness and reduce
spikes in resource use and availability. A quota restricts how much of a
Google Cloud resource your Google Cloud project can use. Quotas
apply to a range of resource types, including hardware, software, and network
components. For example, quotas can restrict the number of API calls to a
service, the number of load balancers used concurrently by your project, or the
number of projects that you can create. Quotas protect the community of
Google Cloud users by preventing the overloading of services. Quotas also
help you to manage your own Google Cloud resources.

The Cloud Quotas system does the following:

- Monitors your consumption of Google Cloud products and services
- Restricts your consumption of those resources
- Provides a way to [request changes to the quota value](https://docs.cloud.google.com/docs/quotas/help/request_increase) and [automate quota adjustments](https://docs.cloud.google.com/docs/quotas/quota-adjuster.md.txt)

In most cases, when you attempt to consume more of a resource than its quota
allows, the system blocks access to the resource, and the task that
you're trying to perform fails.

Quotas generally apply at the Google Cloud project
level. Your use of a resource in one project doesn't affect
your available quota in another project. Within a Google Cloud project, quotas
are shared across all applications and IP addresses.


For more information, see the
[Cloud Quotas overview](https://docs.cloud.google.com/docs/quotas/overview.md.txt).

## Rate quotas

Rate quotas restrict the rate at which you can consume a resource. Per-minute
rate quotas reset every minute. The following table lists the rate quotas that
apply to Service Usage and the default value for each quota.

| Quota | Value |
|---|---|
| List available/disabled services requests per minute | 60 |
| List enabled services requests per minute | 600 |
| List public services requests per minute | 60 |
| Default requests per minute (all other read-only operations that don't modify the state of your project) | 600 |
| Mutate requests per minute (state-changing operations that actively change your project's configuration) | 120 |

## Get quota and system limit metric names

Quotas and system limits have two types of names: display names and metric
names. Display names have spaces and capitalization that make them easier for
humans to read. Metric names are more likely to be lowercase and delimited by
underscores instead of spaces; the exact format depends on the service.

The following instructions show how to get metric names for quotas and system
limits by using either the Google Cloud console or the
gcloud CLI.

### Console

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


   [Go to Quotas \& System Limits](https://console.cloud.google.com/iam-admin/quotas)

   <br />

   The table on this page displays quotas and system limits that have usage or
   have adjusted values, and a reference entry for other quotas. The reference
   entry has the word "default" in parentheses at the end of the listing in
   the **Name** column.
2. If you don't see the **Metric** column, take the following steps.

   1. Click **Column display options**.
   2. Select **Metric**.
   3. Click **OK** . The **Metric** column appears in the table.

The **Metric** column shows the metric names. To filter the results, enter a
property name or value in the field next to
**Filter** ---for example, **Service Usage API**.

### gcloud

To get the metric names for a Google Cloud service by
using the gcloud CLI, run the
[`quotas info list`](https://docs.cloud.google.com/sdk/gcloud/reference/beta/quotas/info/list)
command. To skip lines that don't list metric names, pass the output to a
command such as `grep` with `metric:` as the search term, or use the
gcloud CLI [`--format`](https://docs.cloud.google.com/sdk/gcloud/reference.md.txt#--format) flag:

    gcloud beta quotas info list --project=PROJECT_ID_OR_NUMBER \
        --service=serviceusage.googleapis.com --format="value(metric)"

Replace the `PROJECT_ID_OR_NUMBER` with your project ID
or project number.

If you receive an an error message about no quota project being set, see
[User credentials not working](https://docs.cloud.google.com/docs/authentication/troubleshoot-adc.md.txt#user-creds-client-based).

## Request a quota adjustment

To adjust most quotas, use the Google Cloud console.
For more information, see
[Request a quota adjustment](https://docs.cloud.google.com/docs/quotas/help/request_increase).