教程：使用记录 Amazon S3 对象级操作 EventBridge - Amazon EventBridge
步骤 1：配置您的 Amazon CloudTrail 跟踪步骤 2：创建 Amazon Lambda 函数步骤 3：创建 规则第 4 步：测试规则步骤 5：确认成功步骤 6：清除资源
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

教程：使用记录 Amazon S3 对象级操作 EventBridge

您可以在 Amazon S3 桶中记录对象级别 API 操作。 EventBridge 在 Amazon 匹配这些事件之前，您必须使用Amazon CloudTrail设置和配置跟踪以接收这些事件。

在本教程中，您将创建 CloudTrail 跟踪、创建Amazon Lambda函数，然后在 EventBridge 控制台中创建规则，用于调用该函数以响应 S3 数据事件。

步骤 1：配置您的 Amazon CloudTrail 跟踪

要将 S3 存储桶的数据事件记录到 Amazon CloudTrail 和 EventBridge中，请先创建跟踪。跟踪 会捕获您账户中的 API 调用和相关事件，并将日志文件传输到您指定的 S3 桶。您可以更新现有跟踪或创建一个新跟踪。

有关更多信息，请参阅《Amazon CloudTrail 用户指南》中的数据事件。

创建跟踪

  1. 打开 CloudTrail 控制台，网址为https://console.aws.amazon.com/cloudtrail/。

  2. 依次选择 Trails (跟踪)、Create trail (创建跟踪)。

  3. 对于 Trail name，键入跟踪的名称。

  4. 在存储位置中，选择创建新的 S3 桶。

  5. 在 Amazon KMS 别名中，为 KMS 密钥键入别名。

  6. 选择下一步。

  7. 对于事件类型，选择数据事件。

  8. 对于数据事件，执行以下操作之一：

    • 要记录存储桶中所有 Amazon S3 对象的数据事件，请指定一个 S3 存储桶和一个空前缀。当事件在该存储桶中的对象上发生时，跟踪将处理和记录事件。

    • 要记录桶中特定 Amazon S3 对象的数据事件，请指定 S3 桶和对象前缀。当事件在该 存储桶中的对象上发生且对象以指定前缀开头时，跟踪将处理和记录事件。

  9. 对于每个资源，选择是要记录读取事件、写入事件，还是同时记录这两类事件。

  10. 选择下一步。

  11. 选择创建跟踪。

步骤 2：创建 Amazon Lambda 函数

创建一个 Lambda 函数，以记录 S3 存储桶的数据事件。

创建 Lambda 函数

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

  2. 选择 Create function (创建函数)。

  3. 选择从头开始创作。

  4. 输入 Lambda 函数的名称和说明。例如，将函数命名为 LogS3DataEvents。

  5. 将其余选项保留为默认值，然后选择创建函数。

  6. 在函数页面的代码选项卡上，双击 index.js。

  7. 使用以下代码替换现有代码。

    'use strict';

exports.handler = (event, context, callback) => {
    console.log('LogS3DataEvents');
    console.log('Received event:', JSON.stringify(event, null, 2));
    callback(null, 'Finished');
};

  8. 选择部署。

步骤 3：创建 规则

创建规则，运行您在步骤 2 中创建的 Lambda 函数。此规则运行是为了响应 Amazon S3 数据事件。

创建 规则

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

  2. 在导航窗格中，选择规则。

  3. 选择创建规则。

  4. 为规则输入名称和描述。例如，将规则命名为 TestRule

  5. 对于事件总线，请选择要与此规则关联的事件总线。如果您希望此规则对来自您自己的账户的匹配事件触发，请选择默认。当您账户中的某个 Amazon 服务发出一个事件时，它始终会发送到您账户的默认事件总线。

  6. 对于规则类型，选择具有事件模式的规则。

  7. 选择下一步。

  8. 对于事件源，选择Amazon 服务。

  9. 对于 Event pattern（事件模式），执行以下操作：

    1. 对于事件源，从下拉列表中选择 Simple Storage Service (S3)。

    2. 对于事件类型，请 CloudTrail从下拉列表中选择对象级 API 调用方式。

    3. 选择 “特定操作”，然后选择PutObject。

    4. 默认情况下，该规则与区域中所有存储桶的数据事件匹配。要匹配特定存储桶的数据事件，请选择 Specify bucket(s) by name (按名称匹配特定存储桶)，然后指定一个或多个存储桶。

  10. 选择下一步。

  11. 对于目标类型，选择Amazon 服务。

  12. 对于选择目标，从下拉列表中选择 Lambda 函数。

  13. 对于函数，选择您在步骤 1 中创建的 Lambda 函数。

  14. 选择下一步。

  15. 选择下一步。

  16. 查看规则详细信息并选择创建规则。

第 4 步：测试规则

为了测试规则，将一个对象置于 S3 存储桶中。您可以验证您的 Lambda 函数是否已调用。

要查看您的 Lambda 函数的日志

  1. 打开 CloudWatch 控制台，网址为https://console.aws.amazon.com/cloudwatch/。

  2. 在导航窗格中，选择日志。

  3. 选择您的 Lambda 函数 (/aws/lambda/function-name) 的日志组的名称。

  4. 选择日志流的名称，以查看您启动的实例的函数提供的数据。

您还可以在为跟踪指定的 S3 存储桶中查看 CloudTrail 日志。有关更多信息，请参阅Amazon CloudTrail 用户指南中的获取和查看您的 CloudTrail 日志文件。

步骤 5：确认成功

如果您在 CloudWatch 日志中看到 Lambda 事件，则说明您已成功完成本教程。如果您的 CloudWatch 日志中没有该事件，请通过验证规则是否成功创建来开始故障排除，如果规则看起来正确，请验证您的 Lambda 函数的代码是否正确。

步骤 6：清除资源

除非您想要保留为本教程创建的资源，否则可立即将其删除。通过删除不再使用的 Amazon 资源，可以防止向您的 Amazon 账户收取不必要的费用。

删除 EventBridge 规则

  1. 打开 EventBridge 控制台的 “规则” 页面。

  2. 选择您创建的规则。

  3. 选择删除。

  4. 选择删除。

删除 Lambda 函数

  1. 打开 Lamba 控制台的函数页面。

  2. 选择您创建的函数。

  3. 依次选择 Actions 和 Delete。

  4. 选择 Delete（删除）。

删除 CloudTrail 跟踪

  1. 打开 CloudTrail 控制台的 T rails 页面。

  2. 选择您创建的跟踪。

  3. 选择删除。

  4. 选择 Delete（删除）。