Diese Seite wurde von der Cloud Translation API übersetzt.

Bus zum Weiterleiten von Nachrichten erstellen

Erweitert

Mit einem Eventarc Advanced-Bus können Sie den Nachrichtenfluss durch Ihr System zentralisieren, überwachen und erfassen. Er dient als Router. Er empfängt Ereignisse von einer Nachrichtenquelle oder von einem Anbieter und bewertet sie gemäß einer Registrierung. Eine Anmeldung weist ein Abo einem bestimmten Bus zu und definiert die Abgleichkriterien für Nachrichten, die dann entsprechend weitergeleitet werden. Weitere Informationen finden Sie unter Registrierung zum Empfangen von Ereignissen erstellen.

Ein Bus kann von Ereignisanbietern und Zielen in Ihrem Projekt oder in anderen Projekten verwendet werden. Weitere Informationen finden Sie unter Projektlayouts.

Erforderliche Rollen

Eine IAM-Rolle (Identity and Access Management) enthält eine Reihe von Berechtigungen, mit denen Sie bestimmte Aktionen für Google Cloud -Ressourcen ausführen können. Die folgenden Rollen und Berechtigungen sind erforderlich, wenn Sie einen Bus zum Weiterleiten von Nachrichten erstellen:

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Eventarc Admin (roles/eventarc.admin) oder Eventarc Message Bus Admin (roles/eventarc.messageBusAdmin) für Ihr Busprojekt zuzuweisen, um die Berechtigung zum Erstellen eines Busses zu erhalten. Diese vordefinierten Rollen enthalten die Berechtigung eventarc.messageBuses.create, die zum Erstellen eines Busses erforderlich ist.
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Eventarc Message Bus User (roles/eventarc.messageBusUser) für Ihr Busprojekt zuzuweisen, um die Berechtigung zum Verwenden eines Busses zu erhalten. Diese vordefinierte Rolle enthält die Berechtigung eventarc.buses.use, die zum Verwenden eines Busses erforderlich ist.
Zum Erstellen einer Pipeline und einer Registrierung sind zusätzliche Berechtigungen erforderlich. Weitere Informationen finden Sie unter Erforderliche Rollen beim Erstellen einer Registrierung.

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten. Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Bus erstellen

So erstellen Sie einen Bus:

In der Google Cloud Console
Über die Google Cloud CLI in Ihrem Terminal oder in Cloud Shell
Durch Senden einer Anfrage an die Eventarc API

Console

Rufen Sie in der Google Cloud Console die Seite Eventarc > Bus auf.

Zu „Bus“
Klicken Sie auf Bus erstellen.
Führen Sie auf der Seite Bus erstellen die folgenden Schritte aus:
1. Geben Sie einen Busnamen ein. Dies ist die ID Ihres Busses.
2. Optional: Geben Sie einen Anzeigenamen des Busses ein, der auf der Seite Busdetails angezeigt wird.
3. Wählen Sie in der Liste Region eine unterstützte Region aus, in der Sie den Bus bereitstellen möchten.
4. Wählen Sie in der Liste Log-Wichtigkeit die Mindestwichtigkeit für Ereignisse aus, die in Protokolleinträgen beschrieben sind. Standardmäßig ist Kein ausgewählt. Weitere Informationen finden Sie unter LogSeverity.
5. Übernehmen Sie unter Verschlüsselung den Standardwert Google-managed encryption key oder wählen Sie Cloud KMS-Schlüssel aus. Weitere Informationen finden Sie unter Vom Kunden verwaltete Verschlüsselungsschlüssel (CMEK) verwenden.
6. Wenn Sie Cloud KMS-Schlüssel auswählen, gehen Sie so vor:
  1. Wählen Sie in der Liste Schlüsseltyp eine Methode zum Verwalten Ihrer Schlüssel aus.
    
    Sie können Ihre Schlüssel manuell verwalten oder Autokey verwenden, mit dem Sie Schlüsselringe und Schlüssel bei Bedarf generieren können. Wenn die Option Cloud KMS mit Autokey deaktiviert ist, wurde sie noch nicht in den aktuellen Ressourcentyp eingebunden.
  2. Wählen Sie unter Cloud KMS-Schlüssel auswählen einen Schlüssel aus.
    
    Sie müssen eine Region auswählen, bevor Sie Ihre vom Kunden verwalteten Schlüssel aufrufen können.
  3. Optional: Sie können den Ressourcennamen des Schlüssels, den Sie verwenden möchten, manuell in die Liste Wählen Sie einen vom Kunden verwalteten Schlüssel aus eingeben. Klicken Sie dazu auf Schlüssel manuell eingeben und geben Sie den Schlüsselnamen im angegebenen Format ein.
  4. Wenn Sie dazu aufgefordert werden, weisen Sie dem Eventarc-Dienst-Agent die Rolle cloudkms.cryptoKeyEncrypterDecrypter zu.
7. Optional: Wenn Sie eine Nachrichtenquelle hinzufügen möchten, klicken Sie auf Quelle hinzufügen.
  1. Übernehmen Sie im Bereich Nachrichtenquelle hinzufügen für den Google API-Nachrichtenanbieter den Standardwert google-api-source oder geben Sie einen anderen Quellnamen ein.
  2. Klicken Sie auf Erstellen.
    
    Dadurch wird die automatische Erfassung von Ereignissen ermöglicht, die direkt aus Google-Quellen stammen.
    
    Es werden nur Ereignisse aus Ressourcen im Google Cloudgleichen Projekt wie der Bus veröffentlicht. Weitere Informationen finden Sie unter Ereignisse aus Google-Quellen veröffentlichen.
8. Optional: Klicken Sie auf Label hinzufügen, um Labels hinzuzufügen. Labels sind Schlüssel/Wert-Paare, mit denen Sie IhreGoogle Cloud Ressourcen organisieren können. Weitere Informationen finden Sie unter Was sind Labels?
Klicken Sie auf Erstellen.

gcloud

Öffnen Sie ein Terminalfenster.
Erstellen Sie mit dem Befehl gcloud beta eventarc message-buses create einen Bus.
```
gcloud beta eventarc message-buses create BUS_NAME \
    --location=REGION
```
Ersetzen Sie Folgendes:
- BUS_NAME: die ID oder voll qualifizierte Kennzeichnung des Busses
- REGION: ein unterstützter Standort für den Bus
  
  Alternativ können Sie die Speicherorteigenschaft der Google Cloud CLI festlegen:
```
gcloud config set eventarc/location REGION
```
Optional: Sie können auch die folgenden Flags verwenden:
- --async, um sofort vom Befehl zurückzukehren, ohne auf den Abschluss des laufenden Vorgangs zu warten.
- --crypto-key, um den voll qualifizierten Namen eines vom Kunden verwalteten Verschlüsselungsschlüssels anzugeben. Wenn nicht angegeben, wird Google-owned and managed keys verwendet.
- --logging-config, um den Mindestschweregrad für Ereignisse zu konfigurieren, die in Protokolleinträgen beschrieben sind. Es muss sich um einen dieser Algorithmen handeln: NONE, DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT oder EMERGENCY. Der Standardwert ist NONE. Weitere Informationen finden Sie unter LogSeverity.

REST API

Verwenden Sie zum Erstellen eines Busses die Methode projects.locations.messageBuses.create.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

BUS_NAME: Der Anzeigename Ihres Busses, z. B. my_bus.
LABEL_KEY und LABEL_VALUE: Optional. Eine Zuordnung von Labelschlüsseln und ‑werten, mit der Sie Ihre Google Cloud Ressourcen organisieren können. Weitere Informationen finden Sie unter Was sind Labels?
ANNOTATION_KEY und ANNOTATION_VALUE: Optional. Eine Zuordnung von Anmerkungsschlüssel/Wert-Paaren im freien Format. Sie können damit beliebige Informationen an die Ressource anhängen. Weitere Informationen finden Sie unter Anmerkungen.
ENCRYPT_KEY: Optional. Ein Cloud KMS-Schlüssel, den der Bus für die Datenverschlüsselung im Format projects/PROJECT_NAME/locations/LOCATION/keyRings/RING_NAME/cryptoKeys/KEY_NAME verwenden soll. Weitere Informationen finden Sie unter vom Kunden verwaltete Verschlüsselungsschlüssel verwenden.
PROJECT_ID: Ihre Google CloudProjekt-ID.
LOCATION: die Region, in der der Bus erstellt werden soll, z. B. us-central1.
LOG_SEVERITY: Optional. Der minimale Schweregrad des Ereignisses, das in einem Logeintrag beschrieben ist. Eine der folgenden Möglichkeiten: NONE, DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY. Der Standardwert ist NONE. Weitere Informationen finden Sie unter LogSeverity.

JSON-Text der Anfrage:

{
  "display_name": "BUS_NAME",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "annotations": {"ANNOTATION_KEY":"ANNOTATION_VALUE"},
  "cryptoKeyName": "ENCRYPT_KEY",
  "loggingConfig": {"logSeverity":"LOG_SEVERITY"}
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

cat > request.json << 'EOF'
{
  "display_name": "BUS_NAME",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "annotations": {"ANNOTATION_KEY":"ANNOTATION_VALUE"},
  "cryptoKeyName": "ENCRYPT_KEY",
  "loggingConfig": {"logSeverity":"LOG_SEVERITY"}
}
EOF

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/messageBuses?messageBusId=BUS_NAME"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

@'
{
  "display_name": "BUS_NAME",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "annotations": {"ANNOTATION_KEY":"ANNOTATION_VALUE"},
  "cryptoKeyName": "ENCRYPT_KEY",
  "loggingConfig": {"logSeverity":"LOG_SEVERITY"}
}
'@  | Out-File -FilePath request.json -Encoding utf8

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/messageBuses?messageBusId=BUS_NAME" | Select-Object -Expand Content

APIs Explorer (Browser)

Kopieren Sie den Anfragetext und öffnen Sie die Referenzseite für Methoden. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Fügen Sie den Anfragetext in dieses Tool ein, füllen Sie alle Pflichtfelder aus und klicken Sie auf Ausführen.

Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Operation.

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.eventarc.v1.OperationMetadata",
    "createTime": "2024-01-25T17:17:45.782370139Z",
    "target": "projects/PROJECT_ID/locations/LOCATION/messageBuses/BUS_NAME",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Bus löschen

Sie haben folgende Möglichkeiten, einen Bus zu löschen:

In der Google Cloud Console
Über die gcloud CLI in Ihrem Terminal oder in Cloud Shell
Durch Senden einer Anfrage an die Eventarc API

Console

Rufen Sie in der Google Cloud Console die Seite Eventarc > Bus auf.

Zu „Bus“
Klicken Sie auf den Namen des Busses, den Sie löschen möchten.

Die Seite Busdetails wird geöffnet.
Klicken Sie auf Löschen.
Wenn Sie aufgefordert werden, den Bus zu löschen, setzen Sie ein Häkchen in das Kästchen Möchten Sie fortfahren?, um zu bestätigen, dass alle Nachrichtenquellen, die für die Verwendung des Busses konfiguriert sind, ihn nicht mehr verwenden können.
Geben Sie Delete ein, um den Löschvorgang zu bestätigen.
Klicken Sie auf Löschen.

gcloud

Öffnen Sie ein Terminalfenster.
Verwenden Sie den Befehl gcloud beta eventarc message-buses delete, um einen Bus zu löschen.
```
gcloud beta eventarc message-buses delete BUS_NAME \
    --location=REGION
```
Ersetzen Sie Folgendes:
- BUS_NAME: die ID oder voll qualifizierte Kennzeichnung des Busses
- REGION: den unterstützten Standort für den Bus

REST API

Verwenden Sie zum Löschen eines Busses die Methode projects.locations.messageBuses.delete.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_ID: Ihre Google CloudProjekt-ID.
LOCATION: die Region, in der der Bus erstellt wird, z. B. us-central1.
BUS_NAME: der Name des Bus, den Sie löschen möchten.

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/messageBuses/BUS_NAME"

PowerShell (Windows)

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/messageBuses/BUS_NAME" | Select-Object -Expand Content

APIs Explorer (Browser)

Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Operation.

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.eventarc.v1.OperationMetadata",
    "createTime": "2024-01-25T17:17:45.782370139Z",
    "target": "projects/PROJECT_ID/locations/LOCATION/messageBuses/BUS_NAME",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Bus zum Weiterleiten von Nachrichten erstellen

Erforderliche Rollen

Bus erstellen

Console

gcloud

REST API

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

APIs Explorer (Browser)

Bus löschen

Console

gcloud

REST API

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

APIs Explorer (Browser)

Nächste Schritte