使用 EventBridge 沙箱測試事件模式

規則使用事件模式以選取事件並將事件路由到目標。事件模式擁有與其相符事件相同的結構。事件模式與一個事件相符或不相符。

定義事件模式通常是建立新規則或編輯現有規則的較大程序的一部分。但是 EventBridge，您可以使用中的 Sandbox 快速定義事件模式，並使用範例事件來確認模式符合所需的事件，而無需建立或編輯規則。測試完事件模式後，您可 EventBridge 以選擇直接從沙箱中使用該事件模式建立新規則。

如需有關事件模式的詳細資訊，請參閱 Amazon EventBridge 事件模式。

重要

在中 EventBridge，可以建立可能導致電 higher-than-expected 荷和節流的規則。例如，您可能會不小心建立導致無限迴圈的規則，其中該規則會以遞迴方式觸發而不會結束。假設，您建立的規則可能會偵測到已在 Amazon S3 儲存貯體上變更 ACL，並觸發軟體來將它們變更為所需的狀態。如果未謹慎寫入規則，後續對 ACL 的變更會再次觸發規則，建立無限循環。

如需有關撰寫精確規則和事件模式以將此類非預期結果降到最低的指引，請參閱 定義 Amazon EventBridge 規則的最佳實務 和 定義 Amazon EventBridge 事件模式的最佳實務。

使用 EventBridge 沙箱測試事件模式

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

2. 在導覽窗格中，選擇開發人員資源，然後選取沙盒，然後在沙盒頁面上選擇事件模式標籤。

3. 對於事件來源，請選擇AWS 事件或 EventBridge合作夥伴事件。

4. 在範例事件區段中，選擇您要測試事件模式的範例事件類型。

   可使用以下範例事件類型：

   • AWS 事件 — 從支援 AWS 服務的事件中選取。

   • EventBridge 合作夥伴事件 — 從支援 EventBridge的協力廠商服務 (例如 Salesforce) 發出的事件中選取。

   • 輸入我自己的：以 JSON 文字輸入您自己的事件。

     您也可以使用 AWS 或合作夥伴事件作為建立自訂事件的起點。

     1. 選取AWS 事件或EventBridge 合作夥伴活動。

     2. 使用範例事件下拉式清單，選取要用作自訂事件起點的事件。

        EventBridge 顯示範例事件。

     3. 選取複製。

     4. 針對事件類型選取輸入我自己的。

     5. 刪除 JSON 編輯窗格中的範例事件結構，並將 AWS 或夥伴事件貼到其位置。

     6. 編輯事件 JSON 以建立您自己的範例事件。

5. 選擇建立方法。您可以從 EventBridge 結構描述或範本建立事件模式，也可以建立自訂事件模式。

   Existing schema

   若要使用現有的 EventBridge 結構描述來建立事件模式，請執行下列動作：

   1. 在建立方法區段中，針對方法，選取使用結構描述。

   2. 在事件模式區段中，針對結構描述類型，選取從結構描述登錄檔選取結構描述。

   3. 針對結構描述登錄檔，選擇下拉式方塊，然後輸入結構描述登錄檔的名稱，例如 aws.events。您也可以從出現的下拉式清單中選取選項。

   4. 針對結構描述，選擇下拉式方塊，然後輸入要使用的結構描述名稱。例如 aws.s3@ObjectDeleted。您也可以從出現的下拉式清單中選取選項。

   5. 在模型區段中，選擇任何屬性旁的編輯按鈕以開啟其屬性內容。視需要設定關係與值欄位，然後選擇設定以儲存屬性。

      注意

      如需有關屬性定義的資訊，請選擇屬性名稱旁邊的資訊圖示。如需有關如何在事件中設定屬性內容的參考資料，請開啟屬性內容對話方塊的註記區段。

      若要刪除屬性的内容，請選擇該屬性的編輯按鈕，然後選擇清除。

   6. 選擇在 JSON 中產生事件模式，以 JSON 文字產生並驗證您的事件模式。

   7. 若要根據您的測試模式測試範例事件，請選擇測試模式。

      EventBridge 顯示一個訊息方塊，說明您的範例事件是否符合事件模式。

      您也可以選擇以下其中一個選項：

      • 複製：將事件模式複製到設備的剪貼板。

      • 美化：透過新增換行符號、定位鍵和空格鍵，讓 JSON 文字更易於閱讀。

   Custom schema

   若要撰寫自訂結構描述並將其轉換為事件模式，請執行下列動作：

   1. 在建立方法區段中，針對方法，選擇使用結構描述。

   2. 在事件模式區段中，針對結構描述類型，選擇輸入結構描述。

   3. 將結構描述輸入文字方塊。您必須將結構描述格式化為有效的 JSON 文字。

   4. 在模型區段中，選擇任何屬性旁的編輯按鈕以開啟其屬性內容。視需要設定關係與值欄位，然後選擇設定以儲存屬性。

      注意

      如需有關屬性定義的資訊，請選擇屬性名稱旁邊的資訊圖示。如需有關如何在事件中設定屬性內容的參考資料，請開啟屬性內容對話方塊的註記區段。

      若要刪除屬性的内容，請選擇該屬性的編輯按鈕，然後選擇清除。

   5. 選擇在 JSON 中產生事件模式，以 JSON 文字產生並驗證您的事件模式。

   6. 若要根據您的測試模式測試範例事件，請選擇測試模式。

      EventBridge 顯示一個訊息方塊，說明您的範例事件是否符合事件模式。

      您也可以選擇以下其中一個選項：

      • 複製：將事件模式複製到設備的剪貼板。

      • 美化：透過新增換行符號、定位鍵和空格鍵，讓 JSON 文字更易於閱讀。

   Event pattern

   若要以 JSON 格式撰寫自訂事件模式，請執行下列動作：

   1. 在建立方法區段中，針對方法，選擇自訂模式 (JSON 編輯器)。

   2. 針對事件模式，請在 JSON 格式文字中輸入您的自訂事件模式。

   3. 若要根據您的測試模式測試範例事件，請選擇測試模式。

      EventBridge 顯示一個訊息方塊，說明您的範例事件是否符合事件模式。

      您也可以選擇以下其中一個選項：

      • 複製：將事件模式複製到設備的剪貼板。

      • 美化：透過新增換行符號、定位鍵和空格鍵，讓 JSON 文字更易於閱讀。

      • 事件模式表單：打開模式生成器的事件模式。如果圖樣無法依原樣在「模式產生器」中呈現，則會在開啟「圖樣產生器」之前發 EventBridge 出警告。

6. (選用) 若要使用此事件模式建立規則，並將規則指派給特定事件匯流排，請選擇使用模式建立規則。

   EventBridge 帶您進入建立規則的步驟 1，您可以使用此步驟建立規則，並將其指派給您選擇的事件匯流排。

   請注意，步驟 2 - 構建事件模式包含您已經指定的事件模式信息，以及您可以接受或更新的事件模式信息。

   如需如何建立規則的詳細資訊，請參閱 建立回應事件的 Amazon EventBridge 規則。。