.TH "GCLOUD_VMWARE_PRIVATE\-CLOUDS_CREATE" 1



.SH "NAME"
.HP
gcloud vmware private\-clouds create \- create a VMware Engine private cloud



.SH "SYNOPSIS"
.HP
\f5gcloud vmware private\-clouds create\fR (\fIPRIVATE_CLOUD\fR\ :\ \fB\-\-location\fR=\fILOCATION\fR) \fB\-\-cluster\fR=\fICLUSTER\fR \fB\-\-management\-range\fR=\fIMANAGEMENT_RANGE\fR \fB\-\-node\-type\-config\fR=[\fIcount\fR=\fICOUNT\fR],[\fIcustom\-core\-count\fR=\fICUSTOM\-CORE\-COUNT\fR],[\fItype\fR=\fITYPE\fR] \fB\-\-vmware\-engine\-network\fR=\fIVMWARE_ENGINE_NETWORK\fR [\fB\-\-async\fR] [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-preferred\-zone\fR=\fIPREFERRED_ZONE\fR] [\fB\-\-secondary\-zone\fR=\fISECONDARY_ZONE\fR] [\fB\-\-type\fR=\fITYPE\fR;\ default="STANDARD"] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Create a VMware Engine private cloud. Private cloud creation is considered
finished when the private cloud is in READY state. Check the progress of a
private cloud using \f5gcloud vmware private\-clouds list\fR.



.SH "EXAMPLES"

To create a private cloud in the \f5us\-west2\-a\fR zone using
\f5standard\-72\fR nodes that connects to the \f5my\-network\fR VMware Engine
network, run:


.RS 2m
$ gcloud vmware private\-clouds create my\-private\-cloud \e
    \-\-location=us\-west2\-a \-\-project=my\-project \e
    \-\-cluster=my\-management\-cluster \e
    \-\-node\-type\-config=type=standard\-72,count=3 \e
    \-\-management\-range=192.168.0.0/24 \e
    \-\-vmware\-engine\-network=my\-network
.RE

Or:

.RS 2m
$ gcloud vmware private\-clouds create my\-private\-cloud \e
    \-\-cluster=my\-management\-cluster \e
    \-\-node\-type\-config=type=standard\-72,count=3 \e
    \-\-management\-range=192.168.0.0/24 \e
    \-\-vmware\-engine\-network=my\-network
.RE

In the second example, the project and location are taken from gcloud properties
core/project and compute/zone.


To create a stretched private cloud in the \f5us\-west2\fR region using
\f5us\-west2\-a\fR zone as preferred and \f5us\-west2\-b\fR zone as secondary

.RS 2m
$ gcloud vmware private\-clouds create my\-private\-cloud \e
    \-\-project=sample\-project \-\-location=us\-west2 \e
    \-\-cluster=my\-management\-cluster \e
    \-\-node\-type\-config=type=standard\-72,count=6 \e
    \-\-management\-range=192.168.0.0/24 \e
    \-\-vmware\-engine\-network=my\-network \-\-type=STRETCHED \e
    \-\-preferred\-zone=us\-west2\-a \-\-secondary\-zone=us\-west2\-b
.RE

The project is taken from gcloud properties core/project.



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Private cloud resource \- private_cloud. The arguments in this group can be used
to specify the attributes of this resource. (NOTE) Some attributes are not given
arguments in this group but can be set in other ways.

To set the \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5private_cloud\fR on the command line with a fully
specified name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fIPRIVATE_CLOUD\fR

ID of the private cloud or fully qualified identifier for the private cloud.

To set the \f5private\-cloud\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5private_cloud\fR on the command line.
.RE
.sp

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

.TP 2m
\fB\-\-location\fR=\fILOCATION\fR

Location of the private cloud or cluster.

To set the \f5location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5private_cloud\fR on the command line with a fully
specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-location\fR on the command line;
.IP "\(bu" 2m
set the property \f5compute/zone\fR.
.RE
.sp


.RE
.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m

Cluster resource \- cluster. This represents a Cloud resource. (NOTE) Some
attributes are not given arguments in this group but can be set in other ways.

To set the \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-cluster\fR on the command line with a fully
specified name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

To set the \f5location\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-cluster\fR on the command line with a fully
specified name;
.IP "\(em" 2m
set the property \f5compute/zone\fR.
.RE
.sp

To set the \f5private\-cloud\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-cluster\fR on the command line with a fully
specified name.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fB\-\-cluster\fR=\fICLUSTER\fR

ID of the cluster or fully qualified identifier for the cluster.

To set the \f5cluster\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-cluster\fR on the command line.
.RE
.sp

.RE
.sp
.TP 2m
\fB\-\-management\-range\fR=\fIMANAGEMENT_RANGE\fR

IP address range in the private cloud to use for management appliances, in CIDR
format. Use an IP address range that meets the VMware Engine networking
requirements
(https://cloud.google.com/vmware\-engine/docs/quickstart\-networking\-requirements).

.TP 2m
\fB\-\-node\-type\-config\fR=[\fIcount\fR=\fICOUNT\fR],[\fIcustom\-core\-count\fR=\fICUSTOM\-CORE\-COUNT\fR],[\fItype\fR=\fITYPE\fR]

Information about the type and number of nodes associated with the cluster.

type (required): canonical identifier of the node type.

count (required): number of nodes of this type in the cluster.

custom\-core\-count (optional): customized number of cores available to each
node of the type. To get a list of valid values for your node type, run the
gcloud vmware node\-types describe command and reference the
availableCustomCoreCounts field in the output.

.TP 2m
\fB\-\-vmware\-engine\-network\fR=\fIVMWARE_ENGINE_NETWORK\fR

Resource ID of the VMware Engine network attached to the private cloud.


.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-async\fR

Return immediately, without waiting for the operation in progress to complete.
The default is \fBTrue\fR. Enabled by default, use \fB\-\-no\-async\fR to
disable.

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

Text describing the private cloud.

.TP 2m
\fB\-\-preferred\-zone\fR=\fIPREFERRED_ZONE\fR

Zone that will remain operational when connection between the two zones is lost.
Specify the resource name of a zone that belongs to the region of the private
cloud.

.TP 2m
\fB\-\-secondary\-zone\fR=\fISECONDARY_ZONE\fR

Additional zone for a higher level of availability and load balancing. Specify
the resource name of a zone that belongs to the region of the private cloud.

.TP 2m
\fB\-\-type\fR=\fITYPE\fR; default="STANDARD"

Type of the private cloud. \fITYPE\fR must be one of:

.RS 2m
.TP 2m
\fBSTANDARD\fR
Standard private is a zonal resource, with 3 or more nodes nodes. Default type.
.TP 2m
\fBSTRETCHED\fR
Stretched private cloud is a regional resource with redundancy, with a minimum
of 6 nodes, nodes count has to be even.
.TP 2m
\fBTIME_LIMITED\fR
Time limited private cloud is a zonal resource, can have only 1 node and has
limited life span. Will be deleted after defined period of time, can be
converted into standard private cloud by expanding it up to 3 or more nodes.
.RE
.sp



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