在 Amazon 中创建规则 EventBridge - Amazon EventBridge
先决条件概述选择活动筛选事件选择目标配置 规则后续步骤其他资源

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

在 Amazon 中创建规则 EventBridge

先决条件

在开始之前，请确保您满足以下条件：

  • 访问亚马逊 EventBridge 控制台

  • 创建 EventBridge 规则的适当 IAM 权限

  • 对事件驱动架构的基本了解

概述

要对收到的事件采取行动 EventBridge，您可以创建规则。当事件与规则中定义的事件模式相匹配时， EventBridge 会将该事件发送到指定的目标。

本主题将引导您创建规则，该规则 EventBridge 用于在将事件发送到指定事件总线时进行匹配。

创建 EventBridge 规则涉及四个主要步骤：

  1. 选择要处理的事件

  2. 配置事件过滤和测试

  3. 选择和配置目标

  4. 配置规则设置

选择赛事

首先，选择要发送到目标的事件。

要选择一个事件

  1. 打开 Amazon EventBridge 控制台，网址为https://console.aws.amazon.com/events/。

  2. 在导航窗格中，选择规则，然后选择创建规则。

  3. 在 “事件” 选项卡中，找到要发送给目标的事件：

    1. 选择 “AWS 服务事件” 或 “自定义事件”。

    2. 使用搜索框或浏览事件列表来查找要发送到目标的事件。

    3. 将一个或多个事件拖到 “构建” 画布中，然后将其放在 “触发事件” 上。

    EventBridge 显示了 “触发事件” 部分。本部分包括：

    • 活动，其中列出了您选择的活动。

    • 架构，显示所选事件的架构（如果有）。

      架构包含三个选项卡：

      • 树：事件架构的树视图。

      • 代码：开放 API 规范或 JSON 格式的事件架构。

      • 信息：架构的概述信息。

    • 示例事件，显示所选事件的样本（如果有）。

    • 事件模式（过滤器），它包含一个事件模式，用于选择您选择的所有事件。

筛选事件以仅发送您想要的内容

您可能不想将特定类型的所有事件发送到目标。您可以使您的事件模式更加具体，以便它只选择包含您感兴趣的属性和值的事件。

编辑事件模式（可选）

在触发事件窗格中，您可以通过两种方式构建事件模式：

  • 直观地使用架构树视图

  • 在事件模式窗格中直接编辑 JSON

使用架构树视图编辑事件模式

  1. 选择 “架构” 窗格的 “树” 选项卡。

  2. 添加和编辑过滤器以构建事件模式。

    1. 选择要作为过滤器添加到事件模式的属性旁边的过滤器图标。

    2. 从下拉列表中选择比较运算符。

      有关比较运算符的更多信息，请参阅创建事件模式。

    3. 输入要匹配的值。

    4. 单击复选标记即可完成。

    EventBridge 将您创建的过滤器添加到事件模式窗格中的 JSON 中。

  3. 添加其他过滤器，直到构造出与所需的所有事件属性相匹配的事件模式。

测试事件模式

在构造与所需的所有事件属性相匹配的事件模式后，请进行测试以确保事件模式按预期执行。

测试事件模式（可选）

  1. 选择一个示例事件进行测试，或者使用自己的样本事件。

    • 使用提供的示例事件

      1. 选择使用提供的示例事件。

      2. 在 “触发事件示例” 下，从下拉列表中选择要用于测试的事件。

    • 使用你自己的活动

      1. 选择使用自己的活动。

        EventBridge 显示带有空details元素的通用事件。

      2. 编辑事件 JSON 以创建要测试事件模式的事件。

        提示

        您可以使用提供的示例事件作为起点，创建自己的自定义事件，以便在测试中使用：

        1. 选择 “使用提供的示例事件”，从 “示例” 触发事件中选择一个事件，然后选择 “复制”。

        2. 选择使用自己的活动。

        3. 在窗口中选择整个事件，然后将示例事件粘贴到其上。

        4. 根据需要编辑事件。

  2. 选择 “运行测试”。

    EventBridge 显示一条消息，说明测试事件是否与事件模式匹配。

选择目标

将一个（最多五个）目标拖到 “构建” 画布中，然后将其放在 “目标” 上，即可接收与指定事件模式匹配的事件。目标可以包括：

  • 其他 EventBridge 活动巴士，相同或不同 AWS 账户

  • EventBridge API 目的地，包括 Salesforce 等 SaaS 合作伙伴

  • 一系列 AWS 服务资源，例如亚马逊 SQS 队列或亚马逊 SNS 主题

选择目标

  1. 从 “目标” 窗格中选择目标类型，然后将其拖放到 “构建” 画布的 “目标” 形状上。

    EventBridge 在 Build 中显示 “目标” 部分，并根据您选择的目标类型显示适用的配置选项。

    提示

    如果您指定了多个目标，则选择目标形状会显示该目标的配置部分。

  2. 根据您的目标类型配置目标。有关详细的配置步骤，请参阅EventBridge 目标。

自定义发送到目标的事件数据

如果您选择 EventBridge 事件总线或 EventBridge API 目标以外的目标，则可以选择自定义实际传送到目标的数据。

转换或替换发送的事件数据（可选）

  1. 在构建设计画布中，选择目标形状中的输入转换图标。

    EventBridge 显示输入转换部分。

  2. 在输入转换配置下，选择启用。

  3. 选择转换方法以选择如何自定义发送到目标以匹配事件的文本：

    • 匹配事件的一部分 — EventBridge 仅将原始源事件的指定部分发送到目标。

    • 常量（JSON 文本）-仅 EventBridge 向目标发送指定的 JSON 文本。不会发送原始源事件的任何部分。

    • 输入转换器-配置输入转换器以自定义要发送 EventBridge 到目标的文本。有关更多信息，请参阅转换目标输入。

配置 规则

最后，配置并创建规则。

配置规则（控制台）

  1. 选择配置。

  2. 输入规则的名称和可选描述。

    一条规则不能与同一事件总线上的另一条规则同名。 AWS 区域

  3. 对于事件总线，请选择要与此规则关联的事件总线。

    如果您希望此规则对来自您自己的账户的匹配事件触发，请选择 AWS 默认事件总线。当你账户 AWS 服务 中的用户发送事件时，它总是会转到你账户的默认事件总线。

  4. 要在规则创建后立即启用规则，请在 “激活” 下启用 “激活”。

  5. （可选）为规则输入一个或多个标签。有关更多信息，请参阅 在 Amazon EventBridge 中为资源添加标签。

  6. 选择创建。

后续步骤

创建规则后，您可以：

其他资源

有关 EventBridge 规则的更多信息，请参阅：