Informationen zu den unterstützten Connectors für Application Integration.

Cloud Pub/Sub-Trigger

Mit dem Cloud Pub/Sub-Trigger können Sie die Integration basierend auf den Ereignissen in Ihrer Pub/Sub-Middleware ausführen.

Mit diesem Trigger können Sie eine Integration ausführen, wenn ein Publisher eine Nachricht an das von Ihnen gewählte Thema schreibt. Das Thema kann sich im selben Google Cloud-Projekt wie die Integration oder in einem anderen Google Cloud-Projekt befinden. Wenn dieser Trigger ausgeführt wird, schreibt er auch die veröffentlichte Nachricht in die Ausgabevariable CloudPubSubMessage. Sie können diese Variable basierend auf Ihren Anforderungen in Ihren nachgelagerten Triggern oder Aufgaben verwenden.

Hinweise

Führen Sie die folgenden Aufgaben in Ihrem Google Cloud-Projekt aus, bevor Sie den Cloud Pub/Sub-Trigger konfigurieren.

• Weisen Sie dem Nutzer, der diesen Trigger erstellt, den Projekt-IAM-Administrator (roles/resourcemanager.projectIamAdmin) zu.
• Aktivieren Sie die Pub/Sub API für das Google Cloud-Projekt, das Ihre Integration enthält.
• Prüfen Sie, ob ein Pub/Sub-Thema vorhanden ist. So erstellen Sie ein neues Pub/Sub-Thema:
  1. Rufen Sie in der Cloud Console die Seite "Pub/Sub-Themen" auf.

     Zur Seite "Pub/Sub-Themen"

  2. Klicken Sie auf Thema erstellen.
  3. Geben Sie im Feld Themen-ID einen eindeutigen Themennamen ein.
  4. Klicken Sie auf Speichern.
  Hinweis: Sie müssen kein Abo erstellen, damit der Trigger funktioniert. Application Integration erstellt automatisch ein Abo für ein Thema. Sie können sich alle Ihre Abos auf der Pub/Sub-Aboseite ansehen.

  Ab dem Release vom 1. Dezember 2023 zu Application Integration werden Ihnen Ihre Abos gemäß den Pub/Sub-Abrechnungspreisen in Rechnung gestellt. Abos für Ihren vorhandenen Cloud Pub/Sub-Trigger funktionieren weiterhin wie zuvor und werden nicht in Rechnung gestellt. Wenn Sie jedoch das Thema eines vorhandenen Cloud Pub/Sub-Triggers aktualisieren, wird die Pub/Sub-Abrechnung auf den aktualisierten Cloud Pub/Sub-Trigger angewendet.

Weitere Informationen zur Zugriffsverwaltung mit IAM-Rollen finden Sie unter Zugriffssteuerung.

Informationen zum Zuweisen von Rollen für Hauptkonten finden Sie unter Zugriff auf Ressourcen erteilen, ändern und entziehen.

Cloud Pub/Sub-Trigger hinzufügen

So fügen Sie einen Cloud Pub/Sub-Trigger zu einer neuen oder vorhandenen Integration hinzu:

1. Rufen Sie in der Google Cloud Console die Seite Application Integration auf.

   Zur Seite „Application Integration“

2. Klicken Sie im Navigationsmenü auf Integrationen.

   Die Seite Integrationsliste mit allen im Google Cloud-Projekt verfügbaren Integrationen wird angezeigt.

3. Wähle eine vorhandene Integration aus oder klicke auf Verknüpfung erstellen, um eine neue zu erstellen.

   Wenn Sie eine neue Integration erstellen:

   1. Geben Sie im Bereich Create Integration (Integration erstellen) einen Namen und eine Beschreibung ein.
   2. Wählen Sie eine Region für die Integration aus.
      Hinweis: Im Drop-down-Menü Regionen werden nur die in Ihrem Google Cloud-Projekt bereitgestellten Regionen aufgeführt. Klicken Sie zum Bereitstellen einer neuen Region auf Region aktivieren. Weitere Informationen finden Sie unter Neue Region aktivieren.
   3. Wählen Sie ein Dienstkonto für die Integration aus. Sie können die Dienstkontodetails einer Integration jederzeit in der Integrationsübersicht in der Integrationssymbolleiste ändern oder aktualisieren.
      Hinweis:Die Option zur Auswahl eines Dienstkontos wird nur angezeigt, wenn Sie die Integration Governance für die ausgewählte Region aktiviert haben.
   4. Klicken Sie auf Erstellen.

   Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.

4. Klicken Sie in der Navigationsleiste des Integrationseditors auf Trigger, um die Liste der verfügbaren Trigger aufzurufen.
5. Klicken Sie auf das Element Cloud Pub/Sub-Trigger und platzieren Sie es im Designer.

Cloud Pub/Sub-Trigger konfigurieren

Klicken Sie im Integrationseditor auf das Cloud Pub/Sub-Triggerelement, um den Triggerkonfigurationsbereich aufzurufen, und führen Sie dann die folgenden Aufgaben aus:

1. Geben Sie im Feld Pub/Sub-Thema das Thema, das der Trigger überwachen soll, in folgendem Format an:

   projects/PROJECT_ID/topics/TOPIC_ID

   Alle verfügbaren Themen in Ihrem Google Cloud-Projekt finden Sie in der Spalte Themenname unter Themen.

   Ersetzen Sie Folgendes:
   • PROJECT_ID: Das Google Cloud-Projekt, in dem das Thema erstellt wird.
   • TOPIC_ID: die ID Ihres Pub/Sub-Themas. Das Thema kann sich im selben Google Cloud-Projekt wie deine Integration oder in einem anderen Google Cloud-Projekt befinden.
2. Wählen Sie das Dienstkonto aus, das Sie für den Trigger verwenden möchten. Wenn Sie ein Dienstkonto auswählen, werden Sie aufgefordert, die erforderlichen Rollen zu gewähren. Weitere Informationen finden Sie unter Erforderliche IAM-Rollen.

   Wenn keine Dienstkonten vorhanden sind, erstellen Sie ein Dienstkonto. Klicken Sie dazu im Drop-down-Menü Dienstkonto auf Neu erstellen.

   Hinweis : Ab der Version vom 1. Dezember 2023 zu Application Integration müssen Sie beim Konfigurieren des Cloud Pub/Sub-Triggers ein Dienstkonto für den Trigger angeben. Ihre vorhandenen Pub/Sub-Trigger, denen kein Dienstkonto zugeordnet ist, funktionieren weiterhin wie zuvor. Wenn Sie jedoch einen der vorhandenen Pub/Sub-Trigger ändern möchten, müssen Sie ein Dienstkonto konfigurieren, um diese Trigger weiterhin zu verwenden.

Für Dienstkonten erforderliche IAM-Rollen

Wenn Sie beim Auswählen eines Dienstkontos auf Erteilen klicken, werden den verschiedenen Dienstkonten automatisch die folgenden Rollen zugewiesen.

Dienstkonto	IAM-Rolle gewährt
Standarddienstkonto von Application Integration: [e-mail]	Pub/Sub-Bearbeiter (roles/pubsub.editor) Dienstkontonutzer (roles/iam.serviceAccountUser) Wenn sich das Google Cloud-Projekt des Pub/Sub-Themas vom Google Cloud-Projekt der Integration unterscheidet, benötigt das Standarddienstkonto die Rolle „Pub/Sub-Bearbeiter“ im Google Cloud-Projekt des Themas.
Dienstkonto, das Sie für diesen Trigger auswählen	Aufrufer von Application Integration (roles/integrations.integrationInvoker)

Trigger-Ausgabe

Für jedes Ereignis generiert der Cloud Pub/Sub-Trigger eine CloudPubSubMessage-Ausgabevariable, die Sie in nachgelagerten Aufgaben verwenden können. Die Variable hat das JSON-Format und die Struktur PubsubMessage.

Hinweise

• Die maximale Größe einer Pub/Sub-Nachricht beträgt 10 MB. Informationen zu allen Einschränkungen von Pub/Sub finden Sie unter Pub/Sub-Kontingente und -Limits.
• Es ist möglich, dass Pub/Sub dieselbe Nachricht mehrmals in ein Thema schreibt. Informationen zum Verhalten von Pub/Sub finden Sie unter Mindestens einmalige Zustellung. Daher müssen Sie Ihre Integration so idempotent gestalten, dass eine Nachricht nicht mehr als einmal in ein Thema geschrieben werden kann.
  Hinweis: Das Feld message_id im Nachrichtenheader identifiziert eine Pub/Sub-Nachricht eindeutig.
• Wenn Sie die Veröffentlichung einer Integration aufheben, wird das Pub/Sub-Abo nicht gelöscht, um einen Verlust von Nachrichten zu verhindern. Wenn Sie jedoch die veröffentlichte Version oder alle Integrationsversionen einer Integration löschen, wird auch das Pub/Sub-Abo gelöscht.

Abo mit Filter für deine Integration erstellen

Wenn Sie einen Filter für das Pub/Sub-Abo festlegen möchten, um bestimmte Ereignisse in Ihrer Integration zu verarbeiten, gehen Sie so vor:

1. Veröffentlichen Sie die Einbindung mit dem konfigurierten Cloud Pub/Sub-Trigger. In diesem Schritt wird das Abo im Integrationsprojekt erstellt.
2. Öffnen Sie in der Google Cloud Console die Seite Abos.

   Zu den Abos

3. Öffnen Sie das Abo und kopieren Sie alle Details, einschließlich des Abonamens.
4. Löschen Sie das vorhandene Abo.
5. Erstellen Sie ein neues Abo mit allen Details des gelöschten Abos, einschließlich des Abonamens, das Sie in Schritt 3 kopiert haben, und fügen Sie dem neuen Abo auch einen Filter hinzu.

   Das neu erstellte Abo löst die Integration mit gefilterten Nachrichten aus.

SLA-Ausschlüsse

Der Cloud Pub/Sub-Trigger hängt vom Pub/Sub-Produkt ab. Da diese Abhängigkeit außerhalb von Application Integration liegt, gelten die Service Level Agreement (SLA) für Application Integration nur, wenn der Cloud Pub/Sub-Trigger die Ausführung einer active-Integration erfolgreich startet.