- NAME
-
- gcloud alpha quotas preferences update - update the parameters of a single QuotaPreference
- SYNOPSIS
-
-
gcloud alpha quotas preferences update
PREFERENCE_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
-
(ALPHA)
This command updates an existing or creates a new QuotaPreference. It can updates the config in any states, not just the ones pending approval. - EXAMPLES
-
To update a quota preference with id
my-preference
in regionus-central1
that applies to thedefault_limit
quota forprojects/12321
, run: To create a new quota preference forgcloud alpha quotas preferences update my-preference --service=example.googleapis.com --project=12321 --quota-id=default_limit --preferred-value=100 --dimensions=region=us-central1
organizations/123
, run:gcloud alpha quotas preferences update my-preference --service=example.googleapis.com --organization=123 --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 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 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 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.
--validate-only
- If specified, only validates the request, but does not actually update. Note that a request being valid does not mean that the request is guaranteed to be fulfilled. 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 alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early access allowlist.
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 2024-06-18 UTC.