.TH "GCLOUD_ALPHA_COMPUTE_COMMITMENTS_UPDATE\-RESERVATIONS" 1



.SH "NAME"
.HP
gcloud alpha compute commitments update\-reservations \- update the resource shape of reservations within the commitment



.SH "SYNOPSIS"
.HP
\f5gcloud alpha compute commitments update\-reservations\fR \fICOMMITMENT\fR [\fB\-\-region\fR=\fIREGION\fR] [\fB\-\-reservations\-from\-file\fR=\fIPATH_TO_FILE\fR\ |\ [\fB\-\-dest\-reservation\fR=[\fImachine\-type\fR=\fIMACHINE\-TYPE\fR],[\fImin\-cpu\-platform\fR=\fIMIN\-CPU\-PLATFORM\fR],[\fIrequire\-specific\-reservation\fR=\fIREQUIRE\-SPECIFIC\-RESERVATION\fR],[\fIreservation\fR=\fIRESERVATION\fR],[\fIreservation\-zone\fR=\fIRESERVATION\-ZONE\fR],[\fIvm\-count\fR=\fIVM\-COUNT\fR]\ \fB\-\-source\-reservation\fR=[\fImachine\-type\fR=\fIMACHINE\-TYPE\fR],[\fImin\-cpu\-platform\fR=\fIMIN\-CPU\-PLATFORM\fR],[\fIrequire\-specific\-reservation\fR=\fIREQUIRE\-SPECIFIC\-RESERVATION\fR],[\fIreservation\fR=\fIRESERVATION\fR],[\fIreservation\-zone\fR=\fIRESERVATION\-ZONE\fR],[\fIvm\-count\fR=\fIVM\-COUNT\fR]\ :\ \fB\-\-dest\-accelerator\fR=[\fIcount\fR=\fICOUNT\fR],[\fItype\fR=\fITYPE\fR]\ \fB\-\-dest\-local\-ssd\fR=[\fIinterface\fR=\fIINTERFACE\fR],[\fIsize\fR=\fISIZE\fR]\ \fB\-\-dest\-share\-setting\fR=\fIDEST_SHARE_SETTING\fR\ \fB\-\-dest\-share\-with\fR=\fISHARE_WITH\fR,[\fISHARE_WITH\fR,...]\ \fB\-\-source\-accelerator\fR=[\fIcount\fR=\fICOUNT\fR],[\fItype\fR=\fITYPE\fR]\ \fB\-\-source\-local\-ssd\fR=[\fIinterface\fR=\fIINTERFACE\fR],[\fIsize\fR=\fISIZE\fR]\ \fB\-\-source\-share\-setting\fR=\fISOURCE_SHARE_SETTING\fR\ \fB\-\-source\-share\-with\fR=\fISHARE_WITH\fR,[\fISHARE_WITH\fR,...]]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR Update the resource shape of reservations within the commitment.



.SH "EXAMPLES"

To update reservations of the commitment called \f5\fIcommitment\-1\fR\fR in the
\f5\fIus\-central1\fR\fR region with values from \f5\fIreservations.yaml\fR\fR,
run:

.RS 2m
$ gcloud alpha compute commitments update\-reservations \e
    commitment\-1 \-\-reservations\-from\-file=reservations.yaml
.RE

For detailed examples, please refer to
https://cloud.google.com/compute/docs/instances/reserving\-zonal\-resources#modifying_reservations_that_are_attached_to_commitments



.SH "POSITIONAL ARGUMENTS"

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

Name of the commitment to update reservation.


.RE
.sp

.SH "FLAGS"

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

Region of the commitment to update reservation. 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.

.TP 2m

Manage reservations that are attached to the commitment.

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-reservations\-from\-file\fR=\fIPATH_TO_FILE\fR

Path to a YAML file of two reservations' configuration. Use a full or relative
path to a local file containing the value of reservations.

.TP 2m

Specify source and destination reservations configuration.


.RS 2m
.TP 2m
\fB\-\-dest\-reservation\fR=[\fImachine\-type\fR=\fIMACHINE\-TYPE\fR],[\fImin\-cpu\-platform\fR=\fIMIN\-CPU\-PLATFORM\fR],[\fIrequire\-specific\-reservation\fR=\fIREQUIRE\-SPECIFIC\-RESERVATION\fR],[\fIreservation\fR=\fIRESERVATION\fR],[\fIreservation\-zone\fR=\fIRESERVATION\-ZONE\fR],[\fIvm\-count\fR=\fIVM\-COUNT\fR]

destination reservation configuration.
.RS 2m
.TP 2m
\fBreservation\fR
Name of the destination reservation to operate on.
.TP 2m
\fBreservation\-zone\fR
Zone of the destination reservation to operate on.
.TP 2m
\fBvm\-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
\fBmachine\-type\fR
The type of machine (name only) which has a fixed number of vCPUs and a fixed
amount of memory. This also includes specifying custom machine type following
\f5custom\-number_of_CPUs\-amount_of_memory\fR pattern, e.g.
\f5custom\-32\-29440\fR.
.TP 2m
\fBmin\-cpu\-platform\fR
Optional minimum CPU platform of the reservation to create.
.TP 2m
\fBrequire\-specific\-reservation\fR
Indicates whether the reservation can be consumed by VMs with "any reservation"
defined. If enabled, then only VMs that target this reservation by name using
\f5\-\-reservation\-affinity=specific\fR can consume from this reservation.

This flag argument must be specified if any of the other arguments in this group
are specified.

.RE
.sp
.TP 2m
\fB\-\-source\-reservation\fR=[\fImachine\-type\fR=\fIMACHINE\-TYPE\fR],[\fImin\-cpu\-platform\fR=\fIMIN\-CPU\-PLATFORM\fR],[\fIrequire\-specific\-reservation\fR=\fIREQUIRE\-SPECIFIC\-RESERVATION\fR],[\fIreservation\fR=\fIRESERVATION\fR],[\fIreservation\-zone\fR=\fIRESERVATION\-ZONE\fR],[\fIvm\-count\fR=\fIVM\-COUNT\fR]

source reservation configuration.
.RS 2m
.TP 2m
\fBreservation\fR
Name of the source reservation to operate on.
.TP 2m
\fBreservation\-zone\fR
Zone of the source reservation to operate on.
.TP 2m
\fBvm\-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
\fBmachine\-type\fR
The type of machine (name only) which has a fixed number of vCPUs and a fixed
amount of memory. This also includes specifying custom machine type following
\f5custom\-number_of_CPUs\-amount_of_memory\fR pattern, e.g.
\f5custom\-32\-29440\fR.
.TP 2m
\fBmin\-cpu\-platform\fR
Optional minimum CPU platform of the reservation to create.
.TP 2m
\fBrequire\-specific\-reservation\fR
Indicates whether the reservation can be consumed by VMs with "any reservation"
defined. If enabled, then only VMs that target this reservation by name using
\f5\-\-reservation\-affinity=specific\fR can consume from this reservation.

This flag argument must be specified if any of the other arguments in this group
are specified.

.RE
.sp
.TP 2m
\fB\-\-dest\-accelerator\fR=[\fIcount\fR=\fICOUNT\fR],[\fItype\fR=\fITYPE\fR]

Manage the configuration of the type and number of accelerator cards attached.
.RS 2m
.TP 2m
\fBcount\fR
The number of accelerators to attach to each instance in the reservation.
.TP 2m
\fBtype\fR
The specific type (e.g. \f5nvidia\-tesla\-k80\fR for nVidia Tesla K80) of
accelerator to attach to instances in the reservation. Use \f5gcloud compute
accelerator\-types list\fR to learn about all available accelerator types.

.RE
.sp
.TP 2m
\fB\-\-dest\-local\-ssd\fR=[\fIinterface\fR=\fIINTERFACE\fR],[\fIsize\fR=\fISIZE\fR]

Manage the size and the interface of local SSD to use. See
https://cloud.google.com/compute/docs/disks/local\-ssd for more information.
.RS 2m
.TP 2m
\fBinterface\fR
The kind of disk interface exposed to the VM for this SSD. Valid values are
\f5scsi\fR and \f5nvme\fR. SCSI is the default and is supported by more guest
operating systems. NVME may provide higher performance.
.TP 2m
\fBsize\fR
The size of the local SSD in base\-2 GB.

.RE
.sp
.TP 2m
\fB\-\-dest\-share\-setting\fR=\fIDEST_SHARE_SETTING\fR

The projects that can use the reservation. \fIDEST_SHARE_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\-\-dest\-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\-\-source\-accelerator\fR=[\fIcount\fR=\fICOUNT\fR],[\fItype\fR=\fITYPE\fR]

Manage the configuration of the type and number of accelerator cards attached.
.RS 2m
.TP 2m
\fBcount\fR
The number of accelerators to attach to each instance in the reservation.
.TP 2m
\fBtype\fR
The specific type (e.g. \f5nvidia\-tesla\-k80\fR for nVidia Tesla K80) of
accelerator to attach to instances in the reservation. Use \f5gcloud compute
accelerator\-types list\fR to learn about all available accelerator types.

.RE
.sp
.TP 2m
\fB\-\-source\-local\-ssd\fR=[\fIinterface\fR=\fIINTERFACE\fR],[\fIsize\fR=\fISIZE\fR]

Manage the size and the interface of local SSD to use. See
https://cloud.google.com/compute/docs/disks/local\-ssd for more information.
.RS 2m
.TP 2m
\fBinterface\fR
The kind of disk interface exposed to the VM for this SSD. Valid values are
\f5scsi\fR and \f5nvme\fR. SCSI is the default and is supported by more guest
operating systems. NVME may provide higher performance.
.TP 2m
\fBsize\fR
The size of the local SSD in base\-2 GB.

.RE
.sp
.TP 2m
\fB\-\-source\-share\-setting\fR=\fISOURCE_SHARE_SETTING\fR

The projects that can use the reservation. \fISOURCE_SHARE_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\-\-source\-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.


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