.TH "GCLOUD_BETA_IDS_ENDPOINTS_CREATE" 1



.SH "NAME"
.HP
gcloud beta ids endpoints create \- create a Cloud IDS endpoint



.SH "SYNOPSIS"
.HP
\f5gcloud beta ids endpoints create\fR (\fIENDPOINT\fR\ :\ \fB\-\-zone\fR=\fIZONE\fR) \fB\-\-network\fR=\fINETWORK\fR \fB\-\-severity\fR=\fISEVERITY\fR [\fB\-\-async\fR] [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-enable\-traffic\-logs\fR] [\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fB\-\-max\-wait\fR=\fIMAX_WAIT\fR;\ default="60m"] [\fB\-\-threat\-exceptions\fR=[\fIexc1\fR,\fIexc2\fR,...,...]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(BETA)\fR Create an endpoint for the specified VPC network. Successful
creation of an endpoint results in an endpoint in READY state. Check the
progress of endpoint creation by using \f5gcloud alpha ids endpoints list\fR.

For more examples, refer to the EXAMPLES section below.



.SH "EXAMPLES"

To create an endpoint called \f5my\-endpoint\fR for VPC network \f5my\-net\fR,
in zone \f5us\-central1\-a\fR, alerting on LOW threats or higher, run:

.RS 2m
$ gcloud beta ids endpoints create my\-endpoint \-\-network=my\-net \e
    \-\-zone=us\-central1\-a \-\-project=my\-project \-\-severity=LOW
.RE

To create an endpoint called \f5my\-endpoint\fR for VPC network \f5my\-net\fR,
in zone \f5us\-central1\-a\fR, alerting on LOW threats or higher, excluding
threat IDs 1000 and 2000, run:

.RS 2m
$ gcloud beta ids endpoints create my\-endpoint \-\-network=my\-net \e
    \-\-zone=us\-central1\-a \-\-project=my\-project \-\-severity=LOW \e
    \-\-threat\-exceptions=1000,2000
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Endpoint resource \- endpoint. 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
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
\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\-\-zone\fR=\fIZONE\fR

Zone of the endpoint.

To set the \f5zone\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\-\-zone\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "REQUIRED FLAGS"

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

Name of the VPC network to monitor

.TP 2m
\fB\-\-severity\fR=\fISEVERITY\fR

Minimum severity of threats to report on. \fISEVERITY\fR must be one of:
\fBINFORMATIONAL\fR, \fBLOW\fR, \fBMEDIUM\fR, \fBHIGH\fR, \fBCRITICAL\fR.


.RE
.sp

.SH "OPTIONAL FLAGS"

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

Return immediately, without waiting for the operation in progress to complete.
The default is \fBTrue\fR. Enabled by default, use \fB\-\-no\-async\fR to
disable.

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

Description of the endpoint.

.TP 2m
\fB\-\-enable\-traffic\-logs\fR

Whether to enable traffic logs on the endpoint. Enabling traffic logs can
generate a large number of logs which can increase costs in Cloud Logging.

.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\-\-max\-wait\fR=\fIMAX_WAIT\fR; default="60m"

Time to synchronously wait for the operation to complete, after which the
operation continues asynchronously. Ignored if \-\-no\-async isn't specified.
See $ gcloud topic datetimes for information on time formats.

.TP 2m
\fB\-\-threat\-exceptions\fR=[\fIexc1\fR,\fIexc2\fR,...,...]

List of threat IDs to be excepted from alerting. Passing empty list clears the
exceptions.


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

This command is currently in beta and might change without notice. These
variants are also available:

.RS 2m
$ gcloud ids endpoints create
.RE

.RS 2m
$ gcloud alpha ids endpoints create
.RE