Statusänderungen mit Pub/Sub überwachen

Auf dieser Seite erfahren Sie, wie Sie mit Pub/Sub Benachrichtigungen für Statusänderungen für Cloud KMS-Ressourcen.

Hinweise

Erteilen Sie die erforderlichen Berechtigungen und erstellen Sie ein Pub/Sub, um APIs zu aktivieren folgen Sie der Anleitung unter Bevor Sie beginnen in „Assetänderungen überwachen“

Feed konfigurieren

Konfigurieren Sie einen Feed, der die Art der Änderungen und Ressourcen überwacht, die Sie verwenden an denen Sie interessiert sind.

Bei allen Ressourcenänderungen benachrichtigen

Verwenden Sie zum Erstellen eines Feeds den Befehl gcloud asset feeds create.

gcloud asset feeds create FEED_NAME \
  --project=PROJECT_ID  \
  --asset-types="RESOURCE_TYPE" \
  --pubsub-topic="PUBSUB_TOPIC"

Ersetzen Sie Folgendes:

  • FEED_NAME: Der für Pub/Sub zu verwendende Name Feed.
  • PROJECT_ID: Die ID des Cloud KMS-Projekts, das Sie die Sie überwachen möchten.

  • RESOURCE_TYPE: Die Ressourcentypen, für die Sie um Benachrichtigungen zu erhalten. Verwenden Sie Kommas zwischen Ressourcentypen – für Beispiel: cloudkms.googleapis.com/CryptoKey,cloudkms.googleapis.com/CryptoKeyVersion Sie können Benachrichtigungen unterstützte Ressource Typ, einschließlich der folgenden:

    • cloudkms.googleapis.com/CryptoKey
    • cloudkms.googleapis.com/CryptoKeyVersion
    • cloudkms.googleapis.com/EkmConnection
    • cloudkms.googleapis.com/ImportJob
    • cloudkms.googleapis.com/KeyRing

  • PUBSUB_TOPIC: Der Name des Pub/Sub-Themas. die Sie unter Vorbereitung erstellt haben

Dadurch wird eine Benachrichtigung erstellt, wenn Ressourcen des angegebenen Typs erstellt oder aktualisiert. In der Benachrichtigung wird angezeigt, dass die Ressource aktualisiert wurde. keine detaillierten Informationen über die Aktualisierung enthalten. Beispiel: Ein Update kann eine Benachrichtigung für CryptoKeyVersion bedeuten, dass die Version als primäre Version festgelegt wurde oder dass die Version zum Löschen vorgemerkt wurde. Wenn Sie eine Benachrichtigung erhalten ob eine Ressource aktualisiert wurde, sollten Sie sie überprüfen, um ihre Aktueller Status.

Bei bestimmten Ressourcenänderungen benachrichtigen

Wenn Sie einen Feed mit einer Bedingung erstellen möchten, verwenden Sie den gcloud asset feeds create mit dem Flag --condition-expression.

gcloud asset feeds create FEED_NAME \
  --project=PROJECT_ID  \
  --asset-types="RESOURCE_TYPE" \
  --pubsub-topic="PUBSUB_TOPIC" \
  --condition-expression="CONDITION_EXPRESSION"

Ersetzen Sie Folgendes:

  • FEED_NAME: Der für Pub/Sub zu verwendende Name Feed.
  • PROJECT_ID: ID Ihres Cloud KMS-Projekts.

  • RESOURCE_TYPE: Der Ressourcentyp, für den Sie den Vorgang ausführen möchten. Benachrichtigungen erhalten, z. B. cloudkms.googleapis.com/CryptoKeyVersion. Sie können Benachrichtigungen unterstützte Ressource Typ, einschließlich der folgenden:

    • cloudkms.googleapis.com/CryptoKey
    • cloudkms.googleapis.com/CryptoKeyVersion
    • cloudkms.googleapis.com/EkmConnection
    • cloudkms.googleapis.com/ImportJob
    • cloudkms.googleapis.com/KeyRing

  • PUBSUB_TOPIC: Der Name des Pub/Sub-Themas. die Sie unter Vorbereitung erstellt haben

  • CONDITION_EXPRESSION: ein Bedingungsausdruck in Common Expression Language (CEL): Beispiel: "folders/FOLDER_NUMBER" in temporal_asset.asset.ancestors Der Feed erstellt nur dann Benachrichtigungen, wenn die angegebene Ressource befindet sich im Ordner FOLDER_NUMBER.

Dadurch wird eine Benachrichtigung erstellt, wenn Ressourcen des angegebenen Typs angegebenen Bedingungsausdruck erstellt, gelöscht oder aktualisiert werden.