创建对事件做出反应的亚马逊 EventBridge 规则 - 亚马逊 EventBridge
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

创建对事件做出反应的亚马逊 EventBridge 规则

要对亚马逊收到的事件采取行动 EventBridge,您可以创建规则。当事件与规则中定义的事件模式匹配时, EventBridge 会将事件发送到指定的目标并触发规则中定义的操作。

以下视频探讨了创建不同类型的规则以及如何对其进行测试:

定义规则

首先,输入规则的名称和描述,以对其进行识别。您还必须定义事件总线,您的规则将在该总线中查找与事件模式匹配的事件。

定义规则细节
  1. 通过 https://console.aws.amazon.com/events/ 打开亚马逊 EventBridge 主机。

  2. 在导航窗格中,选择 Rules (规则)

  3. 选择 Create rule (创建规则)

  4. 输入规则的名称描述(可选)。

    规则不能与同一 Amazon Web Services 区域中和同一事件总线上的另一条规则的名称相同。

  5. 对于 Event bus(事件总线),请选择要与此规则关联的事件总线。如果您希望此规则对来自您账户的匹配事件触发,请选择Amazon默认事件总线。当您账户中的某个 Amazon Web Service发出一个事件时,它始终会发送到您账户的默认事件总线。

  6. 对于 Rule type(规则类型),选择 Rule with an event pattern(具有事件模式的规则)。

  7. 选择 Next(下一步)

建立事件模式

接下来,构建事件模式。为此,请指定事件源,选择事件模式的基础,并定义要匹配的属性和值。您也可以在 JSON 中生成事件模式,并针对示例事件对其进行测试。

建立事件模式
  1. 对于事件来源,选择Amazon事件或 EventBridge合作伙伴事件

  2. (可选)如果要针对示例事件测试事件模式,请在 “示例事件” 部分中选择示例事件类型。提供了以下示例类型:

    • Amazon事件 — 从支持的事件中选择Amazon Web Services。

    • EventBridge 合作伙伴活动 — 从支持的 EventBridge第三方服务(例如 Salesforce)发起的事件中进行选择。

    • 输入我自己的事件 — 以 JSON 文本输入你自己的事件。

  3. 选择创建方法。您可以根据 EventBridge 架构或模板创建事件模式,也可以创建自定义事件模式。

    • 要使用现有 EventBridge 架构创建事件模式,请执行以下操作:

      1. 在 “创建方法” 部分的 “方法” 中,选择 “使用架构”。

      2. 在 “事件模式” 部分中,对于 “架构类型”,选择 “从架构注册表中选择架构”。

      3. 对于 Schema 注册表,选择下拉框并输入架构注册表的名称,例如aws.events。您也可以从出现的下拉列表中选择一个选项。

      4. 对于架构,选择下拉框并输入要使用的架构的名称。例如,aws.s3@ObjectDeleted。您也可以从出现的下拉列表中选择一个选项。

      5. 模型部分中,选择任何属性旁边的编辑按钮以打开其属性。根据需要设置 “关系” 和 “” 字段,然后选择 “设置” 以保存该属性。

        注意

        有关属性定义的信息,请选择该属性名称旁边的 “信息” 图标。要参考如何在事件中设置属性属性,请打开属性属性对话框的注释部分。

        要删除某个属性的属性,请选择该属性的编辑按钮,然后选择清除

      6. 选择 “在 JSON 中生成事件模式”,将事件模式生成并验证为 JSON 文本。然后,选择以下任一选项:

        • 复制 — 将事件模式复制到设备的剪贴板。

        • Prettify — 通过添加换行符、制表符和空格,使 JSON 文本更易于阅读。

        • 测试模式 -针对示例事件部分中的示例事件测试 JSON 格式的模式。

    • 要编写自定义架构并将其转换为事件模式,请执行以下操作:

      1. 在 “创建方法” 部分中,为 “方法” 选择 “使用架构”。

      2. 在 “事件模式” 部分中,对于 “架构类型”,选择 “输入架构”。

      3. 在该文本框中输入您的架构。您必须将架构格式化为有效的 JSON 文本。

      4. 模型部分中,选择任何属性旁边的编辑按钮以打开其属性。根据需要设置 “关系” 和 “” 字段,然后选择 “设置” 以保存该属性。

        注意

        有关属性定义的信息,请选择该属性名称旁边的 “信息” 图标。要参考如何在事件中设置属性属性,请打开属性属性对话框的注释部分。

        要删除某个属性的属性,请选择该属性的编辑按钮,然后选择清除

      5. 选择 “在 JSON 中生成事件模式”,将事件模式生成并验证为 JSON 文本。然后,选择以下任一选项:

        • 复制 — 将事件模式复制到设备的剪贴板。

        • Prettify — 通过添加换行符、制表符和空格,使 JSON 文本更易于阅读。

        • 测试模式 -针对示例事件部分中的示例事件测试 JSON 格式的模式。

    • 要以 JSON 格式编写自定义事件模式,请执行以下操作:

      1. 在 “创建方法” 部分中,为 “方法” 选择 “自定义模式(JSON 编辑器)”。

      2. 对于事件模式,以 JSON 格式的文本输入您的自定义事件模式。

      3. 创建图案后,选择以下任一选项:

        • 复制 — 将事件模式复制到设备的剪贴板。

        • Prettify — 通过添加换行符、制表符和空格,使 JSON 文本更易于阅读。

        • 事件模式表单-在模式生成器中打开事件模式。如果图案无法在模式生成器中按原样呈现,则会在打开模式生成器之前向您 EventBridge 发出警告。

        • 测试模式 -针对示例事件部分中的示例事件测试 JSON 格式的模式。

  4. 选择 Next(下一步)

选择目标

选择一个或多个目标来接收与指定模式匹配的事件。目标可以包括 EventBridge 事件总线、 EventBridge API 目的地,包括 Salesforce 等 SaaS 合作伙伴或其他合作伙伴Amazon Web Service。

选择目标
  1. 对于 Typtype(目标类型),请选择以下任一选项:

    • 要选择 EventBridge 事件总线,请选择EventBridge 事件总线,然后执行以下操作:

      1. 要使用与此规则Amazon Web Services 区域相同的事件总线,请在同一账户和区域中选择事件总线。然后,对于目标的事件总线,选择下拉框并输入事件总线的名称。您也可以从下拉列表中选择事件总线。

      2. 要使用其他Amazon Web Services 区域账户中的事件总线作为此规则,请选择其他账户或地区中的事件总线。然后,将事件总线作为目标,输入要使用的事件总线的 ARN。

    • 要使用 EventBridge API 目标,请选择 EventBridge API 目标,然后执行以下操作:

      1. 要使用现有 API 目标,请选择使用现有 API 目标。然后,从下拉列表中选择 API 目标。

      2. 要创建新的 API 目标,请选择创建新的 API 目标。然后,提供目的地的以下详细信息:

        • 名称 — 输入目的地的名称。名称在您的中必须唯一Amazon Web Services 账户。名称最多可以包含 64 个字符。有效字符为 A-Za-z0-9_ -(连字符)。

        • (可选)描述 — 输入目标的描述。描述最多可以包含 512 个字符。

        • API 目标端点-目标的 URL 端点。端点 URL 必须以开头https。可以将通配符*作为路径参数包括在内。您可以从目标的HttpParameters属性中设置路径参数。

        • HTTP 方法-选择调用端点时使用的 HTTP 方法。

        • (可选)每秒调用速率限制-输入此目标每秒接受的最大调用次数。该值必须大于零。默认情况下,该值设置为 300。

        • 连接-要使用现有连接,请选择使用现有连接,然后从下拉列表中选择连接。要为此目标创建新连接,请选择创建新连接,然后定义连接的名称目标类型授权类型。您也可以为此连接添加可选的描述

    • 要使用Amazon Web Service,请选择 Amazon Web Service,然后执行以下操作:

      1. “选择目标” 中,选择Amazon Web Service要用作目标的。提供您选择的服务所需的信息。

        注意

        显示的字段因所选服务而异。有关可用目标的更多信息,请参阅 EventBridge 控制台中可用的目标

  2. 对于 Exection 角色,执行以下操作之一:

    • 要为此规则创建新的执行角色,请选择为此特定资源创建新角色。然后输入此执行角色的名称,或使用生成的名称 EventBridge。

    • 要使用该规则的现有执行角色,请选择 “使用现有角色”。然后,从下拉列表中选择或输入要使用的执行角色的名称。

  3. 选择 Next(下一步)

配置标签和审查规则

最后,为该规则输入任何所需的标签,然后查看并创建规则。

配置标签,查看和创建规则
  1. (可选)为规则输入一个或多个标签。有关更多信息,请参阅 亚马逊 EventBridge 标签

  2. 选择 Next(下一步)

  3. 查看新规则的详细信息。要对任何部分进行更改,请选择该部分旁边的编辑按钮。

    如果对规则详细信息感到满意,请选择创建规则