REST Resource: organizations.notificationConfigs

Ressource: NotificationConfig

Benachrichtigungskonfigurationen des Security Command Centers

Eine Benachrichtigungskonfiguration ist eine Security Command Center-Ressource, die die Konfiguration zum Senden von Benachrichtigungen für Erstellungs-/Aktualisierungsereignisse von Ergebnissen, Assets usw. enthält.

JSON-Darstellung 
{
  "name": string,
  "description": string,
  "eventType": enum (EventType),
  "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.
}
Felder
name

string

Der relative Ressourcenname dieser Benachrichtigungskonfiguration. Weitere Informationen finden Sie unter https://cloud.google.com/apis/design/resource_names#relative_resource_name. Beispiel: „organizations/{organization_id}/notificationConfigs/notify_public_bucket“.
description

string

Die Beschreibung der Benachrichtigungskonfiguration (maximal 1.024 Zeichen).
eventType

enum (EventType)

Der Ereignistyp, für den die Konfiguration gilt, z.B. FINDING.
pubsubTopic

string

Das Pub/Sub-Thema, an das Benachrichtigungen gesendet werden sollen. Das Format lautet „projects/[projectId]/topics/[topic]“.
serviceAccount

string

Nur Ausgabe. Das Dienstkonto, das die Berechtigung „pubsub.topics.publish“ benötigt, um im Pub/Sub-Thema zu veröffentlichen.
Union-Feld notify_config. Die Konfiguration zum Auslösen von Benachrichtigungen. Für notify_config ist nur einer der folgenden Werte zulässig:
streamingConfig

object (StreamingConfig)

Die Konfiguration zum Auslösen von streamingbasierten Benachrichtigungen.

EventType

Der Ereignistyp.

Enums
EVENT_TYPE_UNSPECIFIED Nicht angegebener Ereignistyp.
FINDING Ereignisse für Ergebnisse
ASSET Ereignisse für Assets

StreamingConfig

Die Konfiguration für streamingbasierte Benachrichtigungen, bei denen jedes Ereignis gesendet wird, sobald es erkannt wird.

JSON-Darstellung 
{
  "filter": string
}
Felder
filter

string

Ausdruck, der den Filter definiert, der auf Erstell-/Aktualisierungsereignisse von Assets oder Ergebnissen angewendet werden soll, wie vom Ereignistyp angegeben. Der Ausdruck besteht aus einer Liste mit null oder mehr Einschränkungen, die über die logischen Operatoren AND und OR kombiniert werden. Klammern werden unterstützt und OR hat eine höhere Priorität als AND.

Einschränkungen haben das Format <field> <operator> <value> und können ein --Zeichen vorangestellt haben, um eine Verneinung anzugeben. Die Felder werden den in der entsprechenden Ressource definierten Feldern zugeordnet.

Folgende Operatoren werden unterstützt:

  • = für alle Werttypen.
  • >, <, >=, <= für Ganzzahlwerte.
  • :, d. h. Teilstringabgleich, für Strings.

Folgende Werttypen werden unterstützt:

  • Stringliterale in Anführungszeichen.
  • Ganzzahlliterale ohne Anführungszeichen.
  • Boolesche Literale true und false ohne Anführungszeichen

Methoden

create

 Erstellt eine Benachrichtigungskonfiguration.

delete

 Löscht eine Benachrichtigungskonfiguration.

get

 Ruft eine Benachrichtigungskonfiguration ab.

list

 Listet Benachrichtigungskonfigurationen auf.

patch

 Aktualisiert eine Benachrichtigungskonfiguration.