.TH "GCLOUD_COMPUTE_RESERVATIONS_CREATE" 1



.SH "NAME"
.HP
gcloud compute reservations create \- create a Compute Engine reservation



.SH "SYNOPSIS"
.HP
\f5gcloud compute reservations create\fR \fIRESERVATION\fR (\fB\-\-vm\-count\fR=\fIVM_COUNT\fR\ (\fB\-\-source\-instance\-template\fR=\fISOURCE_INSTANCE_TEMPLATE\fR\ |\ [\fB\-\-machine\-type\fR=\fIMACHINE_TYPE\fR\ :\ \fB\-\-accelerator\fR=[\fIcount\fR=\fICOUNT\fR],[\fItype\fR=\fITYPE\fR]\ \fB\-\-local\-ssd\fR=[\fIcount\fR=\fICOUNT\fR],[\fIinterface\fR=\fIINTERFACE\fR],[\fIsize\fR=\fISIZE\fR]\ \fB\-\-min\-cpu\-platform\fR=\fIMIN_CPU_PLATFORM\fR])\ :\ \fB\-\-require\-specific\-reservation\fR\ \fB\-\-resource\-policies\fR=[\fIKEY\fR=\fIVALUE\fR,...]) [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-reservation\-sharing\-policy\fR=\fIRESERVATION_SHARING_POLICY\fR] [\fB\-\-zone\fR=\fIZONE\fR] [\fB\-\-share\-setting\fR=\fISHARE_SETTING\fR\ \fB\-\-share\-with\fR=\fISHARE_WITH\fR,[\fISHARE_WITH\fR,...]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Create a Compute Engine reservation.



.SH "EXAMPLES"

To create a Compute Engine reservation by specifying VM properties using an
instance template, run:

.RS 2m
$ gcloud compute reservations create my\-reservation \-\-vm\-count=1 \e
  \-\-source\-instance\-template=example\-instance\-template \e
  \-\-zone=fake\-zone
.RE

To create a Compute Engine reservation by directly specifying VM properties,
run:

.RS 2m
$ gcloud compute reservations create my\-reservation \-\-vm\-count=1 \e
  \-\-machine\-type=custom\-8\-10240 \e
  \-\-min\-cpu\-platform="Intel Haswell" \e
  \-\-accelerator=count=2,type=nvidia\-tesla\-v100 \e
  \-\-local\-ssd=size=375,interface=scsi \-\-zone=fake\-zone
.RE



.SH "POSITIONAL ARGUMENTS"

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

Name of the reservation to create.


.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m

Manage the SpecificSKU reservation properties.

This must be specified.


.RS 2m
.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].

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

.TP 2m
\fB\-\-require\-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.

.TP 2m
\fB\-\-resource\-policies\fR=[\fIKEY\fR=\fIVALUE\fR,...]

The resource policies to include in this reservation. If you omit this flag, no
resource policies are added. You can specify any string as the key, and specify
the name of a resource policy as the value.

.TP 2m

Manage the instance properties for the SpecificSKU reservation.

Exactly one of these must be specified:


.RS 2m
.TP 2m
\fB\-\-source\-instance\-template\fR=\fISOURCE_INSTANCE_TEMPLATE\fR

The url of the instance template that will be used to populate the fields of the
reservation. Instance properties can not be defined in addition to source
instance template.

.TP 2m

Define the individual instance properties for the SpecificSKU reservation.


.RS 2m
.TP 2m
\fB\-\-machine\-type\fR=\fIMACHINE_TYPE\fR

The type of machine (name only) that has a fixed number of vCPUs and a fixed
amount of memory. You can also specify a custom machine type by using the
pattern \f5custom\-number_of_CPUs\-amount_of_memory\fR\-for example,
\f5custom\-32\-29440\fR.

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

.TP 2m
\fB\-\-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\-\-local\-ssd\fR=[\fIcount\fR=\fICOUNT\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.
.TP 2m
\fBcount\fR
The number of local SSD to use per VM. If you don't specify this argument, then
the default value is 1.

.RE
.sp
.TP 2m
\fB\-\-min\-cpu\-platform\fR=\fIMIN_CPU_PLATFORM\fR

Optional minimum CPU platform of the reservation to create.


.RE
.RE
.RE
.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-description\fR=\fIDESCRIPTION\fR

An optional description of the reservation to create.

.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\-\-zone\fR=\fIZONE\fR

Zone of the reservation to create. 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 the properties of a shared reservation.


.RS 2m
.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.


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

These variants are also available:

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

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