.TH "GCLOUD_ALPHA_QUOTAS_PREFERENCES_CREATE" 1



.SH "NAME"
.HP
gcloud alpha quotas preferences create \- create a new QuotaPreference that declares the desired value for a quota



.SH "SYNOPSIS"
.HP
\f5gcloud alpha quotas preferences create\fR \fB\-\-preferred\-value\fR=\fIPREFERRED_VALUE\fR \fB\-\-quota\-id\fR=\fIQUOTA_ID\fR \fB\-\-service\fR=\fISERVICE\fR (\fB\-\-folder\fR=\fIFOLDER_ID\fR\ |\ \fB\-\-organization\fR=\fIORGANIZATION_ID\fR\ |\ \fB\-\-project\fR=\fIPROJECT_ID_OR_NUMBER\fR) [\fB\-\-allow\-high\-percentage\-quota\-decrease\fR] [\fB\-\-allow\-quota\-decrease\-below\-usage\fR] [\fB\-\-dimensions\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fB\-\-email\fR=\fIEMAIL\fR] [\fB\-\-justification\fR=\fIJUSTIFICATION\fR] [\fB\-\-preference\-id\fR=\fIPREFERENCE_ID\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "EXAMPLES"

To create a quota preference in region \f5us\-central1\fR that applies to the
\f5default_limit\fR quota under service \f5example.$$UNIVERSE_DOMAIN$$\fR for
\f5projects/12321\fR, run:

.RS 2m
$ gcloud alpha quotas preferences create \e
    \-\-service=example.$$UNIVERSE_DOMAIN$$ \-\-project=12321 \e
    \-\-quota\-id=default_limit \-\-preferred\-value=100 \e
    \-\-dimensions=region=us\-central1 \e
    \-\-preference\-id=example_default\-limit_us\-central1
.RE


To create a quota preference under service \f5example.$$UNIVERSE_DOMAIN$$\fR for
\f5organizations/789\fR with random preference ID, run:

.RS 2m
$ gcloud alpha quotas preferences create \e
    \-\-service=example.$$UNIVERSE_DOMAIN$$ \-\-organization=789 \e
    \-\-quota\-id=default_limit \-\-preferred\-value=200
.RE



.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-preferred\-value\fR=\fIPREFERRED_VALUE\fR

Preferred value. Must be greater than or equal to \-1. If set to \-1, it means
the value is "unlimited".

.TP 2m
\fB\-\-quota\-id\fR=\fIQUOTA_ID\fR

ID of the quota, which is unique within the service.

.TP 2m
\fB\-\-service\fR=\fISERVICE\fR

Name of the service in which the quota is defined.

.TP 2m

Exactly one of these must be specified:


.RS 2m
.TP 2m
\fB\-\-folder\fR=\fIFOLDER_ID\fR

Folder of the quota preference to create.

.TP 2m
\fB\-\-organization\fR=\fIORGANIZATION_ID\fR

Organization of the quota preference to create.

.TP 2m
\fB\-\-project\fR=\fIPROJECT_ID_OR_NUMBER\fR

Project of the quota preference to create.


.RE
.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-allow\-high\-percentage\-quota\-decrease\fR

If specified, allows you to reduce your effective limit by more than 10 percent.
Default is false.

.TP 2m
\fB\-\-allow\-quota\-decrease\-below\-usage\fR

If specified, allows you to reduce your effective limit below your quota usage.
Default is false.

.TP 2m
\fB\-\-dimensions\fR=[\fIKEY\fR=\fIVALUE\fR,...]

Dimensions of the quota.

.TP 2m
\fB\-\-email\fR=\fIEMAIL\fR

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.

.TP 2m
\fB\-\-justification\fR=\fIJUSTIFICATION\fR

A short statement to justify quota increase requests.

.TP 2m
\fB\-\-preference\-id\fR=\fIPREFERENCE_ID\fR

ID of the Quota Preference object, must be unique under its parent.


.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "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:

.RS 2m
$ gcloud beta quotas preferences create
.RE