在 Amazon EventBridge 中建立規則 - Amazon EventBridge

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

在 Amazon EventBridge 中建立規則

先決條件

開始前,請確保您具備以下條件:

  • 存取 Amazon EventBridge 主控台

  • 建立 EventBridge 規則的適當 IAM 許可

  • 對事件驅動型架構的基本了解

概觀

若要對 EventBridge 收到的事件採取動作,您可以建立規則。當事件符合您規則中定義的事件模式時,EventBridge 會將事件傳送至指定的目標。

本主題會逐步引導您建立規則,讓 EventBridge 用來比對傳送至指定事件匯流排的事件。

建立 EventBridge 規則包含四個主要步驟:

  1. 選擇您要處理的事件

  2. 設定事件篩選和測試

  3. 選取並設定目標

  4. 設定規則設定

選擇事件

首先,選擇您要傳送至目標的事件。

若要選取事件
  1. 前往 https://console.aws.amazon.com/events/ 開啟 Amazon EventBridge 主控台。

  2. 在導覽窗格中,選擇規則,然後選擇建立規則

  3. 事件索引標籤中,尋找您要傳送至目標的事件:

    1. 選擇AWS 服務事件自訂事件

    2. 使用搜尋方塊或瀏覽事件清單來尋找您要傳送至目標的事件。

    3. 將一或多個事件拖曳至建置畫布,並將其放入觸發事件

    EventBridge 會顯示觸發事件區段。本節包括:

    • 事件,列出您選擇的事件。

    • 結構描述,如果可用,會顯示所選事件的結構描述。

      結構描述包含三個標籤:

      • 樹狀結構:事件結構描述的樹狀檢視。

      • 程式碼:Open API 規格或 JSON 格式的事件結構描述。

      • 資訊:關於結構描述的概觀資訊。

    • 範例事件,如果可用,會顯示所選事件的範例。

    • 事件模式 (篩選條件),其中包含選取您所選所有事件的事件模式。

篩選事件以僅傳送您想要的內容

您可能不想將特定類型的所有事件傳送至目標。您可以讓事件模式更具體,使其只選取包含您感興趣的屬性和值的事件。

編輯事件模式 (選用)

觸發事件窗格中,您可以用兩種方式建置事件模式:

  • 視覺效果,使用結構描述樹狀檢視

  • 事件模式窗格中直接編輯 JSON

使用結構描述樹狀檢視編輯事件模式
  1. 選擇結構描述窗格的狀標籤。

  2. 新增和編輯篩選條件以建置事件模式。

    1. 選擇您要新增為事件模式篩選條件之屬性旁的篩選條件圖示。

    2. 從下拉式清單中選擇比較運算子。

      如需比較運算子的詳細資訊,請參閱建立事件模式

    3. 輸入您要比對的值。

    4. 按一下核取記號以完成。

    EventBridge 會將您建立的篩選條件新增至事件模式窗格中的 JSON。

  3. 新增其他篩選條件,直到您在您想要的所有事件屬性上建構符合的事件模式為止。

測試事件模式

在您建構符合您所需所有事件屬性的事件模式之後,請測試 以確保事件模式如預期般執行。

測試事件模式 (選用)

  1. 選擇範例事件進行測試,或使用您自己的事件。

    • 使用提供的範例事件

      1. 選擇使用提供的範例事件

      2. 範例觸發事件下,從下拉式清單中選取用於測試的事件。

    • 使用您自己的事件

      1. 選擇使用您自己的事件

        EventBridge 會顯示具有空白details元素的一般事件。

      2. 編輯事件 JSON,以建立您要測試事件模式的事件。

        提示

        您可以使用提供的範例事件做為起點,建立自己的自訂事件以用於測試:

        1. 選擇使用提供的範例事件,從範例觸發事件中選擇事件,然後選擇複製

        2. 選擇使用您自己的事件

        3. 在視窗中選取整個事件,然後將範例事件貼到其中。

        4. 視需要編輯事件。

  2. 選擇執行測試

    EventBridge 會顯示訊息,指出測試事件是否符合事件模式。

選取目標

將一個 (最多五個) 目標拖曳至建置畫布,並將其拖放到目標上,以接收符合指定事件模式的事件。目標可以包括:

  • 其他 EventBridge 事件匯流排,位於相同或不同的 AWS 帳戶

  • EventBridge API 目的地,包括 SaaS 合作夥伴,例如 Salesforce

  • 各種 AWS 服務資源,例如 Amazon SQS 佇列或 Amazon SNS 主題

若要選取目標
  1. 從目標窗格選取目標類型,並將其拖放到建置畫布中的目標形狀。

    EventBridge 會在建置中顯示目標區段,並根據您選取的目標類型,顯示適用的組態選項。

    提示

    如果您已指定多個目標,選取目標形狀會顯示該目標的組態區段。

  2. 根據您的目標類型設定目標。如需詳細組態步驟,請參閱 EventBridge 目標

自訂傳送至目標的事件資料

如果您選取 EventBridge 事件匯流排或 EventBridge API 目的地以外的目標,您可以選擇自訂實際交付至目標的資料。

轉換或取代傳送的事件資料 (選用)

  1. 在建置設計畫布中,選擇目標形狀中的輸入轉換圖示。

    EventBridge 會顯示輸入轉換區段。

  2. 輸入轉換組態下,選擇啟用

  3. 選取轉換方法,以選擇您要如何自訂傳送至目標的文字,以進行相符事件:

    • 相符事件的一部分:EventBridge 只會將原始來源事件的指定部分傳送至目標。

    • 常數 (JSON 文字):EventBridge 只會將指定的 JSON 文字傳送至目標。不會傳送原始來源事件的任何部分。

    • 輸入轉換器 – 設定輸入轉換器以自訂您希望 EventBridge 傳送至目標的文字。如需詳細資訊,請參閱轉換目標輸入

設定規則

最後,設定和建立規則。

設定規則 (主控台)
  1. 選擇設定

  2. 輸入名稱,(選用) 輸入規則描述

    規則不能與相同 AWS 區域 和相同事件匯流排上的另一個規則具有相同的名稱。

  3. 針對事件匯流排,選擇要與此規則建立關聯的事件匯流排。

    如果您想要此規則匹配來自您的帳戶的事件,請選取 AWS 預設事件匯流排。當您帳戶中 AWS 服務 的 傳送事件時,一律會移至您帳戶的預設事件匯流排。

  4. 若要在建立規則後立即啟用規則,請在啟用啟用啟用下啟用

  5. (選用) 為規則輸入一或多個標籤。如需詳細資訊,請參閱在 Amazon EventBridge 中標記資源

  6. 選擇建立

後續步驟

建立規則之後,您可以:

其他資源

如需 EventBridge 規則的詳細資訊,請參閱: