.TH "GCLOUD_NETWORK\-CONNECTIVITY_REGIONAL\-ENDPOINTS_CREATE" 1



.SH "NAME"
.HP
gcloud network\-connectivity regional\-endpoints create \- create a new regional endpoint



.SH "SYNOPSIS"
.HP
\f5gcloud network\-connectivity regional\-endpoints create\fR (\fIREGIONAL_ENDPOINT\fR\ :\ \fB\-\-region\fR=\fIREGION\fR) \fB\-\-target\-google\-api\fR=\fITARGET_GOOGLE_API\fR [\fB\-\-address\fR=\fIADDRESS\fR] [\fB\-\-async\fR] [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-enable\-global\-access\fR] [\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fB\-\-network\fR=\fINETWORK\fR] [\fB\-\-subnetwork\fR=\fISUBNETWORK\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Create a new regional endpoint with the given name.



.SH "EXAMPLES"

To create a regional endpoint with the name 'my\-regional\-endpoint' in
us\-central1 targeting my\-target\-endpoint, run:

.RS 2m
$ gcloud network\-connectivity regional\-endpoints create \e
    my\-regional\-endpoint \-\-region=us\-central1 \e
    [\-\-address=my\-address] [\-\-network=my\-network] \e
    [\-\-subnetwork=my\-subnet] \e
    \-\-target\-google\-api=my\-target\-endpoint [\-\-enable\-global\-access]
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

RegionalEndpoint resource \- Name of the regional endpoint to be created. 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 \f5regional_endpoint\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
\fIREGIONAL_ENDPOINT\fR

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

To set the \f5regional_endpoint\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5regional_endpoint\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\-\-region\fR=\fIREGION\fR

The location Id.


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


.RE
.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-target\-google\-api\fR=\fITARGET_GOOGLE_API\fR

The service endpoint the regional endpoint will connect to.


.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-address\fR=\fIADDRESS\fR

The IP Address of the Regional Endpoint. When no address is provided, an IP from
the subnetwork is allocated. Use one of the following formats:
.RS 2m
.IP "\(em" 2m
IPv4 address as in \f5\fI10.0.0.1\fR\fR
.IP "\(em" 2m
Address resource URI as in
\f5\fIprojects/{project}/regions/{region}/addresses/{address_name}\fR\fR for an
IPv4 or IPv6 address.
.RE
.sp

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

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

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

Description of the regional endpoint.

.TP 2m
\fB\-\-enable\-global\-access\fR

Whether the REGIONAL or GLOBAL access is enabled.

.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\-\-network\fR=\fINETWORK\fR

Consumer's VPC network that this regional endpoint belongs to.

.TP 2m
\fB\-\-subnetwork\fR=\fISUBNETWORK\fR

The name of the subnetwork from which the IP address will be allocated.


.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 \fBnetworkconnectivity/v1\fR API. The full documentation
for this API can be found at:
https://cloud.google.com/network\-connectivity/docs/reference/networkconnectivity/rest



.SH "NOTES"

This variant is also available:

.RS 2m
$ gcloud beta network\-connectivity regional\-endpoints create
.RE