.TH "GCLOUD_VMWARE_PRIVATE\-CONNECTIONS_CREATE" 1



.SH "NAME"
.HP
gcloud vmware private\-connections create \- create a Google Cloud Private Connection



.SH "SYNOPSIS"
.HP
\f5gcloud vmware private\-connections create\fR (\fIPRIVATE_CONNECTION\fR\ :\ \fB\-\-location\fR=\fILOCATION\fR) \fB\-\-service\-project\fR=\fISERVICE_PROJECT\fR \fB\-\-type\fR=\fITYPE\fR \fB\-\-vmware\-engine\-network\fR=\fIVMWARE_ENGINE_NETWORK\fR [\fB\-\-async\fR] [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-routing\-mode\fR=\fIROUTING_MODE\fR] [\fB\-\-service\-network\fR=\fISERVICE_NETWORK\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Creates a new private connection to connect VMware Engine Network to the
specified VPC network. This establishes private IP connectivity between the VPC
network and all the VMware Private Clouds attached to the VMware Engine Network.
Private connection creation is considered finished when the connection is in
ACTIVE state. Check the progress of the private connection using \f5gcloud
vmware private\-connections list\fR.



.SH "EXAMPLES"

To create a Private Connection of type PRIVATE_SERVICE_ACCESS, first obtain the
service\-project by listing vpc\-peerings, run:

.RS 2m
$ gcloud compute networks peerings list \-\-network=my\-vpc \e
    \-\-project=my\-project
.RE

where my\-vpc is the VPC on which a private service access connection is created
and project is the one in which the private connection will be created.

The response will be of this format:

NAME NETWORK PEER_PROJECT

servicenetworking\-googleapis\-com my\-vpc td096d594ece09650\-tp

The PEER_PROJECT field in the output of the command will provide the value for
the service\-project required for creating the private connection.

To create a Private Connection called \f5my\-private\-connection\fR of type
\f5PRIVATE_SERVICE_ACCESS\fR in project \f5my\-project\fR and region
\f5us\-west1\fR with routing_mode \f5REGIONAL\fR to connect service networking
VPC from project \f5td096d594ece09650\-tp\fR to legacy VMware Engine Network
\f5us\-west1\-default\fR, run:

.RS 2m
$ gcloud vmware private\-connections create my\-private\-connection \e
    \-\-location=us\-west1 \-\-project=my\-project \e
    \-\-vmware\-engine\-network=us\-west1\-default \e
    \-\-description="A short description for the new private \e
connection" \-\-routing\-mode=REGIONAL \e
    \-\-service\-project=td096d594ece09650\-tp \e
    \-\-type=PRIVATE_SERVICE_ACCESS
.RE

Or:

.RS 2m
$ gcloud vmware private\-connections create my\-private\-connection \e
    \-\-vmware\-engine\-network=us\-west1\-default \e
    \-\-description="A short description for the new private \e
connection" \-\-routing\-mode=REGIONAL \e
    \-\-service\-project=td096d594ece09650\-tp \e
    \-\-type=PRIVATE_SERVICE_ACCESS
.RE

.RS 2m
In the second example, the project and location are taken from gcloud properties core/project and compute/region, respectively.
.RE

To create a Private Connection called \f5my\-private\-connection\fR of type
\f5THIRD_PARTY_SERVICE\fR in project \f5my\-project\fR and region
\f5us\-west1\fR to connect VPC \f5my\-service\-network\fR from project
\f5td096d594ece09650\-tp\fR to legacy VMware Engine Network
\f5us\-west1\-default\fR, run:

.RS 2m
$ gcloud vmware private\-connections create my\-private\-connection \e
    \-\-location=us\-west1 \-\-project=my\-project \e
    \-\-vmware\-engine\-network=us\-west1\-default \e
    \-\-description="A short description for the new private \e
connection" \-\-service\-network=my\-service\-network \e
    \-\-service\-project=td096d594ece09650\-tp \e
    \-\-type=THIRD_PARTY_SERVICE
.RE

Or:

.RS 2m
$ gcloud vmware private\-connections create my\-private\-connection \e
    \-\-vmware\-engine\-network=us\-west1\-default \e
    \-\-description="A short description for the new private \e
connection" \-\-service\-network=my\-service\-network \e
    \-\-service\-project=td096d594ece09650\-tp \e
    \-\-type=THIRD_PARTY_SERVICE
.RE

.RS 2m
In the above example, the project and location are taken from gcloud properties core/project and compute/region, respectively.
.RE

If you try to create a private connection of type=THIRD_PARTY_SERVICE, and do
not provide the service\-network field, an error will be thrown with the
message:

Missing required argument [\-\-service\-network]: For private connection of type
THIRD_PARTY_SERVICE, service\-network field is required



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Private Connection resource \- private_connection. 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_connection\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_CONNECTION\fR

ID of the Private Connection or fully qualified identifier for the Private
Connection.

To set the \f5private\-connection\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5private_connection\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

The resource name of the location.

To set the \f5location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5private_connection\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/region\fR.
.RE
.sp


.RE
.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-service\-project\fR=\fISERVICE_PROJECT\fR

Project ID or project number of the service network.

.TP 2m
\fB\-\-type\fR=\fITYPE\fR

Type of private connection. \fITYPE\fR must be one of:

.RS 2m
.TP 2m
\fBDELL_POWERSCALE\fR
Peering connection used for connecting to Dell PowerScale.
.TP 2m
\fBNETAPP_CLOUD_VOLUMES\fR
Peering connection used for connecting to NetApp Cloud Volumes.
.TP 2m
\fBPRIVATE_SERVICE_ACCESS\fR
Peering connection used for establishing private services access
(https://cloud.google.com/vpc/docs/private\-services\-access).
.TP 2m
\fBTHIRD_PARTY_SERVICE\fR
Peering connection used for connecting to third\-party services. Most
third\-party services require manual setup of reverse peering on the VPC network
associated with the third\-party service.
.RE
.sp


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

Resource ID of the legacy VMware Engine network. Provide the
{vmware_engine_network_id}, which will be in the form of {location}\-default.
The {location} is the same as the location specified in the private connection
resource.


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

.TP 2m
\fB\-\-routing\-mode\fR=\fIROUTING_MODE\fR

Type of the routing mode. Default value is set to GLOBAL. For
type=PRIVATE_SERVICE_ACCESS, this field can be set to GLOBAL or REGIONAL, for
other types only GLOBAL is supported. \fIROUTING_MODE\fR must be one of:
\fBGLOBAL\fR, \fBREGIONAL\fR.

.TP 2m
\fB\-\-service\-network\fR=\fISERVICE_NETWORK\fR

Resource ID of the service network to connect with the VMware Engine network to
create a private connection.
.RS 2m
.IP "\(em" 2m
For type=PRIVATE_SERVICE_ACCESS, this field represents service networking VPC.
In this case the field value will be automatically set to
\f5servicenetworking\fR and cannot be changed.
.IP "\(em" 2m
For type=NETAPP_CLOUD_VOLUME, this field represents NetApp service VPC. In this
case the field value will be automatically set to \f5netapp\-tenant\-vpc\fR and
cannot be changed.
.IP "\(em" 2m
For type=DELL_POWERSCALE, this field represents Dell service VPC. In this case
the field value will be automatically set to \f5dell\-tenant\-vpc\fR and cannot
be changed.
.IP "\(em" 2m
For type=THIRD_PARTY_SERVICE, this field could represent a consumer VPC or any
other producer VPC to which the VMware Engine Network needs to be connected.
service\-network field is required for this type.
.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.