本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
在 Amazon EventBridge 中建立規則
先決條件
開始前,請確保您具備以下條件:
-
存取 Amazon EventBridge 主控台
-
建立 EventBridge 規則的適當 IAM 許可
-
對事件驅動型架構的基本了解
概觀
若要對 EventBridge 收到的事件採取動作,您可以建立規則。當事件符合您規則中定義的事件模式時,EventBridge 會將事件傳送至指定的目標。
本主題會逐步引導您建立規則,讓 EventBridge 用來比對傳送至指定事件匯流排的事件。
建立 EventBridge 規則包含四個主要步驟:
-
選擇您要處理的事件
-
設定事件篩選和測試
-
選取並設定目標
-
設定規則設定
選擇事件
首先,選擇您要傳送至目標的事件。
若要選取事件
-
前往 https://console.aws.amazon.com/events/
開啟 Amazon EventBridge 主控台。 -
在導覽窗格中,選擇規則,然後選擇建立規則。
-
在事件索引標籤中,尋找您要傳送至目標的事件:
-
選擇AWS 服務事件或自訂事件。
-
使用搜尋方塊或瀏覽事件清單來尋找您要傳送至目標的事件。
-
將一或多個事件拖曳至建置畫布,並將其放入觸發事件。
EventBridge 會顯示觸發事件區段。本節包括:
-
事件,列出您選擇的事件。
-
結構描述,如果可用,會顯示所選事件的結構描述。
結構描述包含三個標籤:
樹狀結構:事件結構描述的樹狀檢視。
程式碼:Open API 規格或 JSON 格式的事件結構描述。
資訊:關於結構描述的概觀資訊。
-
範例事件,如果可用,會顯示所選事件的範例。
-
事件模式 (篩選條件),其中包含選取您所選所有事件的事件模式。
-
篩選事件以僅傳送您想要的內容
您可能不想將特定類型的所有事件傳送至目標。您可以讓事件模式更具體,使其只選取包含您感興趣的屬性和值的事件。
編輯事件模式 (選用)
在觸發事件窗格中,您可以用兩種方式建置事件模式:
視覺效果,使用結構描述樹狀檢視
在事件模式窗格中直接編輯 JSON
使用結構描述樹狀檢視編輯事件模式
-
選擇結構描述窗格的樹狀標籤。
-
新增和編輯篩選條件以建置事件模式。
選擇您要新增為事件模式篩選條件之屬性旁的篩選條件圖示。
-
從下拉式清單中選擇比較運算子。
如需比較運算子的詳細資訊,請參閱建立事件模式。
輸入您要比對的值。
按一下核取記號以完成。
EventBridge 會將您建立的篩選條件新增至事件模式窗格中的 JSON。
-
新增其他篩選條件,直到您在您想要的所有事件屬性上建構符合的事件模式為止。
測試事件模式
在您建構符合您所需所有事件屬性的事件模式之後,請測試 以確保事件模式如預期般執行。
測試事件模式 (選用)
-
選擇範例事件進行測試,或使用您自己的事件。
-
使用提供的範例事件
選擇使用提供的範例事件。
-
在範例觸發事件下,從下拉式清單中選取用於測試的事件。
-
使用您自己的事件
-
選擇使用您自己的事件。
EventBridge 會顯示具有空白
details元素的一般事件。 -
編輯事件 JSON,以建立您要測試事件模式的事件。
提示
您可以使用提供的範例事件做為起點,建立自己的自訂事件以用於測試:
-
選擇使用提供的範例事件,從範例觸發事件中選擇事件,然後選擇複製。
-
選擇使用您自己的事件。
-
在視窗中選取整個事件,然後將範例事件貼到其中。
視需要編輯事件。
-
-
-
-
選擇執行測試。
EventBridge 會顯示訊息,指出測試事件是否符合事件模式。
選取目標
將一個 (最多五個) 目標拖曳至建置畫布,並將其拖放到目標上,以接收符合指定事件模式的事件。目標可以包括:
其他 EventBridge 事件匯流排,位於相同或不同的 AWS 帳戶
EventBridge API 目的地,包括 SaaS 合作夥伴,例如 Salesforce
各種 AWS 服務資源,例如 Amazon SQS 佇列或 Amazon SNS 主題
若要選取目標
-
從目標窗格選取目標類型,並將其拖放到建置畫布中的目標形狀。
EventBridge 會在建置中顯示目標區段,並根據您選取的目標類型,顯示適用的組態選項。
提示
如果您已指定多個目標,選取目標形狀會顯示該目標的組態區段。
-
根據您的目標類型設定目標。如需詳細組態步驟,請參閱 EventBridge 目標。
自訂傳送至目標的事件資料
如果您選取 EventBridge 事件匯流排或 EventBridge API 目的地以外的目標,您可以選擇自訂實際交付至目標的資料。
轉換或取代傳送的事件資料 (選用)
-
在建置設計畫布中,選擇目標形狀中的輸入轉換圖示。
EventBridge 會顯示輸入轉換區段。
-
在輸入轉換組態下,選擇啟用。
-
選取轉換方法,以選擇您要如何自訂傳送至目標的文字,以進行相符事件:
相符事件的一部分:EventBridge 只會將原始來源事件的指定部分傳送至目標。
常數 (JSON 文字):EventBridge 只會將指定的 JSON 文字傳送至目標。不會傳送原始來源事件的任何部分。
輸入轉換器 – 設定輸入轉換器以自訂您希望 EventBridge 傳送至目標的文字。如需詳細資訊,請參閱轉換目標輸入。
設定規則
最後,設定和建立規則。
設定規則 (主控台)
-
選擇設定。
-
輸入名稱,(選用) 輸入規則描述。
規則不能與相同 AWS 區域 和相同事件匯流排上的另一個規則具有相同的名稱。
-
針對事件匯流排,選擇要與此規則建立關聯的事件匯流排。
如果您想要此規則匹配來自您的帳戶的事件,請選取 AWS 預設事件匯流排。當您帳戶中 AWS 服務 的 傳送事件時,一律會移至您帳戶的預設事件匯流排。
-
若要在建立規則後立即啟用規則,請在啟用啟用啟用下啟用。
-
(選用) 為規則輸入一或多個標籤。如需詳細資訊,請參閱在 Amazon EventBridge 中標記資源。
選擇建立。
後續步驟
建立規則之後,您可以:
其他資源
如需 EventBridge 規則的詳細資訊,請參閱: