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

# 設定 EventBridge 規則
<a name="setting-up-cloudwatch-event-rules"></a>

若要設定 Amazon EventBridge 規則：建立規則來連結來自 AWS Elemental MediaConvert 的事件，以及回應任務狀態變更的目標服務，例如 Amazon Simple Notification Service (Amazon SNS) 或 AWS Lambda。

如需使用 設定 EventBridge 規則的教學課程 AWS Elemental MediaConvert，請參閱 [教學課程：設定失敗任務的電子郵件通知](#mediaconvert_sns_tutorial)。

如需 MediaConvert 在 EventBridge 事件串流中傳送的事件清單，請參閱 [MediaConvert EventBridge 事件的清單](mediaconvert_event_list.md)。

如需使用 EventBridge 的一般資訊，請參閱 [Amazon EventBridge 使用者指南](https://docs.aws.amazon.com/eventbridge/latest/userguide/)。

如需故障診斷資訊，請參閱《[Amazon EventBridge 使用者指南》中的故障診斷](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-troubleshooting.html) *Amazon EventBridge*。

**Topics**
+ [教學課程：設定失敗任務的電子郵件通知](#mediaconvert_sns_tutorial)
+ [步驟 1：在 Amazon SNS 中建立主題](#mediaconvert_sns_create_topic)
+ [步驟 2：在 EventBridge 規則中指定事件模式](#mediaconvert_sns_rule_event_source)
+ [步驟 3：新增 Amazon SNS 主題並完成規則](#add-target-and-finish-rule)
+ [步驟 4：測試您的規則](#mediaconvert_sns_test_rule)

## 教學課程：設定失敗任務的電子郵件通知
<a name="mediaconvert_sns_tutorial"></a>

在本教學課程中，您會設定 EventBridge 事件規則，在任務狀態變更為 時擷取事件，`ERROR`然後通知您該事件。若要執行此作業，請先在 Amazon SNS 中建立主題，該主題會傳送失敗任務的電子郵件通知給您。接著，您可以透過定義事件來源並參考 Amazon SNS 主題 (「目標」)，在 EventBridge 中建立規則。

## 步驟 1：在 Amazon SNS 中建立主題
<a name="mediaconvert_sns_create_topic"></a>

設定 EventBridge 規則的第一部分是準備規則目標。在此情況下，這表示建立和訂閱 Amazon SNS 主題。

**建立 Amazon SNS 主題**

1. 在 [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home) 開啟 Amazon SNS 主控台。

1. 在導覽窗格中選擇 **Topics** (主題)，然後選擇 **Create topic** (建立主題)。

1. 針對**類型**，選擇**標準**。

1. 針對**名稱**，輸入 **MediaConvertJobErrorAlert**，然後選擇**建立主題**。

1. 選擇您剛建立之主題的主題**名稱**，以檢視**主題詳細資訊**。

1. 在 **MediaConvertJobErrorAlert** **主題詳細資訊**頁面的**訂閱**區段中，選擇**建立訂閱**。

1. 對於**通訊協定**，選擇**電子郵件**。針對**端點**，輸入您希望 Amazon SNS 傳送通知的電子郵件地址。

1. 選擇**建立訂閱**。

1. 您會收到來自 Amazon SNS 的通知電子郵件。當您收到這封電子郵件時，請選擇電子郵件中的 **Confirm subscription** (確認訂閱) 連結。

## 步驟 2：在 EventBridge 規則中指定事件模式
<a name="mediaconvert_sns_rule_event_source"></a>

此步驟說明如何在 EventBridge 規則中指定事件模式。此規則將擷取 MediaConvert 在任務狀態變更為 時傳送的事件`ERROR`。

**在 EventBridge 規則中設定事件模式**

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

1. 在導覽窗格中，選擇**規則**。保留**預設****事件匯流排**，然後選擇**建立規則**。

1. 針對**名稱**，輸入 **MediaConvertJobStateError**，然後選擇**下一步**。

1. 在**事件模式**區段中，從**事件來源**開始，選擇下列設定：
   + **事件來源**： **AWS services**
   + **AWS 服務**： **MediaConvert**
   + **事件類型**： **MediaConvert Job State Change**
   + **事件類型 （特定狀態）**： **ERROR**

1. **事件模式**方塊看起來會如下範例所示。

   ```
   {
     "source": ["aws.mediaconvert"],
     "detail-type": ["MediaConvert Job State Change"],
     "detail": {
       "status": ["ERROR"]
     }
   }
   ```

   此程式碼定義 EventBridge 事件規則，符合任務狀態變更為 的任何事件`ERROR`。如需事件模式的詳細資訊，請參閱《*Amazon CloudWatch 使用者指南*》中的[事件和事件模式](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/CloudWatchEventsandEventPatterns.html)。

1. 選擇**下一步**。

## 步驟 3：新增 Amazon SNS 主題並完成規則
<a name="add-target-and-finish-rule"></a>

將您在步驟 1 中建立的 Amazon SNS 主題新增至您在步驟 2 中啟動的 EventBridge 規則。

**新增 Amazon SNS 主題並完成 EventBridge 規則**

1. 在**選取目標 (Select a target) **區段的**選取目標**下，選擇 **SNS 主題**。

1. 針對**主題**，選擇 **MediaConvertJobErrorAlert**。

1. 選擇**下一步**。

1. 選擇性地新增標籤。然後選擇**下一步**。

1. 檢閱您的設定。然後，選擇 **Create role** (建立角色)。

## 步驟 4：測試您的規則
<a name="mediaconvert_sns_test_rule"></a>

為了測試您的規則，請提交一個您知道會造成錯誤的任務。例如，指定一個不存在的輸入位置。如果您正確設定事件規則，您應該會在幾分鐘內收到一封電子郵件，其中包含事件文字訊息。

**測試規則**

1. 在 https：//[https://console.aws.amazon.com/mediaconvert](https://console.aws.amazon.com/mediaconvert) 開啟 AWS Elemental MediaConvert 主控台。

1. 提交新的 MediaConvert 任務。如需詳細資訊，請參閱[教學課程：設定任務設定](setting-up-a-job.md)。

1. 檢查您在設定 Amazon SNS 主題時指定的電子郵件帳戶。確認您已收到有關任務錯誤的電子郵件通知。