.TH "GCLOUD_COMPUTE_RESERVATIONS_UPDATE" 1



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



.SH "SYNOPSIS"
.HP
\f5gcloud compute reservations update\fR \fIRESERVATION\fR [\fB\-\-add\-share\-with\fR=\fIPROJECT\fR,[\fIPROJECT\fR,...]] [\fB\-\-[no\-]enable\-emergent\-maintenance\fR] [\fB\-\-remove\-share\-with\fR=\fIPROJECT\fR,[\fIPROJECT\fR,...]] [\fB\-\-reservation\-sharing\-policy\fR=\fIRESERVATION_SHARING_POLICY\fR] [\fB\-\-scheduling\-type\fR=\fISCHEDULING_TYPE\fR] [\fB\-\-vm\-count\fR=\fIVM_COUNT\fR] [\fB\-\-zone\fR=\fIZONE\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Update Compute Engine reservations.



.SH "EXAMPLES"

To add \f5project\-1,project\-2,project\-3\fR to the list of projects that are
shared with a Compute Engine reservation, \f5my\-reservation\fR in zone:
\f5us\-central1\-a\fR, run:

.RS 2m
$ gcloud compute reservations update my\-reservation \e
  \-\-add\-share\-with=project\-1,project\-2,project\-3 \e
  \-\-zone=us\-central1\-a
.RE

To remove \f5project\-1,project\-2,project\-3\fR from the list of projects that
are shared with a Compute Engine reservation, \f5my\-reservation\fR in zone:
\f5us\-central1\-a\fR, run:

.RS 2m
$ gcloud compute reservations update my\-reservation \e
  \-\-remove\-share\-with=project\-1,project\-2,project\-3 \e
  \-\-zone=us\-central1\-a
.RE

To update the number of reserved VM instances to 500 for a Compute Engine
reservation, \f5my\-reservation\fR in zone: \f5us\-central1\-a\fR, run:

.RS 2m
$ gcloud compute reservations update my\-reservation \e
  \-\-zone=us\-central1\-a \-\-vm\-count=500
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fIRESERVATION\fR

Name of the reservation to update.


.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-add\-share\-with\fR=\fIPROJECT\fR,[\fIPROJECT\fR,...]

If this reservation is shared (\-\-share\-setting is projects), then specify a
comma\-separated list of projects to share the reservation with. You must list
the projects using project IDs or project numbers.

.TP 2m
\fB\-\-[no\-]enable\-emergent\-maintenance\fR

Enables the reservation to receive notifications when urgent maintenance for a
GPU VM starts after the VM encounters a host error. Use
\fB\-\-enable\-emergent\-maintenance\fR to enable and
\fB\-\-no\-enable\-emergent\-maintenance\fR to disable.

.TP 2m
\fB\-\-remove\-share\-with\fR=\fIPROJECT\fR,[\fIPROJECT\fR,...]

A list of specific projects to remove from the list of projects that this
reservation is shared with. List must contain project IDs or project numbers.

.TP 2m
\fB\-\-reservation\-sharing\-policy\fR=\fIRESERVATION_SHARING_POLICY\fR

The reservation sharing policy to use for this reservation.
\fIRESERVATION_SHARING_POLICY\fR must be one of:

.RS 2m
.TP 2m
\fBALLOW_ALL\fR
The reservation can be shared with Google Cloud services.
.TP 2m
\fBDISALLOW_ALL\fR
The reservation won't be shared with Google Cloud services. If you omit this
flag during creation, the default value is DISALLOW_ALL.
.RE
.sp


.TP 2m
\fB\-\-scheduling\-type\fR=\fISCHEDULING_TYPE\fR

How Compute Engine schedules maintenance events for your reserved hosts.
\fISCHEDULING_TYPE\fR must be one of:

.RS 2m
.TP 2m
\fBGROUPED\fR
In GROUPED mode, maintenance is synchronized across all your VMs.
.TP 2m
\fBINDEPENDENT\fR
In INDEPENDENT mode, your VMs have different, unsynchronized maintenance
schedules.
.RE
.sp


.TP 2m
\fB\-\-vm\-count\fR=\fIVM_COUNT\fR

The number of VM instances that are allocated to this reservation. The value of
this field must be an int in the range [1, 1000].

.TP 2m
\fB\-\-zone\fR=\fIZONE\fR

Zone of the reservation to update. If not specified and the
\f5\fIcompute/zone\fR\fR property isn't set, you might be prompted to select a
zone (interactive mode only).

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

.RS 2m
$ gcloud config set compute/zone ZONE
.RE

A list of zones can be fetched by running:

.RS 2m
$ gcloud compute zones list
.RE

To unset the property, run:

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

Alternatively, the zone can be stored in the environment variable
\f5\fICLOUDSDK_COMPUTE_ZONE\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 reservations update
.RE

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