.TH "GCLOUD_COMPUTE_NETWORK\-ATTACHMENTS_CREATE" 1



.SH "NAME"
.HP
gcloud compute network\-attachments create \- create a Google Compute Engine network attachment



.SH "SYNOPSIS"
.HP
\f5gcloud compute network\-attachments create\fR \fINAME\fR \fB\-\-subnets\fR=\fISUBNETS\fR,[\fISUBNETS\fR,...] [\fB\-\-connection\-preference\fR=\fICONNECTION_PREFERENCE\fR;\ default=\f5"ACCEPT_AUTOMATIC"\fR] [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-producer\-accept\-list\fR=[\fIACCEPT_LIST\fR,...]] [\fB\-\-producer\-reject\-list\fR=[\fIREJECT_LIST\fR,...]] [\fB\-\-region\fR=\fIREGION\fR] [\fB\-\-subnets\-region\fR=\fISUBNETS_REGION\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fBgcloud compute network\-attachments create\fR is used to create network
attachments. A service consumer creates network attachments and makes it
available to producers. Service producers then use a multi\-NIC VM to form a
bi\-directional, non\-NAT'd communication channel.



.SH "EXAMPLES"

.RS 2m
$ gcloud compute network\-attachments create \e
    NETWORK_ATTACHMENT_NAME \-\-region=us\-central1 \e
    \-\-subnets=MY_SUBNET \-\-connection\-preference=ACCEPT_MANUAL \e
    \-\-producer\-accept\-list=PROJECT1,PROJECT2 \e
    \-\-producer\-reject\-list=PROJECT3,PROJECT4
.RE

To create a network attachment with a textual description, run:

.RS 2m
$ gcloud compute network\-attachments create \e
    NETWORK_ATTACHMENT_NAME \-\-region=us\-central1 \e
    \-\-subnets=MY_SUBNET \-\-connection\-preference=ACCEPT_MANUAL \e
    \-\-producer\-accept\-list=PROJECT1,PROJECT2 \e
    \-\-producer\-reject\-list=PROJECT3,PROJECT4 \e
    \-\-description='default network attachment'
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fINAME\fR

Name of the network attachment to create.


.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-subnets\fR=\fISUBNETS\fR,[\fISUBNETS\fR,...]

The subnetworks provided by the consumer for the producers


.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-connection\-preference\fR=\fICONNECTION_PREFERENCE\fR; default=\f5"ACCEPT_AUTOMATIC"\fR

The connection preference of network attachment. The value can be set to
ACCEPT_AUTOMATIC or ACCEPT_MANUAL. An ACCEPT_AUTOMATIC network attachment is one
that always accepts the connection from producer NIC. An ACCEPT_MANUAL network
attachment is one that requires an explicit addition of the producer project id
or project number to the producer accept list. \fICONNECTION_PREFERENCE\fR must
be one of: \fBACCEPT_AUTOMATIC\fR, \fBACCEPT_MANUAL\fR.

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

An optional, textual description for the network attachment.

.TP 2m
\fB\-\-producer\-accept\-list\fR=[\fIACCEPT_LIST\fR,...]

Projects that are allowed to connect to this network attachment.

.TP 2m
\fB\-\-producer\-reject\-list\fR=[\fIREJECT_LIST\fR,...]

Projects that are not allowed to connect to this network attachment.

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

Region of the network attachment to create. 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
\fB\-\-subnets\-region\fR=\fISUBNETS_REGION\fR

Region of the subnetworks to operate on. Overrides the default
\fBcompute/region\fR property value for this command invocation.


.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 network\-attachments create
.RE

.RS 2m
$ gcloud beta compute network\-attachments create
.RE