.TH "GCLOUD_SCC_NOTIFICATIONS_CREATE" 1



.SH "NAME"
.HP
gcloud scc notifications create \- create a Security Command Center notification config



.SH "SYNOPSIS"
.HP
\f5gcloud scc notifications create\fR \fINOTIFICATION_CONFIG_ID\fR \fB\-\-pubsub\-topic\fR=\fIPUBSUB_TOPIC\fR [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-filter\fR=\fIFILTER\fR] [\fB\-\-location\fR=\fILOCATION\fR;\ default="global"] [\fB\-\-folder\fR=\fIFOLDER\fR\ |\ \fB\-\-organization\fR=\fIORGANIZATION\fR\ |\ \fB\-\-project\fR=\fIPROJECT\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Create a Security Command Center notification config.

Notification configs that are created with Security Command Center API V2 and
later include a \f5location\fR attribute. If a location is not specified, the
default \f5global\fR location is used. For example, the following Notification
config name has \f5location=global\fR attribute:
\f5organizations/123/locations/global/notificationConfigs/my\-config\fR.



.SH "EXAMPLES"

Create a notification config test\-config under organization 123 for findings
for pubsub\-topic projects/test\-project/topics/notification\-test with a filter
on resource name:

.RS 2m
$ gcloud scc notifications create test\-config \-\-organization=123 \e
    \-\-pubsub\-topic=projects/test\-project/topics/notification\-test \e
    \-\-filter="resource_name: \e"a\e""
.RE

Create a notification config \f5test\-config\fR under folder \f5456\fR for
findings for pubsub\-topic
\f5projects/test\-project/topics/notification\-test\fR with a filter on resource
name:

.RS 2m
$ gcloud scc notifications create test\-config \-\-folder=456 \e
    \-\-pubsub\-topic=projects/test\-project/topics/notification\-test \e
    \-\-filter="resource_name: \e"a\e""
.RE

Create a notification config \f5test\-config\fR under project \f5789\fR for
findings for pubsub\-topic
\f5projects/test\-project/topics/notification\-test\fR with a filter on resource
name:

.RS 2m
$ gcloud scc notifications create test\-config \-\-project=789 \e
    \-\-pubsub\-topic=projects/test\-project/topics/notification\-test \e
    \-\-filter="resource_name: \e"a\e""
.RE

Create a notification config \f5test\-config\fR under organization \f5123\fR for
findings for \f5pubsub\-topic
projects/test\-project/topics/notification\-test\fR with a filter on resource
name and \f5location=eu\fR

.RS 2m
$ gcloud scc notifications create test\-config \-\-project=789 \e
    \-\-pubsub\-topic=projects/test\-project/topics/notification\-test \e
    \-\-filter="resource_name: \e"a\e"" \-\-location=eu
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fINOTIFICATION_CONFIG_ID\fR

The ID of the notification config. Formatted as
"organizations/123/notificationConfigs/456" or just "456".


.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-pubsub\-topic\fR=\fIPUBSUB_TOPIC\fR

The Pub/Sub topic which will receive notifications. Its format is
"projects/[project_id]/topics/[topic]".


.RE
.sp

.SH "OPTIONAL FLAGS"

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

The text that will be used to describe a notification configuration.

.TP 2m
\fB\-\-filter\fR=\fIFILTER\fR

Filter to be used for notification config.

.TP 2m
\fB\-\-location\fR=\fILOCATION\fR; default="global"

If data residency is enabled, specify the Security Command Center location in
which to create the notification. The resulting \f5notificationConfig\fR
resource is stored only in this location. Only findings that are issued in this
location are sent to Pub/Sub.

If data residency is not enabled, specifying the \f5\-\-location\fR flag creates
the notification by using Security Command Center API v2, and the only valid
value for the flag is \f5global\fR.

.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-folder\fR=\fIFOLDER\fR

Folder where the notification config resides. Formatted as
\f5\fIfolders/456\fR\fR or just \f5\fI456\fR\fR.

.TP 2m
\fB\-\-organization\fR=\fIORGANIZATION\fR

Organization where the notification config resides. Formatted as
\f5\fIorganizations/123\fR\fR or just \f5\fI123\fR\fR.

.TP 2m
\fB\-\-project\fR=\fIPROJECT\fR

Project (ID or number) where the notification config resides. Formatted as
\f5\fIprojects/789\fR\fR or just \f5\fI789\fR\fR.


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

This command uses the Security Command Center API. For more information, see
Security Command Center API.
(https://cloud.google.com/security\-command\-center/docs/reference/rest)



.SH "NOTES"

These variants are also available:

.RS 2m
$ gcloud alpha scc notifications create
.RE

.RS 2m
$ gcloud beta scc notifications create
.RE