本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
创建对事件做出反应的亚马逊 EventBridge 规则
要对亚马逊收到的事件采取行动 EventBridge,您可以创建规则。当事件与规则中定义的事件模式匹配时, EventBridge 会将事件发送到指定的目标并触发规则中定义的操作。
以下视频探讨了创建不同类型的规则以及如何对其进行测试:
定义规则
首先,输入规则的名称和描述,以对其进行识别。您还必须定义事件总线,您的规则将在该总线中查找与事件模式匹配的事件。
定义规则细节
通过 https://console.aws.amazon.com/events/
打开亚马逊 EventBridge 主机。 -
在导航窗格中,选择 Rules (规则)。
-
选择 Create rule (创建规则)。
-
输入规则的名称和描述(可选)。
规则不能与同一 Amazon Web Services 区域中和同一事件总线上的另一条规则的名称相同。
-
对于 Event bus(事件总线),请选择要与此规则关联的事件总线。如果您希望此规则对来自您账户的匹配事件触发,请选择Amazon默认事件总线。当您账户中的某个 Amazon Web Service发出一个事件时,它始终会发送到您账户的默认事件总线。
-
对于 Rule type(规则类型),选择 Rule with an event pattern(具有事件模式的规则)。
-
选择 Next(下一步)。
建立事件模式
接下来,构建事件模式。为此,请指定事件源,选择事件模式的基础,并定义要匹配的属性和值。您也可以在 JSON 中生成事件模式,并针对示例事件对其进行测试。
建立事件模式
-
对于事件来源,选择Amazon事件或 EventBridge合作伙伴事件。
-
(可选)如果要针对示例事件测试事件模式,请在 “示例事件” 部分中选择示例事件类型。提供了以下示例类型:
-
Amazon事件 — 从支持的事件中选择Amazon Web Services。
-
EventBridge 合作伙伴活动 — 从支持的 EventBridge第三方服务(例如 Salesforce)发起的事件中进行选择。
-
输入我自己的事件 — 以 JSON 文本输入你自己的事件。
-
-
选择创建方法。您可以根据 EventBridge 架构或模板创建事件模式,也可以创建自定义事件模式。
-
要使用现有 EventBridge 架构创建事件模式,请执行以下操作:
-
在 “创建方法” 部分的 “方法” 中,选择 “使用架构”。
-
在 “事件模式” 部分中,对于 “架构类型”,选择 “从架构注册表中选择架构”。
-
对于 Schema 注册表,选择下拉框并输入架构注册表的名称,例如
aws.events
。您也可以从出现的下拉列表中选择一个选项。 -
对于架构,选择下拉框并输入要使用的架构的名称。例如,
aws.s3@ObjectDeleted
。您也可以从出现的下拉列表中选择一个选项。 -
在模型部分中,选择任何属性旁边的编辑按钮以打开其属性。根据需要设置 “关系” 和 “值” 字段,然后选择 “设置” 以保存该属性。
注意
有关属性定义的信息,请选择该属性名称旁边的 “信息” 图标。要参考如何在事件中设置属性属性,请打开属性属性对话框的注释部分。
要删除某个属性的属性,请选择该属性的编辑按钮,然后选择清除。
-
选择 “在 JSON 中生成事件模式”,将事件模式生成并验证为 JSON 文本。然后,选择以下任一选项:
-
复制 — 将事件模式复制到设备的剪贴板。
-
Prettify — 通过添加换行符、制表符和空格,使 JSON 文本更易于阅读。
-
测试模式 -针对示例事件部分中的示例事件测试 JSON 格式的模式。
-
-
-
要编写自定义架构并将其转换为事件模式,请执行以下操作:
-
在 “创建方法” 部分中,为 “方法” 选择 “使用架构”。
-
在 “事件模式” 部分中,对于 “架构类型”,选择 “输入架构”。
-
在该文本框中输入您的架构。您必须将架构格式化为有效的 JSON 文本。
-
在模型部分中,选择任何属性旁边的编辑按钮以打开其属性。根据需要设置 “关系” 和 “值” 字段,然后选择 “设置” 以保存该属性。
注意
有关属性定义的信息,请选择该属性名称旁边的 “信息” 图标。要参考如何在事件中设置属性属性,请打开属性属性对话框的注释部分。
要删除某个属性的属性,请选择该属性的编辑按钮,然后选择清除。
-
选择 “在 JSON 中生成事件模式”,将事件模式生成并验证为 JSON 文本。然后,选择以下任一选项:
-
复制 — 将事件模式复制到设备的剪贴板。
-
Prettify — 通过添加换行符、制表符和空格,使 JSON 文本更易于阅读。
-
测试模式 -针对示例事件部分中的示例事件测试 JSON 格式的模式。
-
-
-
要以 JSON 格式编写自定义事件模式,请执行以下操作:
-
在 “创建方法” 部分中,为 “方法” 选择 “自定义模式(JSON 编辑器)”。
-
对于事件模式,以 JSON 格式的文本输入您的自定义事件模式。
-
创建图案后,选择以下任一选项:
-
复制 — 将事件模式复制到设备的剪贴板。
-
Prettify — 通过添加换行符、制表符和空格,使 JSON 文本更易于阅读。
-
事件模式表单-在模式生成器中打开事件模式。如果图案无法在模式生成器中按原样呈现,则会在打开模式生成器之前向您 EventBridge 发出警告。
-
测试模式 -针对示例事件部分中的示例事件测试 JSON 格式的模式。
-
-
-
-
选择 Next(下一步)。
选择目标
选择一个或多个目标来接收与指定模式匹配的事件。目标可以包括 EventBridge 事件总线、 EventBridge API 目的地,包括 Salesforce 等 SaaS 合作伙伴或其他合作伙伴Amazon Web Service。
选择目标
-
对于 Typtype(目标类型),请选择以下任一选项:
-
要选择 EventBridge 事件总线,请选择EventBridge 事件总线,然后执行以下操作:
-
要使用与此规则Amazon Web Services 区域相同的事件总线,请在同一账户和区域中选择事件总线。然后,对于目标的事件总线,选择下拉框并输入事件总线的名称。您也可以从下拉列表中选择事件总线。
-
要使用其他Amazon Web Services 区域账户中的事件总线作为此规则,请选择其他账户或地区中的事件总线。然后,将事件总线作为目标,输入要使用的事件总线的 ARN。
-
-
要使用 EventBridge API 目标,请选择 EventBridge API 目标,然后执行以下操作:
-
要使用现有 API 目标,请选择使用现有 API 目标。然后,从下拉列表中选择 API 目标。
-
要创建新的 API 目标,请选择创建新的 API 目标。然后,提供目的地的以下详细信息:
-
名称 — 输入目的地的名称。名称在您的中必须唯一Amazon Web Services 账户。名称最多可以包含 64 个字符。有效字符为 A-Z、a-z、0-9 和。 _ -(连字符)。
-
(可选)描述 — 输入目标的描述。描述最多可以包含 512 个字符。
-
API 目标端点-目标的 URL 端点。端点 URL 必须以开头
https
。可以将通配符*
作为路径参数包括在内。您可以从目标的HttpParameters
属性中设置路径参数。 -
HTTP 方法-选择调用端点时使用的 HTTP 方法。
-
(可选)每秒调用速率限制-输入此目标每秒接受的最大调用次数。该值必须大于零。默认情况下,该值设置为 300。
-
连接-要使用现有连接,请选择使用现有连接,然后从下拉列表中选择连接。要为此目标创建新连接,请选择创建新连接,然后定义连接的名称、目标类型和授权类型。您也可以为此连接添加可选的描述。
-
-
-
要使用Amazon Web Service,请选择 Amazon Web Service,然后执行以下操作:
-
在 “选择目标” 中,选择Amazon Web Service要用作目标的。提供您选择的服务所需的信息。
注意
显示的字段因所选服务而异。有关可用目标的更多信息,请参阅 EventBridge 控制台中可用的目标。
-
-
-
对于 Exection 角色,执行以下操作之一:
-
要为此规则创建新的执行角色,请选择为此特定资源创建新角色。然后输入此执行角色的名称,或使用生成的名称 EventBridge。
-
要使用该规则的现有执行角色,请选择 “使用现有角色”。然后,从下拉列表中选择或输入要使用的执行角色的名称。
-
-
选择 Next(下一步)。
配置标签和审查规则
最后,为该规则输入任何所需的标签,然后查看并创建规则。
配置标签,查看和创建规则
-
(可选)为规则输入一个或多个标签。有关更多信息,请参阅 亚马逊 EventBridge 标签。
-
选择 Next(下一步)。
-
查看新规则的详细信息。要对任何部分进行更改,请选择该部分旁边的编辑按钮。
如果对规则详细信息感到满意,请选择创建规则。