REST Resource: folders.locations.notificationConfigs

Resource: NotificationConfig

Cloud Security Command Center (Cloud SCC) notification configs.

A notification config is a Cloud SCC resource that contains the configuration to send notifications for create/update events of findings, assets and etc.

JSON representation
{
  "name": string,
  "description": string,
  "pubsubTopic": string,
  "serviceAccount": string,

  // Union field notify_config can be only one of the following:
  "streamingConfig": {
    object (StreamingConfig)
  }
  // End of list of possible types for union field notify_config.
}
Fields
name

string

Identifier. The relative resource name of this notification config. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name The following list shows some examples: + organizations/{organization_id}/locations/{locationId}/notificationConfigs/notify_public_bucket + folders/{folder_id}/locations/{locationId}/notificationConfigs/notify_public_bucket + projects/{projectId}/locations/{locationId}/notificationConfigs/notify_public_bucket

description

string

The description of the notification config (max of 1024 characters).

pubsubTopic

string

The Pub/Sub topic to send notifications to. Its format is "projects/[projectId]/topics/[topic]".

serviceAccount

string

Output only. The service account that needs "pubsub.topics.publish" permission to publish to the Pub/Sub topic.

Union field notify_config. The config for triggering notifications. notify_config can be only one of the following:
streamingConfig

object (StreamingConfig)

The config for triggering streaming-based notifications.

StreamingConfig

The config for streaming-based notifications, which send each event as soon as it is detected.

JSON representation
{
  "filter": string
}
Fields
filter

string

Expression that defines the filter to apply across create/update events of assets or findings as specified by the event type. The expression is a list of zero or more restrictions combined via logical operators AND and OR. Parentheses are supported, and OR has higher precedence than AND.

Restrictions have the form <field> <operator> <value> and may have a - character in front of them to indicate negation. The fields map to those defined in the corresponding resource.

The supported operators are:

  • = for all value types.
  • >, <, >=, <= for integer values.
  • :, meaning substring matching, for strings.

The supported value types are:

  • string literals in quotes.
  • integer literals without quotes.
  • boolean literals true and false without quotes.

Methods

create

Creates a notification config.

delete

Deletes a notification config.

get

Gets a notification config.

list

Lists notification configs.

patch

Updates a notification config.