.TH "GCLOUD_COMPUTE_COMMITMENTS_UPDATE" 1



.SH "NAME"
.HP
gcloud compute commitments update \- update Compute Engine commitments



.SH "SYNOPSIS"
.HP
\f5gcloud compute commitments update\fR \fICOMMITMENT\fR [\fB\-\-auto\-renew\fR] [\fB\-\-custom\-end\-time\fR=\fICUSTOM_END_TIME\fR] [\fB\-\-plan\fR=\fIPLAN\fR] [\fB\-\-region\fR=\fIREGION\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Update Compute Engine commitments.



.SH "EXAMPLES"

To enable auto renewal on a commitment called \f5\fIcommitment\-1\fR\fR in the
\f5\fIus\-central1\fR\fR region, run:

.RS 2m
$ gcloud compute commitments update commitment\-1 \-\-auto\-renew \e
    \-\-region=us\-central1
.RE

To disable auto renewal on a commitment called \f5\fIcommitment\-1\fR\fR in the
\f5\fIus\-central1\fR\fR region, run:

.RS 2m
$ gcloud compute commitments update commitment\-1 \-\-no\-auto\-renew \e
    \-\-region=us\-central1
.RE

To upgrade the term of a commitment called \f5\fIcommitment\-1\fR\fR from
12\-month to 36\-month, in the \f5\fIus\-central1\fR\fR region, run:

.RS 2m
$ gcloud compute commitments update commitment\-1 \-\-plan=36\-month \e
    \-\-region=us\-central1
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fICOMMITMENT\fR

Name of the commitment to update.


.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-auto\-renew\fR

Enable auto renewal for the commitment.

.TP 2m
\fB\-\-custom\-end\-time\fR=\fICUSTOM_END_TIME\fR

Specifies a custom future end date and extends the commitment's ongoing term.

.TP 2m
\fB\-\-plan\fR=\fIPLAN\fR

Duration of the commitment. \fIPLAN\fR must be (only one value is supported):
\fB36\-month\fR.

.TP 2m
\fB\-\-region\fR=\fIREGION\fR

Region of the commitment to update. If not specified, you might be prompted to
select a region (interactive mode only).

To avoid prompting when this flag is omitted, you can set the
\f5\fIcompute/region\fR\fR property:

.RS 2m
$ gcloud config set compute/region REGION
.RE

A list of regions can be fetched by running:

.RS 2m
$ gcloud compute regions list
.RE

To unset the property, run:

.RS 2m
$ gcloud config unset compute/region
.RE

Alternatively, the region can be stored in the environment variable
\f5\fICLOUDSDK_COMPUTE_REGION\fR\fR.


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

These variants are also available:

.RS 2m
$ gcloud alpha compute commitments update
.RE

.RS 2m
$ gcloud beta compute commitments update
.RE