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

在 Amazon EventBridge 中创建事件归档

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

您也可以在创建事件总线的过程中创建归档。这些归档采用无限期保留策略，且未设置事件筛选条件，但可以在创建归档后对此进行更新。

定义归档

首先，输入归档的名称和描述，并指定其从中接收事件的事件总线。您也可以选择设置归档中事件的保留时长。

定义归档

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

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

    • 在导航窗格中，选择事件总线。

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

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

  3. 选择创建存档。

  4. 在归档详细信息下，输入归档名称，并可选择性地添加描述。

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

  5. 在源选项中，选择需将事件发送到该归档的事件总线。

    如果是从现有的事件总线详细信息页面跳转至本页面，则会默认显示该事件总线的名称。

    创建归档后，无法更改源事件总线。

  6. 在保留期选项中，指定事件在归档中的保留时长：

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

    • 若要设置固定的保留期，请输入天数，EventBridge 将在该天数后从归档中删除事件。

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

    重要

    如果您已指定 EventBridge 使用客户自主管理型密钥对源事件总线进行加密，强烈建议您同时为事件总线的所有归档指定客户自主管理型密钥。

    • 选择使用 Amazon 拥有的密钥，以便 EventBridge 使用 Amazon 拥有的密钥 对数据进行加密。

      这种 Amazon 拥有的密钥 是 EventBridge 拥有并管理的 KMS 密钥，可在多个 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，则存档中没有事件。