教程：使用輸入變壓器轉換事件 EventBridge

在將事件傳送 EventBridge到規則目標之前，您可以使用「輸入轉換器」來自訂事件的文字。

若要這麼做，您可以從事件定義JSON路徑，並將其輸出指派給不同的變數。然後，您可以在輸入範本中使用這些變數。字元 < 和 > 不可逸出。如需更多資訊，請參閱Amazon EventBridge 輸入轉換

注意

如果您指定變數以符合事件中不存在的JSON路徑，則不會建立該變數，也不會出現在輸出中。

在該教學課程中，您將建立事件與 detail-type: "customerCreated" 相符的規則。輸入轉換器會將type變數對應至事件中的 $.詳細資料型JSON路徑。然後 EventBridge 將變量放入輸入模板「這個事件是<type>。」 結果是以下 Amazon SNS 消息。

"This event was of customerCreated type."

第 1 步：創建一個 Amazon SNS 主題

建立接收事件的主題 EventBridge。

若要建立主題

1. 在 https://console.aws.amazon.com/sns/v3/ home 上打開 Amazon SNS 控制台。

2. 在導覽窗格中，選擇主題。

3. 請選擇建立主題。

4. 針對類型，選擇標準。

5. 輸入 eventbridge-IT-test，作為主題的名稱。

6. 請選擇建立主題。

第 2 步：創建一個 Amazon SNS 訂閱

建立訂閱以取得含有轉換後的資訊的電子郵件。

若要建立訂閱

1. 在 https://console.aws.amazon.com/sns/v3/ home 上打開 Amazon SNS 控制台。

2. 在導覽窗格中，選擇訂閱。

3. 選擇建立訂閱。

4. 在「主題」中ARN，選擇您在步驟 1 中建立的主題。在本教學課程中，選擇 eventbridge-IT-test。

5. 對於通訊協定，選擇電子郵件。

6. 針對 Endpoint (端點)，輸入電子郵件地址。

7. 選擇建立訂閱。

8. 透過從 AWS 通知收到的電子郵件中選擇確認訂閱，以確認訂閱。

步驟 3：建立規則

建立規則以使用輸入轉換器自訂前往目標的執行個體狀態資訊。

建立規則

1. 在打開 Amazon EventBridge 控制台https://console.aws.amazon.com/events/。

2. 在導覽窗格中，選擇規則。

3. 選擇建立規則。

4. 輸入規則的名稱和描述。例如，命名規則 ARTestRule

5. 針對事件匯流排，選擇要與此規則建立關聯的事件匯流排。如果您想要此規則匹配來自您的帳戶的事件，請選取預設值。當您帳戶中的 AWS 服務發出事件時，一律會前往您帳戶的預設事件匯流排。

6. 針對規則類型，選擇具有事件模式的規則。

7. 選擇下一步。

8. 在事件來源中，選擇其他。

9. 針對事件模式，請輸入：

   {
     "detail-type": [
       "customerCreated"
     ]
   }

10. 選擇下一步。

11. 在目標類型欄位中，選擇 AWS 服務。

12. 對於 「選取目標」，請從下拉式清單中選擇SNS主題。

13. 針對主題，選取您在步驟 1 中建立的 Amazon SNS 主題。在本教學課程中，選擇 eventbridge-IT-test。

14. 針對其他設定，請執行下列動作：

    1. 針對設定目標輸入，請從下拉式清單中選擇輸入轉換器。

    2. 選擇設定輸入轉換器。

    3. 針對範例事件，請輸入以下內容：

       {
         "detail-type": "customerCreated"
       }

    4. 針對目標輸入轉換器，請執行下列動作：

       1. 針對輸入路徑，請輸入以下內容：

          {"detail-type":"$.detail-type"}

       2. 針對輸入範本，請輸入以下內容：

          "This event was of <detail-type> type."

    5. 選擇確認。

15. 選擇下一步。

16. 選擇下一步。

17. 檢閱規則的詳細資訊，然後選擇建立規則。

步驟 4：傳送測試事件

現在您已設定SNS主題和規則，我們將傳送測試事件以確保規則正常運作。

若要傳送測試事件 (主控台)

1. 在打開 Amazon EventBridge 控制台https://console.aws.amazon.com/events/。

2. 在導覽窗格中，選擇事件匯流排。

3. 在預設事件匯流排圖標中，選擇動作，傳送事件。

4. 輸入事件來源。例如 TestEvent。

5. 針對詳細資訊類型，請輸入 customerCreated。

6. 針對事件詳細資訊，請輸入 {}。

7. 選擇傳送。

步驟 5：確認成功

如果您收到符合預期輸出之 AWS 通知的電子郵件，表示您已成功完成教學課程。

步驟 6：清除您的資源

除非您想要保留為此教學課程建立的資源，否則您現在便可刪除。刪除不再使用的 AWS 資源，即可避免 AWS 帳戶不必要的費用。

若要刪除主SNS題

1. 開啟主SNS控台的 [主題] 頁面。

2. 選取您建立的主題。

3. 選擇刪除。

4. 輸入 delete me。

5. 選擇刪除。

若要刪除SNS訂閱

1. 開啟主SNS控台的「訂閱」頁面。

2. 選取您建立的訂閱。

3. 選擇刪除。

4. 選擇刪除。

若要刪除 EventBridge 規則

1. 開啟主 EventBridge 控台的 [規則] 頁面。

2. 選取您建立的規則。

3. 選擇刪除。

4. 選擇刪除。