File: //snap/google-cloud-cli/396/help/man/man1/gcloud_beta_compute_commitments_update.1
.TH "GCLOUD_BETA_COMPUTE_COMMITMENTS_UPDATE" 1
.SH "NAME"
.HP
gcloud beta compute commitments update \- update Compute Engine commitments
.SH "SYNOPSIS"
.HP
\f5gcloud beta 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"
\fB(BETA)\fR 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 beta 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 beta compute commitments update commitment\-1 \e
\-\-no\-auto\-renew \-\-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 beta compute commitments update commitment\-1 \e
\-\-plan=36\-month \-\-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"
This command is currently in beta and might change without notice. These
variants are also available:
.RS 2m
$ gcloud compute commitments update
.RE
.RS 2m
$ gcloud alpha compute commitments update
.RE