在 Amazon 中创建活动档案 EventBridge - Amazon EventBridge
定义档案构建事件模式（可选）
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

在 Amazon 中创建活动档案 EventBridge

在中创建档案时 EventBridge，您可以通过指定事件模式来确定将哪些事件发送到存档。 EventBridge 将与事件模式匹配的事件发送到存档。您还可以设置保留期，在事件被丢弃之前将其存储到存档中。

您还可以在创建事件总线的过程中创建档案。这些存档有无限期的保留策略，没有事件过滤器，但可以在创建存档后对其进行更新。

定义档案

首先，输入存档的名称和描述，并指定它从中接收事件的事件总线。或者，您也可以设置事件在存档中保留多长时间。

要定义档案

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

  2. 导航到源事件总线，或者直接创建存档：

    • 在导航窗格中，选择 Event Buses (事件总线)。

      在事件总线详细信息页面上，选择归档选项卡。

    • 在导航窗格中，选择存档。

  3. 选择创建存档。

  4. 在档案详细信息下，输入档案的名称和描述（可选）。

    在所选区域中，该名称对于您的账户必须是唯一的。在创建存档后无法更改名称。

  5. 对于 S ourc e，选择要将事件发送到存档的事件总线

    如果您从现有的事件总线详细信息页面导航，则默认情况下会显示该事件总线的名称。

    一旦创建了存档，就无法更改源事件总线。

  6. 对于保留期，请指定事件在存档中保留多长时间：

    • 选择无限期，可将事件保留在存档中，永远不会删除。

    • 对于设定的保留期，请输入天数，在此天后 EventBridge 应将事件从存档中删除。

  7. 对于加密，选择加密存档中存储的事件时 EventBridge 要使用的 KMS 密钥。

    重要

    如果您已指定 EventBridge 使用客户托管密钥对源事件总线进行加密，我们强烈建议您同时为事件总线的任何存档指定客户托管密钥。

    • 选择 “ Amazon 拥有的密钥使用” EventBridge 以使用加密数据 Amazon 拥有的密钥。

      Amazon 拥有的密钥 这是一个 KMS 密钥， EventBridge 拥有并管理，可在多个 Amazon 账户中使用。通常，除非要求您审核或控制保护资源的加密密钥， Amazon 拥有的密钥 否则不妨选择。

      这是默认值。

    • 选择 “使用客户托管密钥” EventBridge ，使用您指定或创建的客户托管密钥对数据进行加密。

      客户托管密钥是您在 Amazon 账户中创建、拥有和管理的 KMS 密钥。您对此类 KMS 密钥拥有完全控制权。

      1. 指定现有的客户托管密钥，或选择创建新的 KMS 密钥 />。

        EventBridge 显示密钥状态以及与指定客户托管密钥关联的所有密钥别名。

  8. 选择下一步。

构建事件模式（可选）

接下来，作为可选步骤，您可以构建一个事件模式来筛选哪些事件 EventBridge 发送到存档。方法是指定事件源，选择事件模式的基础，然后定义要匹配的属性和值。您也可以生成 JSON 格式的事件模式，并针对示例事件对其进行测试。

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

构建事件模式

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

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

    提供以下示例事件类型：

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

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

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

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

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

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

        EventBridge 显示示例事件。

      3. 选择 复制。

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

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

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

  3. 选择创建方法。您可以根据 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 发出警告。

  4. 选择创建存档。

要确认事件已成功发送到档案，您可以使用 EventBridge API 的DescribeArchive操作来查看是否EventCount反映了档案中的事件数量。如果为 0，则存档中没有事件。