.TH "GCLOUD_EDGE\-CLOUD_NETWORKING_SUBNETS_CREATE" 1



.SH "NAME"
.HP
gcloud edge\-cloud networking subnets create \- create a Distributed Cloud Edge Network subnet



.SH "SYNOPSIS"
.HP
\f5gcloud edge\-cloud networking subnets create\fR (\fISUBNET\fR\ :\ \fB\-\-location\fR=\fILOCATION\fR\ \fB\-\-zone\fR=\fIZONE\fR) \fB\-\-network\fR=\fINETWORK\fR [\fB\-\-async\fR] [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-ipv4\-range\fR=[\fIIPV4_RANGE\fR,...]] [\fB\-\-ipv6\-range\fR=[\fIIPV6_RANGE\fR,...]] [\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fB\-\-vlan\-id\fR=\fIVLAN_ID\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Create a new Distributed Cloud Edge Network subnet.



.SH "EXAMPLES"

To create a Distributed Cloud Edge Network subnet called \f5my\-subnet\fR with
VLAN ID and owned ip ranges specified in the edge zone
\'us\-central1\-edge\-den1', run:

.RS 2m
$ gcloud edge\-cloud networking subnets create my\-subnet \e
    \-\-network=my\-network \-\-location=us\-central1 \e
    \-\-zone=us\-central1\-edge\-den1 \e
    \-\-ipv4\-range=192.168.1.1/24,172.10.10.1/24 \e
    \-\-ipv6\-range=2001:db8::1/64,4001:230::1/64 \-\-vlan\-id=100 \e
    \-\-bonding\-type=bonded
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Subnet resource \- Distributed Cloud Edge Network subnet to create. 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 \f5subnet\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
\fISUBNET\fR

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

To set the \f5subnet\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5subnet\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 global location name.

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

.TP 2m
\fB\-\-zone\fR=\fIZONE\fR

The name of the Google Distributed Cloud Edge zone.

To set the \f5zone\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5subnet\fR on the command line with a fully specified
name;
.IP "\(bu" 2m
provide the argument \f5\-\-zone\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-network\fR=\fINETWORK\fR

The network that this subnetwork belongs to.


.RE
.sp

.SH "OPTIONAL FLAGS"

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

Return immediately, without waiting for the operation in progress to complete.

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

An optional, textual description for the subnet.

.TP 2m
\fB\-\-ipv4\-range\fR=[\fIIPV4_RANGE\fR,...]

The ranges of ipv4 addresses that are owned by this subnetwork in CIDR format.

.TP 2m
\fB\-\-ipv6\-range\fR=[\fIIPV6_RANGE\fR,...]

The ranges of ipv6 addresses that are owned by this subnetwork in CIDR format.

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

List of label KEY=VALUE pairs to add.

Keys must start with a lowercase character and contain only hyphens (\f5\-\fR),
underscores (\f5_\fR), lowercase characters, and numbers. Values must contain
only hyphens (\f5\-\fR), underscores (\f5_\fR), lowercase characters, and
numbers.

.TP 2m
\fB\-\-vlan\-id\fR=\fIVLAN_ID\fR

The ID of the VLAN to tag the subnetwork. If not specified we assign one
automatically.


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

This command uses the \fBedgenetwork/v1\fR API. The full documentation for this
API can be found at: https://cloud.google.com/distributed\-cloud\-edge/docs



.SH "NOTES"

This variant is also available:

.RS 2m
$ gcloud alpha edge\-cloud networking subnets create
.RE