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

# 使用 EventBridge 沙盒測試事件模式
<a name="eb-event-pattern-sandbox"></a>

定義事件模式通常是[建立新規則](eb-create-rule-visual.md)或編輯現有規則的較大程序的一部分。不過，透過在 EventBridge 中使用沙盒，您可以快速定義事件模式，並使用範例事件來確認模式與所需的事件相符，而無需建立或編輯規則。測試完事件模式之後，EventBridge 會提供您直接從沙盒中使用該事件模式建立新規則的選項。

如需有關事件模式的詳細資訊，請參閱 [建立 Amazon EventBridge 事件模式](eb-event-patterns.md)。

**重要**  
在 EventBridge 中，您可以建立規則，該規則會導致高於預期的費用和限流。例如，您可能會不小心建立導致無限迴圈的規則，其中該規則會以遞迴方式觸發而不會結束。假設，您建立的規則可能會偵測到已在 Amazon S3 儲存貯體上變更 ACL，並觸發軟體來將它們變更為所需的狀態。如果未謹慎寫入規則，後續對 ACL 的變更會再次觸發規則，建立無限循環。  
如需有關撰寫精確規則和事件模式以將此類非預期結果降到最低的指引，請參閱 [規則的最佳實務](eb-rules-best-practices.md) 和 [最佳實務](eb-patterns-best-practices.md)。

**使用 EventBridge 沙盒測試事件模式**

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

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

1. 在**事件來源**欄位中，選擇 **AWS 事件或 EventBridge 合作夥伴事件**。

1. (選用 ) 在**範例事件**區段中，選擇您要測試事件模式的**範例事件類型**。

   可使用以下範例事件類型：
   + **AWS 事件 **– 從支援的事件中選取 AWS 服務。
   + **EventBridge 合作夥伴事件**：從支援 EventBridge 的第三方服務 (例如 Salesforce) 所發出的事件中選取。
   + **輸入我自己的**：以 JSON 文字輸入您自己的事件。

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

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

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

        EventBridge 會顯示範例事件。

     1. 選取**複製**。

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

     1. 在 JSON 編輯窗格中刪除範例事件結構，並將 AWS 或 合作夥伴事件貼到位。

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

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

------
#### [ Existing schema ]

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

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

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

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

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

   1. 在**模型**區段中，選擇任何屬性旁的**編輯**按鈕以開啟其屬性內容。視需要設定**關係**與**值**欄位，然後選擇**設定**以儲存屬性。
**注意**  
如需有關屬性定義的資訊，請選擇屬性名稱旁邊的**資訊**圖示。如需有關如何在事件中設定屬性內容的參考資料，請開啟屬性內容對話方塊的**註記**區段。  
若要刪除屬性的内容，請選擇該屬性的**編輯**按鈕，然後選擇**清除**。

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

   1. (選用) 若要根據您的測試模式測試範例事件，請選擇**測試模式**。

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

      您也可以選擇以下其中一個選項：
      + **複製**：將事件模式複製到設備的剪貼板。
      + **美化**：透過新增換行符號、定位鍵和空格鍵，讓 JSON 文字更易於閱讀。

------
#### [ Custom schema ]

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

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

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

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

   1. 在**模型**區段中，選擇任何屬性旁的**編輯**按鈕以開啟其屬性內容。視需要設定**關係**與**值**欄位，然後選擇**設定**以儲存屬性。
**注意**  
如需有關屬性定義的資訊，請選擇屬性名稱旁邊的**資訊**圖示。如需有關如何在事件中設定屬性內容的參考資料，請開啟屬性內容對話方塊的**註記**區段。  
若要刪除屬性的内容，請選擇該屬性的**編輯**按鈕，然後選擇**清除**。

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

   1. (選用) 若要根據您的測試模式測試範例事件，請選擇**測試模式**。

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

      您也可以選擇以下其中一個選項：
      + **複製**：將事件模式複製到設備的剪貼板。
      + **美化**：透過新增換行符號、定位鍵和空格鍵，讓 JSON 文字更易於閱讀。

------
#### [ Event pattern ]

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

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

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

   1. (選用) 若要根據您的測試模式測試範例事件，請選擇**測試模式**。

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

      您也可以選擇以下其中一個選項：
      + **複製**：將事件模式複製到設備的剪貼板。
      + **美化**：透過新增換行符號、定位鍵和空格鍵，讓 JSON 文字更易於閱讀。
      + **事件模式表單**：打開模式生成器的事件模式。如果模式無法依原樣在模式產生器中呈現，EventBridge 會在開啟模式產生器之前警告您。

------

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

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

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

   如需如何建立規則的詳細資訊，請參閱 [使用增強型建置器建立規則](eb-create-rule-visual.md)。