透過 Amazon EventBridge 從 SaaS 合作夥伴接收事件 - Amazon EventBridge
支援 SaaS 合作夥伴整合接收 SaaS 事件

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

透過 Amazon EventBridge 從 SaaS 合作夥伴接收事件

若要從 SaaS 合作夥伴應用程式和服務接收事件，您必須擁有合作夥伴提供給您的合作夥伴事件來源。合作夥伴事件來源是由合作夥伴建立的資源，然後您可以接受此資源做為事件來源。若要接受合作夥伴事件來源，您可以建立自訂事件匯流排，並將其與合作夥伴事件來源配對。

SaaS 合作夥伴會將事件傳送至合作夥伴事件來源，並將其傳送至合作夥伴事件匯流排。

以下影片涵蓋 SaaS 與 EventBridge 的整合：

主題

支援 SaaS 合作夥伴整合

EventBridge 支援下列 SaaS 合作夥伴整合：

設定 Amazon EventBridge 接收來自 SaaS 整合的事件

設定 EventBridge 接收合作夥伴事件包含兩個主要步驟：

  • 建立合作夥伴事件來源

  • 將該合作夥伴來源與合作夥伴事件匯流排建立關聯

    注意

    由合作夥伴發佈至合作夥伴事件來源，但尚未與事件匯流排相關聯的任何事件都會立即遭到捨棄。這些事件將不會靜態保留在 EventBridge 中。

建立合作夥伴事件來源 （僅限主控台）

  1. 前往 https://console.aws.amazon.com/events/ 開啟 Amazon EventBridge 主控台。

  2. 在導覽窗格中, 選擇合作夥伴事件來源。

  3. 尋找您想要的合作夥伴，然後為該合作夥伴選擇設定。

  4. 若要將您的帳戶 ID 複製到剪貼簿，選擇複製。

  5. 在導覽窗格中， 選擇合作夥伴事件來源。

  6. 前往合作夥伴的網站，並依照指示使用您的账户 ID 建立合作夥伴事件來源。您建立的事件來源將僅供帳戶使用。

將合作夥伴來源與合作夥伴事件匯流排建立關聯 （主控台）

  1. 在 EventBridge 主控台中，選擇導覽窗格中的合作夥伴事件來源。

  2. 選取合作夥伴事件來源旁邊的按鈕，然後選擇與事件匯流排建立關聯。

    該事件來源的狀態會從 Pending 變更為 Active，而且事件匯流排的名稱會更新，以符合合作夥伴事件來源名稱。您現在可以開始從該合作夥伴事件來源建立符合事件的規則。

將合作夥伴來源與合作夥伴事件匯流排建立關聯 (AWS CLI)

  • 使用 create-event-bus建立與合作夥伴事件來源相關聯的合作夥伴事件匯流排。

    name 和 都event-source-name應該設定為合作夥伴事件來源名稱。

    例如：

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

    EventBridge 建立事件匯流排後，您可以呼叫 describe-event-source 來傳回合作夥伴來源的詳細資訊。合作夥伴來源State的 應為 ACTIVE。

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

    在合作夥伴事件匯流排put-permission上呼叫 會傳回錯誤。僅允許與合作夥伴事件匯流排相關聯的事件來源的合作夥伴帳戶將事件傳送到其中。

將合作夥伴來源與合作夥伴事件匯流排建立關聯 (AWS CloudFormation)

  1. 建立使用合作夥伴事件來源佈建AWS::Events::EventBus資源的 AWS CloudFormation 範本。

    Name 和 都EventSourceName應該設定為合作夥伴事件來源名稱。例如：

    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. 使用 cloudformation create-stack或 AWS CloudFormation 主控台從範本建立堆疊。例如：

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

    在範本中包含合作夥伴事件匯流排AWS::Events::EventBusPolicy的資源會導致錯誤。僅允許與合作夥伴事件匯流排相關聯的事件來源的合作夥伴帳戶將事件傳送到其中。