.TH "GCLOUD_BETA_COMPUTE_RESERVATIONS_UPDATE" 1



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



.SH "SYNOPSIS"
.HP
\f5gcloud beta 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\-\-share\-setting\fR=\fISHARE_SETTING\fR] [\fB\-\-share\-with\fR=\fISHARE_WITH\fR,[\fISHARE_WITH\fR,...]] [\fB\-\-vm\-count\fR=\fIVM_COUNT\fR] [\fB\-\-zone\fR=\fIZONE\fR] [\fB\-\-delete\-after\-duration\fR=\fIDELETE_AFTER_DURATION\fR\ |\ \fB\-\-delete\-at\-time\fR=\fIDELETE_AT_TIME\fR\ |\ \fB\-\-disable\-auto\-delete\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(BETA)\fR 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 beta 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 beta compute reservations update my\-reservation \e
  \-\-remove\-share\-with=project\-1,project\-2,project\-3 \e
  \-\-zone=us\-central1\-a
.RE

To update the entire list of projects that are shared with a Compute Engine
reservation, \f5my\-reservation\fR in zone: \f5us\-central1\-a\fR, run:

.RS 2m
$ gcloud beta compute reservations update my\-reservation \e
  \-\-share\-with=project\-1,project\-2,project\-3 \-\-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 beta 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\-\-share\-setting\fR=\fISHARE_SETTING\fR

The projects that can use the reservation. \fISHARE_SETTING\fR must be one of:

.RS 2m
.TP 2m
\fBlocal\fR
Only your project can use the reservation. This is the default value.
.TP 2m
\fBprojects\fR
Your project and up to 100 other projects within your project's organization can
use the reservation. If you specify this value, then you must also include the
\-\-share\-with flag in the command.

.RE
.sp


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

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

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

.TP 2m

Manage auto\-delete properties for reservations.

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-delete\-after\-duration\fR=\fIDELETE_AFTER_DURATION\fR

Automatically deletes the reservations after a specified number of days, hours,
minutes, or seconds from its creation. For example, specify 30m for 30 minutes,
or 1d2h3m4s for 1 day, 2 hours, 3 minutes, and 4 seconds. For more information,
see $ gcloud topic datetimes.

.TP 2m
\fB\-\-delete\-at\-time\fR=\fIDELETE_AT_TIME\fR

Automatically deletes the reservation at a specific time from its creation. The
specified time must be an RFC3339 timestamp, which must be formatted as
"YYYY\-MM\-DDTHH:MM:SSZ" where YYYY = year, MM = month, DD = day, HH = hours, MM
= minutes, SS = seconds, and Z = time zone in Coordinated Universal Time (UTC).
For example, specify 2021\-11\-20T07:00:00Z.

.TP 2m
\fB\-\-disable\-auto\-delete\fR

Disables the auto\-delete setting for the reservation.


.RE
.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 reservations update
.RE

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