mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-15 09:25:44 +00:00
109 lines
4.2 KiB
Text
109 lines
4.2 KiB
Text
NAME
|
|
gcloud beta quotas preferences update - update the parameters of a single
|
|
QuotaPreference
|
|
|
|
SYNOPSIS
|
|
gcloud beta 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
|
|
(BETA) 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 region us-central1
|
|
that applies to the default_limit quota for projects/12321, run:
|
|
|
|
$ gcloud beta quotas preferences update my-preference \
|
|
--service=example.$$UNIVERSE_DOMAIN$$ --project=12321 \
|
|
--quota-id=default_limit --preferred-value=100 \
|
|
--dimensions=region=us-central1
|
|
|
|
To create a new quota preference for organizations/789, run:
|
|
|
|
$ gcloud beta quotas preferences update my-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 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 beta and might change without notice. This
|
|
variant is also available:
|
|
|
|
$ gcloud alpha quotas preferences update
|
|
|