- 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 thedefault_limit
quota under serviceexample.googleapis.com
forprojects/12321
, run:gcloud alpha quotas preferences create --service=example.googleapis.com --project=12321 --quota-id=default_limit --preferred-value=100 --dimensions=region=us-central1 --preference-id=example_default-limit_us-central1
example.googleapis.com
fororganizations/123
with random preference ID, run:gcloud alpha quotas preferences create --service=example.googleapis.com --organization=123 --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.
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.