本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 设置 EventBridge 规则
<a name="setting-up-cloudwatch-event-rules"></a>

要设置亚马逊 EventBridge 规则，请执行以下操作：创建一条规则，将来自的事件 AWS Elemental MediaConvert 与响应任务状态变化的目标服务相关联，例如亚马逊简单通知服务 (Amazon SNS) Simple N Amazon Lambda otification Service 或。

有关使用设置 EventBridge 规则的教程 AWS Elemental MediaConvert，请参阅[教程：为失败的任务设置电子邮件通知](#mediaconvert_sns_tutorial)。

有关在 EventBridge 事件流中 MediaConvert 发送的事件的列表，请参阅[MediaConvert EventBridge 活动清单](mediaconvert_event_list.md)。

有关使用的更多一般信息 EventBridge，请参阅 [Amazon EventBridge 用户指南](https://docs.amazonaws.cn/eventbridge/latest/userguide/)。

有关疑难解答信息，请参阅[亚马逊* EventBridge 用户指南 EventBridge中的亚马逊*疑难解答](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-troubleshooting.html)。

**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 中创建一个主题，以便向您发送有关失败任务的电子邮件通知。接下来，您可以 EventBridge 通过定义事件源并引用 Amazon SNS 主题（“目标”）来创建规则。

## 第 1 步：在 Amazon SNS 创建一个主题
<a name="mediaconvert_sns_create_topic"></a>

设置 EventBridge 规则的第一部分是准备规则目标。在这种情况下，这意味着创建和订阅 Amazon SNS 主题。

**创建 Amazon SNS 主题**

1. [在 v3/home 上打开亚马逊 SNS 控制台。https://console.aws.amazon.com/sns/](https://console.amazonaws.cn/sns/v3/home)

1. 在导航窗格中，选择**主题**，然后选择**创建主题**。

1. 对于**类型**，选择**标准**。

1. 对于**名称**，输入 **MediaConvertJobErrorAlert**，然后选择**创建主题**。

1. 为刚刚创建的主题选择主题**名称** 以查看**主题详细信息**。

1. 在**MediaConvertJobErrorAlert****主题详细信息**页面的**订阅**部分，选择**创建订阅**。

1. 对于**协议**，选择**电子邮件**。对于**端点**，请输入您希望 Amazon SNS 发送通知的目标电子邮件地址。

1. 选择**创建订阅**。

1. 您将收到来自 Amazon SNS 的通知电子邮件。在收到电子邮件时，请选择电子邮件中的**确认订阅**链接。

## 步骤 2：在 EventBridge 规则中指定事件模式
<a name="mediaconvert_sns_rule_event_source"></a>

此步骤说明如何在 EventBridge 规则中指定您的事件模式。此规则将捕获任务状态更改为 MediaConvert 时发送的事件`ERROR`。

**在 EventBridge 规则中设置事件模式**

1. 打开 Amazon EventBridge 控制台，网址为[https://console.aws.amazon.com/events/](https://console.amazonaws.cn/events/)。

1. 在导航窗格中，选择**规则**。保留**默认**的**事件总线**，然后选择**创建规则**。

1. 在**名称**中，输入 **MediaConvertJobStateError**，然后选择**下一步**。

1. 在**事件模式**部分，从**事件源**开始选择以下设置：
   + **事件源**： **Amazon services**
   + **Amazon 服务**:**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.amazonaws.cn/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. 在**选择目标**部分的**选择一个目标**下，选择 **SNS 主题**。

1. 对于 “**主题**”，选择**MediaConvertJobErrorAlert**。

1. 选择**下一步**。

1. 可选地添加标签。然后选择**下一步**。

1. 检视您的设置。然后，选择**创建规则**。

## 步骤 4：测试您的规则
<a name="mediaconvert_sns_test_rule"></a>

要测试您的规则，请提交您知道将出现错误的作业。例如，指定不存在的输入位置。如果您正确配置了事件规则，将在几分钟后收到包含事件文本消息的电子邮件。

**测试规则**

1. 在 [https://console.aws.amazon.com/medi](https://console.amazonaws.cn/mediaconvert) a AWS Elemental MediaConvert Convert 上打开控制台。

1. 提交一份新 MediaConvert 工作。有关更多信息，请参阅 [教程：配置作业设置](setting-up-a-job.md)。

1. 检查您在设置 Amazon SNS 主题时指定的电子邮件账户。确认您收到作业错误的电子邮件通知。