gcloud beta quotas preferences update

NAME
gcloud beta quotas preferences update - update the parameters of a single QuotaPreference
SYNOPSIS
gcloud beta quotas preferences updatePREFERENCE_ID--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-missing][--allow-quota-decrease-below-usage][--dimensions=[KEY=VALUE,…]][--email=EMAIL][--justification=JUSTIFICATION][--validate-only][GCLOUD_WIDE_FLAG …]
DESCRIPTION
(BETA) This command updates an existing or creates a newQuotaPreference. It can updates the config in any states, not just the onespending approval.
EXAMPLES
To update a quota preference with idmy-preference in regionus-central1 that applies to thedefault_limit quotaforprojects/12321, run:
gcloudbetaquotaspreferencesupdatemy-preference--service=example.$$UNIVERSE_DOMAIN$$--project=12321--quota-id=default_limit--preferred-value=100--dimensions=region=us-central1
To create a new quota preference fororganizations/789, run:
gcloudbetaquotaspreferencesupdatemy-preference--service=example.$$UNIVERSE_DOMAIN$$--organization=789--quota-id=default_limit--preferred-value=200--allow-missing
POSITIONAL ARGUMENTS
PREFERENCE_ID
ID of the Quota Preference object, must be unique under its parent.
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 update.
--organization=ORGANIZATION_ID
Organization of the quota preference to update.
--project=PROJECT_ID_OR_NUMBER
Project of the quota preference to update.
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-missing
If specified and the quota preference is not found, a new one will be created.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.
--validate-only
If specified, only validates the request, but does not actually update. Notethat a request being valid does not mean that the request is guaranteed to befulfilled. Default is false.
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:
gcloudalphaquotaspreferencesupdate

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.