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

# 使用增強型建置器建立規則
<a name="eb-create-rule-visual"></a>

## 先決條件
<a name="eb-create-rule-prerequisites"></a>

開始前，請確保您具備以下條件：
+ 存取 Amazon EventBridge 主控台
+ 建立 EventBridge 規則的適當 IAM 許可
+ 對事件驅動型架構的基本了解

## 概觀
<a name="eb-create-rule-overview"></a>

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

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

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

1. 選擇您要處理的事件

1. 設定事件篩選和測試

1. 選取並設定目標

1. 設定規則設定

## 選擇事件
<a name="eb-create-rule-source"></a>

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

**若要選取事件**

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

1. 在導覽窗格中，選擇 **Rules** (規則)，然後選擇 **Create rule** (建立規則)。

1. 在規則建置器選擇頁面上，選擇**增強型建置器**。

   增強型建置器透過拖放事件和目標，為建置規則和目標提供視覺化畫布。若要改用 JSON 模式和組態，請參閱[建立規則 （進階建置器）](eb-create-rule-wizard.md)。

1. 在**事件**索引標籤中，尋找您要傳送至目標的事件：

   1. 選擇**AWS 服務事件**或**自訂事件**。

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

   1. 將一或多個事件拖曳至**建置**畫布，並將其放入**觸發事件**。

   EventBridge 會顯示**觸發事件**區段。本節包括：
   + **事件**，列出您選擇的事件。
   + **結構描述**，如果可用，會顯示所選事件的結構描述。

     **結構描述**包含三個標籤：
     + **樹狀**結構：事件結構描述的樹狀檢視。
     + **程式碼**：Open API 規格或 JSON 格式的事件結構描述。
     + **資訊**：關於結構描述的概觀資訊。
   + **範例事件**，如果可用，會顯示所選事件的範例。
   + **事件模式 （篩選條件）**，其中包含選取您所選所有事件的事件模式。

## 篩選事件以僅傳送您想要的內容
<a name="eb-create-rule-event-pattern-visual"></a>

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

### 編輯事件模式 （選用）
<a name="eb-create-rule-event-pattern-steps"></a>

在**觸發事件**窗格中，您可以用兩種方式建置事件模式：
+ 視覺效果，使用**結構描述**樹狀檢視
+ 在**事件模式**窗格中直接編輯 JSON

**使用結構描述樹狀檢視編輯事件模式**

1. 選擇**結構描述**窗格的**樹**狀標籤。

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

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

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

      如需比較運算子的詳細資訊，請參閱[建立事件模式](eb-create-pattern-operators.md)。

   1. 輸入您要比對的值。

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

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

1. 新增其他篩選條件，直到您已建構符合所需所有事件屬性的事件模式為止。

### 測試事件模式
<a name="eb-create-rule-event-pattern-test"></a>

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

#### 測試事件模式 （選用）
<a name="eb-create-rule-event-pattern-test-steps"></a>

1. 選擇範例事件進行測試，或使用您自己的事件。
   + **使用提供的範例事件**

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

     1. 在**範例觸發事件**下，從下拉式清單中選取用於測試的事件。
   + **使用您自己的事件**

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

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

     1. 編輯事件 JSON，以建立您要測試事件模式的事件。
**提示**  
您可以使用提供的範例事件做為起點，以建立要在您的測試中使用的自訂事件：  
選擇**使用提供的範例事件**，從**範例觸發事件**中選擇事件，然後選擇**複製**。
選擇**使用您自己的事件**。
在視窗中選取整個事件，然後將範例事件貼至其中。
視需要編輯事件。

1. 選擇**執行測試**。

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

## 選取目標
<a name="eb-create-rule-target-visual"></a>

將一個 （最多五個） 目標拖曳到**建置**畫布，並將其拖放到**目標**上，以接收符合指定事件模式的事件。目標可以包括：
+ 其他 EventBridge 事件匯流排，位於相同或不同的 AWS 帳戶
+ EventBridge API 目的地，包括 SaaS 合作夥伴，例如 Salesforce
+ 各種 AWS 服務資源，例如 Amazon SQS 佇列或 Amazon SNS 主題

**若要選取目標**

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

   EventBridge 會在建置中顯示**目標**區段，並根據您選取的目標類型，顯示適用的組態選項。
**提示**  
如果您已指定多個目標，選取目標形狀會顯示該目標的組態區段。

1. 根據您的目標類型設定目標。如需詳細的組態步驟，請參閱 [EventBridge 目標](eb-targets.md)。

### 自訂傳送至目標的事件資料
<a name="eb-create-rule-target-transform"></a>

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

#### 轉換或取代傳送的事件資料 （選用）
<a name="eb-create-rule-target-transform-steps"></a>

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

   EventBridge 會顯示**輸入轉換**區段。

1. 在**輸入轉換組態**下，選擇**啟用**。

1. 選取轉換方法，以選擇您要如何自訂傳送至目標以比對事件的文字：
   + **相符事件的一部分**：EventBridge 只會將原始來源事件的指定部分傳送至目標。
   + **常數 (JSON 文字)**：EventBridge 只會將指定的 JSON 文字傳送至目標。不會傳送原始來源事件的任何部分。
   + **輸入轉換器** – 設定輸入轉換器來自訂您希望 EventBridge 傳送至目標的文字。如需詳細資訊，請參閱[轉換目標輸入](eb-transform-target-input.md)。

## 設定規則
<a name="eb-create-rule-configure"></a>

最後，設定和建立規則。

**設定規則 （主控台）**

1. 選擇**設定**。

1. 輸入**名稱**，(選用) 輸入規則**描述**。

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

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

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

1. 若要在建立規則後立即啟用規則，請在**啟用啟用啟用**下啟用**。**

1. (選用) 為規則輸入一或多個標籤。如需詳細資訊，請參閱[在 Amazon EventBridge 中標記資源](eb-tagging.md)。

1. 選擇**建立**。

## 後續步驟
<a name="eb-create-rule-next-steps"></a>

建立規則之後，您可以：
+ [使用指標監控規則效能](eb-monitoring.md)
+ [使用範例事件測試您的規則](eb-event-pattern-sandbox.md)
+ [視需要修改事件模式](eb-event-patterns.md)
+ [將其他目標新增至現有規則](eb-targets.md)

## 其他資源
<a name="eb-create-rule-additional-resources"></a>

如需 EventBridge 規則的詳細資訊，請參閱：
+ [EventBridge 規則概觀](eb-rules.md)
+ [建立事件模式](eb-event-patterns.md)
+ [EventBridge 目標](eb-targets.md)
+ [故障診斷 EventBridge 規則](eb-troubleshooting.md)