File: //snap/google-cloud-cli/396/help/man/man1/gcloud_service-directory_endpoints_create.1
.TH "GCLOUD_SERVICE\-DIRECTORY_ENDPOINTS_CREATE" 1
.SH "NAME"
.HP
gcloud service\-directory endpoints create \- creates an endpoint
.SH "SYNOPSIS"
.HP
\f5gcloud service\-directory endpoints create\fR (\fIENDPOINT\fR\ :\ \fB\-\-location\fR=\fILOCATION\fR\ \fB\-\-namespace\fR=\fINAMESPACE\fR\ \fB\-\-service\fR=\fISERVICE\fR) [\fB\-\-address\fR=\fIADDRESS\fR] [\fB\-\-annotations\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fB\-\-network\fR=\fINETWORK\fR] [\fB\-\-port\fR=\fIPORT\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]
.SH "DESCRIPTION"
Creates an endpoint.
.SH "EXAMPLES"
To create a Service Directory endpoint, run:
.RS 2m
$ gcloud service\-directory endpoints create my\-endpoint \e
\-\-service=my\-service \-\-namespace=my\-namespace \e
\-\-location=us\-east1 \-\-address=1.2.3.4 \-\-port=5 \e
\-\-annotations=a=b,c=d \e
\-\-network=projects/123456789/locations/global/networks/default
.RE
.SH "POSITIONAL ARGUMENTS"
.RS 2m
.TP 2m
Endpoint resource \- The Service Directory endpoint to create. The endpoint id
must be 1\-63 characters long and match the regular expression
\f5[a\-z](?:[\-a\-z0\-9]{0,61}[a\-z0\-9])?\fR which means the first character
must be a lowercase letter, and all following characters must be a dash,
lowercase letter, or digit, except the last character, which cannot be a dash.
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 \f5endpoint\fR on the command line with a fully specified
name;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp
This must be specified.
.RS 2m
.TP 2m
\fIENDPOINT\fR
ID of the endpoint or fully qualified identifier for the endpoint.
To set the \f5endpoint\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5endpoint\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 name of the region for the endpoint.
To set the \f5location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5endpoint\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\-\-namespace\fR=\fINAMESPACE\fR
The name of the namespace for the endpoint.
To set the \f5namespace\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5endpoint\fR on the command line with a fully specified
name;
.IP "\(bu" 2m
provide the argument \f5\-\-namespace\fR on the command line.
.RE
.sp
.TP 2m
\fB\-\-service\fR=\fISERVICE\fR
The name of the service for the endpoint.
To set the \f5service\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5endpoint\fR on the command line with a fully specified
name;
.IP "\(bu" 2m
provide the argument \f5\-\-service\fR on the command line.
.RE
.sp
.RE
.RE
.sp
.SH "FLAGS"
.RS 2m
.TP 2m
\fB\-\-address\fR=\fIADDRESS\fR
IPv4 or IPv6 address of the endpoint. The default is empty string.
.TP 2m
\fB\-\-annotations\fR=[\fIKEY\fR=\fIVALUE\fR,...]
Annotations for the endpoint.
Annotations take the form of key/value string pairs. Keys are composed of an
optional prefix and a name segment, separated by a slash(/). Prefixes and names
must be composed of alphanumeric characters, dashes, and dots. Names may also
use underscores. There are no character restrictions on what may go into the
value of an annotation. The entire dictionary is limited to 512 characters,
spread across all key\-value pairs.
.TP 2m
\fB\-\-network\fR=\fINETWORK\fR
Specifies the Google Compute Engine Network (VPC) of the Endpoint. Network and
Project existence is not checked. Example:
\f5projects/<PROJECT_NUM>/locations/global/networks/<NETWORK_NAME>\fR The
default is empty string.
.TP 2m
\fB\-\-port\fR=\fIPORT\fR
Port that the endpoint is running on, must be in the range of [0, 65535]. The
default is 0.
.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 service\-directory endpoints create
.RE
.RS 2m
$ gcloud beta service\-directory endpoints create
.RE