使用 EventBridge 沙盒测试事件模式 - Amazon EventBridge
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

使用 EventBridge 沙盒测试事件模式

规则使用事件模式来选择事件，并将事件发送到目标。事件模式与它们匹配的事件具有相同的结构。事件模式匹配或不匹配事件。

定义事件模式通常是创建新规则或编辑现有规则这一大型过程中的一环。但是 EventBridge，使用中的沙盒，您可以快速定义事件模式并使用示例事件来确认模式与所需事件相匹配，而无需创建或编辑规则。测试完事件模式后， EventBridge 可以选择直接从沙箱中使用该事件模式创建新规则。

有关事件模式的更多信息，请参阅 亚马逊 EventBridge 事件模式。

重要

在中 EventBridge，可以创建可能导致 higher-than-expected 收费和限制的规则。例如，您可能无意中创建了一条规则，导致无限循环，规则会以递归方式触发，不会结束。假设您创建了一条规则，来检测 S3 桶中的 ACL 更改，然后触发软件以将 ACL 更改为所需状态。如果编写该规则时不小心，则 ACL 的后续更改将再次触发该规则，从而产生无限循环。

有关如何编写精确的规则和事件模式，以最大限度地减少此类意外结果的指导，请参阅定义 Amazon EventBridge 规则的最佳实践和定义 Amazon EventBridge 事件模式时的最佳实践。

使用 EventBridge 沙盒测试事件模式

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

  2. 在导航窗格中选择开发人员资源，然后选择沙盒，再在沙盒页面上选择事件模式选项卡。

  3. 对于事件来源，选择Amazon 事件或 EventBridge合作伙伴事件。

  4. 在示例事件部分，选择要测试事件模式的示例事件类型。

    提供以下示例事件类型：

    • Amazon 事件-从支持 Amazon Web Services的事件中进行选择。

    • EventBridge 合作伙伴活动-从支持的 EventBridge第三方服务（例如 Salesforce）发出的事件中进行选择。

    • 输入我自己的 - 以 JSON 文本输入您自己的事件。

      您也可以使用 Amazon 或合作伙伴事件作为创建自己的自定义事件的起点。

      1. 选择Amazon 活动或EventBridge 合作伙伴活动。

      2. 使用示例事件下拉列表，选择要用作自定义事件起点的事件。

        EventBridge 显示示例事件。

      3. 选择 复制。

      4. 选择输入我自己的作为事件类型。

      5. 在 JSON 编辑窗格中删除示例事件结构，然后将 Amazon 或合作伙伴事件粘贴到原处。

      6. 编辑事件 JSON，创建您自己的示例事件。

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

    Existing schema

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

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

    2. 在事件模式部分的架构类型中，选择从架构注册表中选择架构。

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

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

    5. 在模型部分，选择任意属性旁边的编辑按钮，可打开其属性。根据需要设置关系和值字段，然后选择设置保存属性。

      注意

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

      要删除某一属性的特性，请选择该属性的编辑按钮，然后选择清除。

    6. 选择以 JSON 格式生成事件模式，作为 JSON 文本生成并验证您的事件模式。

    7. 要根据您的事件模式测试示例事件，请选择测试模式。

      EventBridge 显示一个消息框，说明您的示例事件是否与事件模式匹配。

      您还可以选择以下任何选项：

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

      • 修饰 - 添加换行符、制表符和空格，使 JSON 文本更易于阅读。

    Custom schema

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

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

    2. 在事件模式部分的架构类型中，选择输入架构。

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

    4. 在模型部分，选择任意属性旁边的编辑按钮，可打开其属性。根据需要设置关系和值字段，然后选择设置保存属性。

      注意

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

      要删除某一属性的特性，请选择该属性的编辑按钮，然后选择清除。

    5. 选择以 JSON 格式生成事件模式，作为 JSON 文本生成并验证您的事件模式。

    6. 要根据您的事件模式测试示例事件，请选择测试模式。

      EventBridge 显示一个消息框，说明您的示例事件是否与事件模式匹配。

      您还可以选择以下任何选项：

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

      • 修饰 - 添加换行符、制表符和空格，使 JSON 文本更易于阅读。

    Event pattern

    要以 JSON 格式编写自定义事件模式，请执行以下操作：

    1. 在创建方法部分的方法中，选择自定义模式（JSON 编辑器）。

    2. 在事件模式中，以 JSON 格式的文本输入您的自定义事件模式。

    3. 要根据您的事件模式测试示例事件，请选择测试模式。

      EventBridge 显示一个消息框，说明您的示例事件是否与事件模式匹配。

      您还可以选择以下任何选项：

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

      • 修饰 - 添加换行符、制表符和空格，使 JSON 文本更易于阅读。

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

  6. （可选）要使用此事件模式创建规则，并将该规则分配给特定的事件总线，请选择使用模式创建规则。

    EventBridge 将带您进入创建规则的步骤 1，您可以使用它来创建规则并将其分配给您选择的事件总线。

    请注意，步骤 2 - 生成事件模式包含您已经指定的事件模式信息，您可以接受或更新这些信息。

    有关如何创建规则的更多信息，请参阅创建对事件作出反应的 Amazon EventBridge 规则。