- NAME
-
- gcloud alpha scc notifications create - create a Security Command Center notification config
- SYNOPSIS
-
-
gcloud alpha scc notifications create
NOTIFICATION_CONFIG_ID
--pubsub-topic
=PUBSUB_TOPIC
[--description
=DESCRIPTION
] [--filter
=FILTER
] [--location
=LOCATION
; default="global"] [--folder
=FOLDER
|--organization
=ORGANIZATION
|--project
=PROJECT
] [GCLOUD_WIDE_FLAG …
]
-
- DESCRIPTION
-
(ALPHA)
Create a Security Command Center notification config.Notification configs that are created with Security Command Center API V2 and later include a
location
attribute. If a location is not specified, the defaultglobal
location is used. For example, the following Notification config name haslocation=global
attribute:organizations/123/locations/global/notificationConfigs/my-config
. - 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:
gcloud alpha scc notifications create test-config --organization=123 --pubsub-topic=projects/test-project/topics/notification-test --filter="resource_name: \"a\""
Create a notification config
test-config
under folder456
for findings for pubsub-topicprojects/test-project/topics/notification-test
with a filter on resource name:gcloud alpha scc notifications create test-config --folder=456 --pubsub-topic=projects/test-project/topics/notification-test --filter="resource_name: \"a\""
Create a notification config
test-config
under project789
for findings for pubsub-topicprojects/test-project/topics/notification-test
with a filter on resource name:gcloud alpha scc notifications create test-config --project=789 --pubsub-topic=projects/test-project/topics/notification-test --filter="resource_name: \"a\""
Create a notification config
test-config
under organization123
for findings forpubsub-topic projects/test-project/topics/notification-test
with a filter on resource name andlocation=eu
gcloud alpha scc notifications create test-config --project=789 --pubsub-topic=projects/test-project/topics/notification-test --filter="resource_name: \"a\"" --location=eu
- POSITIONAL ARGUMENTS
-
NOTIFICATION_CONFIG_ID
- The ID of the notification config. Formatted as "organizations/123/notificationConfigs/456" or just "456".
- REQUIRED FLAGS
-
--pubsub-topic
=PUBSUB_TOPIC
- The Pub/Sub topic which will receive notifications. Its format is "projects/[project_id]/topics/[topic]".
- OPTIONAL FLAGS
-
--description
=DESCRIPTION
- The text that will be used to describe a notification configuration.
--filter
=FILTER
- Filter to be used for notification config.
--location
=LOCATION
; default="global"-
If data residency is enabled, specify the Security Command Center location in
which to create the notification. The resulting
notificationConfig
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
--location
flag creates the notification by using Security Command Center API v2, and the only valid value for the flag isglobal
. -
At most one of these can be specified:
--folder
=FOLDER
-
Folder where the notification config resides. Formatted as
or justfolders/456
.456
--organization
=ORGANIZATION
-
Organization where the notification config resides. Formatted as
or justorganizations/123
.123
--project
=PROJECT
-
Project (ID or number) where the notification config resides. Formatted as
or justprojects/789
.789
- 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
$ gcloud help
for details. - API REFERENCE
- This command uses the Security Command Center API. For more information, see Security Command Center API.
- NOTES
-
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct project,
you might be trying to access an API with an invitation-only early access
allowlist. These variants are also available:
gcloud scc notifications create
gcloud beta scc notifications create
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-06-04 UTC.