gcloud beta quotas preferences create

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 regionus-central1 that applies tothedefault_limit quota under serviceexample.$$UNIVERSE_DOMAIN$$ forprojects/12321, run:
gcloudbetaquotaspreferencescreate--service=example.$$UNIVERSE_DOMAIN$$--project=12321--quota-id=default_limit--preferred-value=100--dimensions=region=us-central1--preference-id=example_default-limit_us-central1
To create a quota preference under serviceexample.$$UNIVERSE_DOMAIN$$``fororganizations/789 with random preference ID, run:
gcloudbetaquotaspreferencescreate--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 thevalue 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 communicationbetween the Google Cloud and the user in case the Google Cloud needs furtherinformation to make a decision on whether the user preferred quota can begranted. The Google account for the email address must have quota updatepermission for the project, folder or organization this quota preference is for.If no contact email address is provided, or the provided email address does nothave the required quota update permission, the quota preference request will bedenied 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 help for details.

NOTES
This command is currently in beta and might change without notice. This variantis also available:
gcloudalphaquotaspreferencescreate

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 2025-05-07 UTC.