- NAME
-
- gcloud beta quotas preferences create - create a new QuotaPreference that declares the desired value for a quota
- SYNOPSIS
-
-
gcloud beta quotas preferences create--preferred-value=PREFERRED_VALUE--quota-id=QUOTA_ID--service=SERVICE(--folder=FOLDER_ID|--organization=ORGANIZATION_ID|--project=PROJECT_ID_OR_NUMBER) [--allow-high-percentage-quota-decrease] [--allow-quota-decrease-below-usage] [--dimensions=[KEY=VALUE, …]] [--email=EMAIL] [--justification=JUSTIFICATION] [--preference-id=PREFERENCE_ID] [GCLOUD_WIDE_FLAG …]
-
- EXAMPLES
- To create a quota preference in region
us-central1that applies to thedefault_limitquota under serviceexample.$$UNIVERSE_DOMAIN$$forprojects/12321, run:gcloud beta quotas preferences create --service = example. $$ UNIVERSE_DOMAIN $$ --project = 12321 --quota-id = default_limit --preferred-value = 100 --dimensions = region = us-central1 --preference-id = example_default-limit_us-central1example.$$UNIVERSE_DOMAIN$$`` fororganizations/789with random preference ID, run:gcloud beta quotas preferences create --service = example. $$ UNIVERSE_DOMAIN $$ --organization = 789 --quota-id = default_limit --preferred-value = 200 - REQUIRED FLAGS
-
-
--preferred-value=PREFERRED_VALUE - Preferred value. Must be greater than or equal to -1. If set to -1, it means the value is "unlimited".
-
--quota-id=QUOTA_ID - ID of the quota, which is unique within the service.
-
--service=SERVICE - Name of the service in which the quota is defined.
- Exactly one of these must be specified:
-
--folder=FOLDER_ID - Folder of the quota preference to create.
-
--organization=ORGANIZATION_ID - Organization of the quota preference to create.
-
--project=PROJECT_ID_OR_NUMBER - Project of the quota preference to create.
-
-
- OPTIONAL FLAGS
-
-
--allow-high-percentage-quota-decrease - If specified, allows you to reduce your effective limit by more than 10 percent. Default is false.
-
--allow-quota-decrease-below-usage - If specified, allows you to reduce your effective limit below your quota usage. Default is false.
-
--dimensions=[KEY=VALUE,…] - Dimensions of the quota.
-
--email=EMAIL - An optional email address that can be used for quota related communication between the Google Cloud and the user in case the Google Cloud needs further information to make a decision on whether the user preferred quota can be granted. The Google account for the email address must have quota update permission for the project, folder or organization this quota preference is for. If no contact email address is provided, or the provided email address does not have the required quota update permission, the quota preference request will be denied in case further information is required to make a decision.
-
--justification=JUSTIFICATION - A short statement to justify quota increase requests.
-
--preference-id=PREFERENCE_ID - ID of the Quota Preference object, must be unique under its parent.
-
- GCLOUD WIDE FLAGS
- These flags are available to all commands:
--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.Run
$ gcloud helpfor details. - NOTES
- This command is currently in beta and might change without notice. This variant
is also available:
gcloud alpha quotas preferences create
gcloud beta quotas preferences create
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-27 UTC.
