mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-11 15:39:42 +00:00
99 lines
4 KiB
Text
99 lines
4 KiB
Text
NAME
|
|
gcloud alpha quotas preferences create - create a new QuotaPreference that
|
|
declares the desired value for a quota
|
|
|
|
SYNOPSIS
|
|
gcloud alpha 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-central1 that applies to the
|
|
default_limit quota under service example.$$UNIVERSE_DOMAIN$$ for
|
|
projects/12321, run:
|
|
|
|
$ gcloud alpha 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-central1
|
|
|
|
To create a quota preference under service example.$$UNIVERSE_DOMAIN$$ for
|
|
organizations/789 with random preference ID, run:
|
|
|
|
$ gcloud alpha 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 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. This variant is also available:
|
|
|
|
$ gcloud beta quotas preferences create
|
|
|