使用 EventBridge 沙盒测试事件模式 - Amazon EventBridge

使用 EventBridge 沙盒测试事件模式

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

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

重要

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

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

使用 EventBridge 沙盒测试事件模式

  1. 访问 https://console.aws.amazon.com/events/，打开 Amazon EventBridge 控制台。

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

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

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

    提供以下示例事件类型：

    • AWS 事件 - 从支持的 AWS 服务发出的事件中进行选择。

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

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

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

      1. 选择 AWS 事件或 EventBridge 合作伙伴事件。

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

        EventBridge 显示此示例事件。

      3. 选择 复制。

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

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

      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 中创建对事件作出反应的规则。