教程:使用 EventBridge 记录 Amazon S3 对象级别操作 - Amazon EventBridge
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

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

您可以在您的Amazon S3存储桶。在亚马逊 EventBridge 可以匹配这些事件,必须使用Amazon CloudTrail设置和配置跟踪以接收这些事件。

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

第 1 步:配置Amazon CloudTrail跟踪

要将 S3 存储桶的数据事件记录到Amazon CloudTrail和 EventBridge,您首先创建一个跟踪。A跟踪捕获您账户中的 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. 选择 Next

  7. 适用于Event type中,选择数据事件

  8. 适用于数据事件,请执行以下操作之一:

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

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

  9. 对于每个资源,选择是否记录Read事件,写入事件,或者这两者。

  10. 选择 Next

  11. 选择 Create trail (创建跟踪)

第 2 步:创建Amazon Lambdafunction

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

创建 Lambda 函数

  1. 打开Amazon Lambda控制台 ()https://console.aws.amazon.com/lambda/

  2. 选择创建函数

  3. 选择 Author from scratch

  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. 选择 Deploy

第 3 步:创建规则

创建一个规则,以运行您在 Step 2 中创建的 Lambda 函数。此规则是为了响应 Amazon S3 数据事件而运行的。

创建 规则

  1. 打开位于 https://console.aws.amazon.com/events/ 的 Amazon EventBridge 控制台。

  2. 在导航窗格中,选择 Rules (规则)

  3. 选择 Create rule (创建规则)

  4. 为规则输入名称和描述。

  5. 对于 Define pattern (定义模式),请执行以下操作:

    1. 选择 Event Pattern (事件模式)

    2. 选择 Pre-defined pattern by service (服务预定义的模式)

    3. 对于 Service provider (服务提供商),选择 Amazon

    4. 对于服务名称,选择 Simple Storage Service (S3)

    5. 对于 Event type (事件类型),选择 Object Level Operations (对象级别操作)

    6. 依次选择特定操作PutObject (放置对象)

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

  6. 对于 Select event bus (选择事件总线),选择 Amazon default event bus (Amazon 默认事件总线)。当Amazon服务会发出一个事件,它会发送到您账户的默认事件总线。

  7. 适用于目标中,选择Lambda 函数

  8. 适用于函数中,选择您创建的 Lambda 函数。

  9. 选择创建

第 4 步:测试 规则

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

查看 Lambda 函数的日志

  1. 通过以下网址打开 CloudWatch 控制台:https://console.aws.amazon.com/cloudwatch/

  2. 在导航窗格中,选择 Logs

  3. 选择 Lambda 函数 (/aws/lambda/function-name)。

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

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

第 5 步:确认成功

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

第 6 步:清除资源

现在,您可以删除为本教程创建的资源,除非您想要保留这些资源。通过删除Amazon您不再使用的资源,可防止您的Amazonaccount.

删除 EventBridge 梁规则的步骤

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

  2. 选择您创建的规则。

  3. 选择 Delete (删除)

  4. 选择 Delete (删除)

删除 Lambda 函数

  1. 打开“函数” 页Lambda 控制台。

  2. 选择您创建的函数。

  3. 依次选择 ActionsDelete

  4. 选择 Delete (删除)

删除 CloudTrail 跟踪

  1. 打开跟踪页CloudTrail 控制台。

  2. 选择您创建的跟踪。

  3. 选择 Delete (删除)

  4. 选择 Delete (删除)