.TH "GCLOUD_COMPUTE_NETWORKS_CREATE" 1



.SH "NAME"
.HP
gcloud compute networks create \- create a Compute Engine network



.SH "SYNOPSIS"
.HP
\f5gcloud compute networks create\fR \fINAME\fR [\fB\-\-bgp\-routing\-mode\fR=\fIMODE\fR;\ default="regional"] [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-[no\-]enable\-ula\-internal\-ipv6\fR] [\fB\-\-internal\-ipv6\-range\fR=\fIINTERNAL_IPV6_RANGE\fR] [\fB\-\-mtu\fR=\fIMTU\fR] [\fB\-\-network\-firewall\-policy\-enforcement\-order\fR=\fINETWORK_FIREWALL_POLICY_ENFORCEMENT_ORDER\fR] [\fB\-\-network\-profile\fR=\fINETWORK_PROFILE\fR] [\fB\-\-range\fR=\fIRANGE\fR] [\fB\-\-resource\-manager\-tags\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fB\-\-subnet\-mode\fR=\fIMODE\fR] [\fB\-\-bgp\-best\-path\-selection\-mode\fR=\fIBGP_BEST_PATH_SELECTION_MODE\fR\ \fB\-\-[no\-]bgp\-bps\-always\-compare\-med\fR\ \fB\-\-bgp\-bps\-inter\-region\-cost\fR=\fIBGP_BPS_INTER_REGION_COST\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fBgcloud compute networks create\fR is used to create virtual networks. A
network performs the same function that a router does in a home network: it
describes the network range and gateway IP address, handles communication
between instances, and serves as a gateway between instances and callers outside
the network.



.SH "EXAMPLES"

To create a regional auto subnet mode network with the name 'network\-name',
run:

.RS 2m
$ gcloud compute networks create network\-name
.RE

To create a global custom subnet mode network with the name 'network\-name',
run:

.RS 2m
$ gcloud compute networks create network\-name \e
    \-\-bgp\-routing\-mode=global \-\-subnet\-mode=custom
.RE



.SH "POSITIONAL ARGUMENTS"

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

Name of the network to create.


.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-bgp\-routing\-mode\fR=\fIMODE\fR; default="regional"

The BGP routing mode for this network. If not specified, defaults to regional.

\fIMODE\fR must be one of:

.RS 2m
.TP 2m
\fBglobal\fR
Cloud Routers in this network advertise subnetworks from all regions to their
BGP peers, and program instances in all regions with the router's best learned
BGP routes.
.TP 2m
\fBregional\fR
Cloud Routers in this network advertise subnetworks from their local region only
to their BGP peers, and program instances in their local region only with the
router's best learned BGP routes.
.RE
.sp


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

An optional, textual description for the network.

.TP 2m
\fB\-\-[no\-]enable\-ula\-internal\-ipv6\fR

Enable/disable ULA internal IPv6 on this network. Enabling this feature will
assign a /48 from google defined ULA prefix fd20::/20.

Use \fB\-\-enable\-ula\-internal\-ipv6\fR to enable and
\fB\-\-no\-enable\-ula\-internal\-ipv6\fR to disable.

.TP 2m
\fB\-\-internal\-ipv6\-range\fR=\fIINTERNAL_IPV6_RANGE\fR

When enabling ULA internal IPv6, caller can optionally specify the /48 range
they want from the google defined ULA prefix fd20::/20. ULA_IPV6_RANGE must be a
valid /48 ULA IPv6 address and within the fd20::/20. Operation will fail if the
speficied /48 is already in used by another resource. If the field is not
speficied, then a /48 range will be randomly allocated from fd20::/20 and
returned via this field.

.TP 2m
\fB\-\-mtu\fR=\fIMTU\fR

Maximum transmission unit (MTU) is the size of the largest IP packet that can be
transmitted on this network. Default value is 1460 bytes. The minimum value is
1300 bytes and the maximum value is 8896 bytes. The MTU advertised via DHCP to
all instances attached to this network.

.TP 2m
\fB\-\-network\-firewall\-policy\-enforcement\-order\fR=\fINETWORK_FIREWALL_POLICY_ENFORCEMENT_ORDER\fR

The Network Firewall Policy enforcement order of this network. If not specified,
defaults to AFTER_CLASSIC_FIREWALL.

\fINETWORK_FIREWALL_POLICY_ENFORCEMENT_ORDER\fR must be one of:

.RS 2m
.TP 2m
\fBAFTER_CLASSIC_FIREWALL\fR
Network Firewall Policy is enforced after classic firewall.
.TP 2m
\fBBEFORE_CLASSIC_FIREWALL\fR
Network Firewall Policy is enforced before classic firewall.
.RE
.sp


.TP 2m
\fB\-\-network\-profile\fR=\fINETWORK_PROFILE\fR

The network profile to apply to this network.

.TP 2m
\fB\-\-range\fR=\fIRANGE\fR

Specifies the IPv4 address range of legacy mode networks. The range must be
specified in CIDR format:
http://en.wikipedia.org/wiki/Classless_Inter\-Domain_Routing

This flag only works if mode is legacy
(https://cloud.google.com/compute/docs/vpc/legacy).

Using legacy networks is **DEPRECATED**, given that many newer Google Cloud
Platform features are not supported on legacy networks. Please be advised that
legacy networks may not be supported in the future.

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

A comma\-separated list of Resource Manager tags to apply to the network.

.TP 2m
\fB\-\-subnet\-mode\fR=\fIMODE\fR

The subnet mode of the network. If not specified, defaults to AUTO.

\fIMODE\fR must be one of:

.RS 2m
.TP 2m
\fBauto\fR
Subnets are created automatically. This is the recommended selection.
.TP 2m
\fBcustom\fR
Create subnets manually.
.TP 2m
\fBlegacy\fR
[Deprecated] Create an old style network that has a range and cannot have
subnets. This is not recommended for new networks.
.RE
.sp


.TP 2m

BGP Best Path Selection flags


.RS 2m
.TP 2m
\fB\-\-bgp\-best\-path\-selection\-mode\fR=\fIBGP_BEST_PATH_SELECTION_MODE\fR

The BGP best path selection algorithm to be employed.
\fIBGP_BEST_PATH_SELECTION_MODE\fR must be one of:

.RS 2m
.TP 2m
\fBLEGACY\fR
Dynamic routes are ranked based on the multiple exit\-discriminator (MED) BGP
attribute. When global routing is enabled, the MED of the routes received from
other regions is the original MED plus the region\-to\-region cost.
.TP 2m
\fBSTANDARD\fR
Dynamic routes are ranked based on AS Path, Origin, Neighbor ASN and MED BGP
attributes. When global routing is enabled, region\-to\-region cost is used as a
tiebreaker. This mode offers customizations to fine\-tune BGP best path routing
with additional flags like \-\-bgp\-bps\-always\-compare\-med and
\-\-bgp\-bps\-inter\-region\-cost
.RE
.sp


.TP 2m
\fB\-\-[no\-]bgp\-bps\-always\-compare\-med\fR

Enables/disables the comparison of MED across routes with different Neighbor
ASNs. This value can only be set if the \-\-bgp\-best\-path\-selection\-mode is
STANDARD. Use \fB\-\-bgp\-bps\-always\-compare\-med\fR to enable and
\fB\-\-no\-bgp\-bps\-always\-compare\-med\fR to disable.

.TP 2m
\fB\-\-bgp\-bps\-inter\-region\-cost\fR=\fIBGP_BPS_INTER_REGION_COST\fR

Defines the preferred approach for handling inter\-region cost in the selection
process. This value can only be set if the \-\-bgp\-best\-path\-selection\-mode
is STANDARD. \fIBGP_BPS_INTER_REGION_COST\fR must be one of:

.RS 2m
.TP 2m
\fBADD_COST_TO_MED\fR
Adds inter\-region cost to the MED before comparing the MED value. When multiple
routes have the same value after the Add\-cost\-to\-med comparison, the route
selection continues and prefers the route with lowest cost.
.TP 2m
\fBDEFAULT\fR
MED is compared as originally received from peers. When multiple routes have the
same MED, cost is evaluated as the next step.
.RE
.sp



.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 networks create
.RE

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