本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
教程:使用 EventBridge 安排 Amazon Lambda 函数
您可以设置规则,按计划运行 Amazon Lambda 函数。本教程演示如何使用 Amazon Web Services Management Console 或 Amazon CLI 创建规则。如果要使用 Amazon CLI 但尚未安装,请参阅安装、更新和卸载 Amazon CLI 版本 2。
对于计划,EventBridge 不在计划表达式中提供第二级精度。使用 cron 表达式的最高解析精度是一分钟。由于 EventBridge 和目标服务的分布式特性,触发计划规则的时间与目标服务运行目标资源的时间之间,有几秒钟的延迟。
步骤 1:创建 Lambda 函数
创建 Lambda 函数来记录计划的事件。
创建 Lambda 函数
打开 Amazon Lambda 控制台,地址:https://console.aws.amazon.com/lambda/
。 -
选择创建函数。
-
选择 Author from scratch (从头开始创作)。
-
输入 Lambda 函数的名称和说明。例如,将函数命名为
LogScheduledEvent
。 -
将其余选项保留为默认值,然后选择创建函数。
-
在函数页面的代码选项卡上,双击 index.js。
-
使用以下代码替换现有代码。
'use strict'; exports.handler = (event, context, callback) => { console.log('LogScheduledEvent'); console.log('Received event:', JSON.stringify(event, null, 2)); callback(null, 'Finished'); };
-
选择 Deploy (部署)。
步骤 2:创建规则
创建规则,按计划运行在步骤 1 中创建的 Lambda 函数。
您可以使用控制台或 Amazon CLI 来创建规则。要使用 Amazon CLI,您首先要向该规则授予调用 Lambda 函数的权限。然后,您可以创建规则并将该 Lambda 函数添加为目标。
创建规则(控制台)
打开位于 https://console.aws.amazon.com/events/
的 Amazon EventBridge 控制台。 -
在导航窗格中,选择 Rules (规则)。
-
选择 Create rule (创建规则)。
-
为规则输入名称和描述。
规则不能与同一区域中的另一个规则和同一事件总线上的名称相同。
-
对于 Event bus(事件总线),请选择要与此规则关联的事件总线。如果您希望此规则对来自您自己的账户的匹配事件触发,请选择 Amazon 原定设置事件总线。当您账户中的某个 Amazon 服务发出一个事件时,它始终会发送到您账户的默认事件总线。
-
对于 Rule type(规则类型),选择 Schedule(计划)。
-
选择 Next(下一步)。
-
在计划模式中,选择以固定频率运行的计划,例如每 10 分钟运行一次,然后输入
5
并从下拉列表中选择分钟。 -
选择 Next(下一步)。
-
对于 Target types(目标类型),选择 Amazon service(服务)。
-
对于选择目标,从下拉列表中选择 Lambda 函数。
-
在函数中,选择您在步骤 1:创建 Lambda 函数部分创建的 Lambda 函数。在此示例中,选择
LogScheduledEvent
。 -
选择 Next(下一步)。
-
选择 Next(下一步)。
-
查看规则详细信息并选择 Create rule(创建规则)。
创建规则 (Amazon CLI)
-
要创建按计划运行的规则,请使用
put-rule
命令。aws events put-rule \ --name
my-scheduled-rule
\ --schedule-expression 'rate(5 minutes)'此规则运行时,会创建一个事件,然后将其发送到目标。以下是示例事件。
{ "version": "0", "id": "53dc4d37-cffa-4f76-80c9-8b7d4a4d2eaa", "detail-type": "Scheduled Event", "source": "aws.events", "account": "123456789012", "time": "2015-10-08T16:53:06Z", "region": "us-east-1", "resources": [ "arn:aws:events:us-east-1:123456789012:rule/my-scheduled-rule" ], "detail": {} }
-
要授予 EventBridge 服务主体 (
events.amazonaws.com
) 权限以运行规则,请使用add-permission
命令。aws lambda add-permission \ --function-name
LogScheduledEvent
\ --statement-idmy-scheduled-event
\ --action 'lambda:InvokeFunction' \ --principal events.amazonaws.com \ --source-arn arn:aws:events:us-east-1
:123456789012
:rule/my-scheduled-rule
-
创建文件
targets.json
并输入以下内容。[ { "Id": "1", "Arn": "arn:aws:lambda:
us-east-1
:123456789012
:function:LogScheduledEvent
" } ] -
要将您在步骤 1 中创建的 Lambda 函数添加到规则中,请使用
put-targets
命令。aws events put-targets --rule
my-scheduled-rule
--targets file://targets.json
步骤 3:验证规则
完成步骤 2 后至少等待五分钟,然后您可以验证是否已调用 Lambda 函数。
查看 Lambda 函数的输出
通过以下网址打开 CloudWatch 控制台:https://console.aws.amazon.com/cloudwatch/
。 -
在导航窗格中,选择日志。
-
选择您的 Lambda 函数 (
/aws/lambda/
) 的日志组的名称。function-name
-
选择日志流的名称,以查看您启动的实例的函数提供的数据。
步骤 4:确认成功
如果您在 CloudWatch 日志中看到 Lambda 事件,说明您已成功完成本教程。如果您的 CloudWatch 日志中没有该事件,请开始故障排除,首先验证规则是否成功创建,如果规则看起来正确,再验证 Lambda 函数的代码是否正确。
步骤 5:清理资源
除非您想要保留为本教程创建的资源,否则可立即将其删除。请删除您不再使用的 Amazon 资源,这样可防止您的 Amazon 账户产生不必要的费用。
删除 EventBridge 规则
-
在 EventBridge 控制台中打开规则页面
。 -
选择您创建的规则。
-
选择 Delete。
-
选择 Delete。
删除 Lambda 函数
-
打开 Lamba 控制台的函数页面
。 -
选择您创建的函数。
-
依次选择 Actions 和 Delete。
-
选择 Delete。