教程:使用记录 Amazon API 调用 EventBridge - Amazon EventBridge
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

教程:使用记录 Amazon API 调用 EventBridge

您可以使用 Amazon EventBridge 规则来响应由记录的 Amazon 服务发出的 API 调用 Amazon CloudTrail。

在本教程中,您将在控制台中创建Amazon CloudTrail跟踪、Lambda 函数和规则。 EventBridge 当一个 Amazon EC2 实例停止时,该规则会调用 Lambda 函数。

步骤 1:创建 Amazon CloudTrail 跟踪

如果您已设置了跟踪,请跳转至步骤 2。

创建跟踪
  1. 打开 CloudTrail 控制台,网址为 https://console.aws.amazon.com/cloudtrail/

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

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

  4. 存储位置中,选择创建新的 S3 桶

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

  6. 选择下一步

  7. 选择下一步

  8. 选择创建跟踪

步骤 2:创建 Amazon Lambda 函数

创建 Lambda 函数以记录 API 调用事件。

创建 Lambda 函数
  1. 打开 Amazon Lambda 控制台,网址为 https://console.aws.amazon.com/lambda/

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

  3. 选择从头开始创作

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

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

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

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

    'use strict'; exports.handler = (event, context, callback) => { console.log('LogEC2StopInstance'); console.log('Received event:', JSON.stringify(event, null, 2)); callback(null, 'Finished'); };
  8. 选择部署

步骤 3:创建规则

创建一条规则,在停止 Amazon EC2 实例时运行您在步骤 2 中创建的 Lambda 函数。

创建 规则
  1. 打开亚马逊 EventBridge 控制台,网址为 https://console.aws.amazon.com/events/

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

  3. 选择创建规则

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

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

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

  7. 选择下一步

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

  9. 对于 Event pattern(事件模式),执行以下操作:

    1. 对于事件源,请从下拉列表中选择 EC2

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

    3. 选择特定操作并输入 StopInstances

  10. 选择 Next(下一步)

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

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

  13. 函数中,选择您在步骤 1:创建 Lambda 函数部分创建的 Lambda 函数。在此示例中,选择 LogEC2StopInstance

  14. 选择下一步

  15. 选择下一步

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

步骤 4:测试规则

可以使用 Amazon EC2 控制台停止 Amazon EC2 实例来测试您的规则。等待几分钟让实例停止,然后在 CloudWatch控制台上检查您的 Amazon Lambda 指标以验证您的函数是否已运行。

通过停止一个实例来测试您的规则
  1. 通过以下网址打开 Amazon EC2 控制台:https://console.aws.amazon.com/ec2/

  2. 启动一个实例。有关更多信息,请参阅 Amazon EC2 用户指南中的启动您的实例

  3. 停止实例。有关更多信息,请参阅 Amazon EC2 用户指南中的停止和启动您的实例

  4. 要查看 Lambda 函数的输出,请执行以下操作:

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

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

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

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

  5. (可选)当您完成后,终止已停止的实例。有关更多信息,请参阅 Amazon EC2 用户指南中的终止您的实例

步骤 5:确认成功

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

步骤 6:清除资源

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

要删除 EventBridge 规则
  1. 打开 EventBridge 控制台的 “规则” 页面

  2. 选择您创建的规则。

  3. 选择 Delete

  4. 选择 Delete

删除 Lambda 函数
  1. 打开 Lamba 控制台的函数页面

  2. 选择您创建的函数。

  3. 依次选择 ActionsDelete

  4. 选择 Delete(删除)。

要删除 CloudTrail 跟踪
  1. 打开 CloudTrail 控制台的 T rails 页面

  2. 选择您创建的跟踪。

  3. 选择 Delete

  4. 选择 删除