View a markdown version of this page

Empfangen von Ereignissen von einem SaaS-Partner mit Amazon EventBridge - Amazon EventBridge
Unterstützte SaaS-PartnerintegrationenEmpfangen Sie SaaS-Ereignisse

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Empfangen von Ereignissen von einem SaaS-Partner mit Amazon EventBridge

Wenn Sie Ereignisse aus SaaS-Partneranwendungen und -services empfangen möchten, benötigen Sie eine Partnerereignisquelle vom Partner. Eine Partnerereignisquelle ist eine von einem Partner erstellte Ressource, die Sie dann als Ereignisquelle akzeptieren können. Um die Partnerereignisquelle zu akzeptieren, erstellen Sie einen Custom Event Bus — Classic und ordnen ihn der Partnerereignisquelle zu.

Anmerkung

Um Partnerereignisse auf einem benutzerdefinierten Event-Bus zu empfangen, erstellen Sie eine Eventquelle, die die Partnerereignisquelle als Ursprung benennt. Die Partnerintegration auf dieser Seite bleibt dieselbe. Siehe Ereignisquellen für einen benutzerdefinierten Event-Bus.

Ein SaaS-Partner sendet ein Ereignis an eine Partnerereignisquelle, die es an den Partner-Eventbus sendet.

Das folgende Video behandelt SaaS-Integrationen mit EventBridge:

Themen

Unterstützte SaaS-Partnerintegrationen

EventBridge unterstützt die folgenden SaaS-Partnerintegrationen:

Konfiguration von Amazon EventBridge für den Empfang von Ereignissen aus einer SaaS-Integration

Die Konfiguration EventBridge für den Empfang von Partnerereignissen besteht aus zwei Hauptschritten:

  • Die Partnerereignisquelle erstellen

  • Zuordnen dieser Partnerquelle zu einem Partnerereignisbus

    Anmerkung

    Alle Ereignisse, die von einem Partner in einer Partnerereignisquelle veröffentlicht wurden, die nicht mit einem Event Bus verknüpft wurde, werden sofort gelöscht. Diese Ereignisse werden im Ruhezustand nicht dauerhaft gespeichert. EventBridge

Erstellen Sie eine Partnerereignisquelle (nur Konsole)

  1. Öffnen Sie die EventBridge Amazon-Konsole unter https://console.aws.amazon.com/events/.

  2. Wählen Sie im Navigationsbereich Partner event sources (Partnerereignisquellen) aus.

  3. Suchen Sie den gewünschten Partner und wählen Sie dann für diesen Partner Einrichten aus.

  4. Wenn Sie Ihre Konto-ID in die Zwischenablage kopieren möchten, wählen Sie Kopieren aus.

  5. Wählen Sie im Navigationsbereich Partner event sources (Partnerereignisquellen) aus.

  6. Rufen Sie die Website des Partners auf und befolgen Sie die Anweisungen zum Erstellen einer Partnerereignisquelle mithilfe Ihrer Konto-ID. Die Ereignisquelle, die Sie erstellen, ist nur für Ihr Konto verfügbar.

Ordnen Sie die Partnerquelle einem Partner-Event-Bus (Konsole) zu

  1. Wählen Sie in der EventBridge Konsole im Navigationsbereich Partnerereignisquellen aus.

  2. Wählen Sie die Schaltfläche neben der Partnerereignisquelle aus und klicken Sie dann auf Mit Event Bus verknüpfen.

    Der Status der Ereignisquelle wird von Pending in Active geändert. Der Name des Event Bus wird entsprechend dem Namen der Partnerereignisquelle aktualisiert. Sie können jetzt mit dem Erstellen von Regeln beginnen, die Ereignissen aus dieser Partnerereignisquelle entsprechen.

Ordnen Sie die Partnerquelle einem Partner-Event-Bus zu (AWS CLI)

  • Wird verwendet create-event-bus, um einen Partnerereignisbus zu erstellen, der der Partnerereignisquelle zugeordnet ist.

    Beides name und event-source-name sollte auf den Namen der Partnerereignisquelle gesetzt werden.

    Beispiel:

    aws events create-event-bus \
    --name "aws.partner/saas-integration/name" \
    --event-source-name "aws.partner/saas-integration/name" \
    --region us-east-1

    Nachdem der Event-Bus EventBridge erstellt wurde, können Sie anrufen, describe-event-source um Details zur Partnerquelle zurückzugeben. Die State der Partnerquelle sollte lautenACTIVE.

    aws events describe-event-source
--name "aws.partner/saas-integration/name"
    Anmerkung

    Das put-permission Aufrufen eines Partner-Event-Busses gibt einen Fehler zurück. Nur das Partnerkonto der Eventquelle, die dem Partner-Event-Bus zugeordnet ist, darf Ereignisse an den Partner-Event-Bus senden.

Ordnen Sie die Partnerquelle einem Partner-Event-Bus zu (CloudFormation)

  1. Erstellen Sie eine CloudFormation Vorlage, die eine AWS::Events::EventBus Ressource mit der Partnerereignisquelle bereitstellt.

    Beides Name und EventSourceName sollte auf den Namen der Partnerereignisquelle gesetzt werden. Beispiel:

    AWSTemplateFormatVersion: 2010-09-09

Description: 
   Cloudformation template to create Event Bus for receiving partner events

Resources:
  ExamplePartnerEventBus:
    Type: AWS::Events::EventBus
    Properties:
      EventSourceName: 'aws.partner/saas-integration/name'
      Name: 'aws.partner/saas-integration/name'

  2. Verwenden Sie cloudformation create-stack oder die CloudFormation Konsole, um einen Stack aus der Vorlage zu erstellen. Beispiel:

    aws cloudformation create-stack --stack-name eventbridge-saas --template-body file://template.yml --region us-east-1
    Anmerkung

    Wenn Sie eine AWS::Events::EventBusPolicy Ressource für den Partner-Event-Bus in Ihre Vorlage aufnehmen, wird ein Fehler auftreten. Nur das Partnerkonto der Eventquelle, die mit dem Partner-Event-Bus verknüpft ist, darf Ereignisse an diesen senden.