本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
将自定义事件发送到EventBridge
此示例项目演示了如何使用 Step Functions 将自定义事件发送到与具有多个目标的规则匹配的事件总线(亚马逊)EventBridge、Amazon Lambda、Amazon Simple Notify Service、Amazon Simple Queue Service)。此示例项目创建以下内容:
-
Amazon EventBridge
-
一个 Amazon SNS 主题
-
Amazon SQS 队列
-
Lambda 函数
-
相关Amazon Identity and Access Management(IAM) 角色
有关 Step Functions 和 Step Functions 服务集成的更多信息,请参阅以下内容:
此示例项目可能会产生费用。
为新 Amazon 用户提供了免费使用套餐。在此套餐中,低于某种使用水平的服务是免费的。有关 Amazon 成本和免费套餐的更多信息,请参阅 EventBridge 定价
创建状态机并预置资源
-
打开Step Functions 控制
然后选择创建状态机. -
选择运行示例项目,然后选择将自定义事件发送到EventBridge.
此时将显示状态机 Code (代码) 和 Visual Workflow (可视工作流程)。
-
请选择 Next (下一步)。
此时将显示 Deploy resources (部署资源) 页面,其中列出了将创建的资源。对于本示例项目,资源包括:
-
Amazon Step Functions 状态机
-
EventBridge 事件总线
-
一个 EventBridge 规则
-
一个 Amazon SNS 主题
-
Amazon SQS 队列
-
Lambda 函数
-
相关 IAM 角色
-
-
选择 Deploy Resources (部署资源)。
注意 创建这些资源和相关 IAM 权限可能需要长达 25 分钟的时间。当显示 Deploy resources (部署资源) 页面时,您可打开 Stack ID (堆栈 ID) 链接以查看正在预置的资源。
启动新的执行
-
在存储库的状态机页面上,选择EventBridgeStateMachine示例项目创建的状态机,然后选择启动执行.
-
在 New execution 页面上,输入执行名称 (可选),然后选择 Start Execution (开始执行)。
(可选)要识别您的执行,您可以在名称。默认情况下,Step Functions 会自动生成唯一的执行名称。
注意 Step Functions 允许您创建包含非 ASCII 字符的状态机、执行和活动名称。这些非 ASCII 名称不适用于亚马逊CloudWatch. 为了确保你可以跟踪CloudWatch指标,请选择仅使用 ASCII 字符的名称。
-
(可选)转到 Step Functions 上新创建的状态机控制面板,然后选择新的执行.
-
执行完成后,您可以在 Visual workflow (可视工作流) 上选择状态,并浏览 Step details (步骤详细信息) 下的 Input (输入) 和 Output (输出)。
示例状态机代码
此示例项目中的状态机与EventBridge通过将自定义事件发送到EventBridge事件总线。发送到活动总线的活动与EventBridge此规则触发将消息发送到 Amazon SNS 主题和 Amazon SQS 队列的 Lambda 函数。
浏览此示例状态机以了解 Step Functions 如何管理EventBridge.
有关 Amazon Step Functions 如何控制其他 Amazon 服务的更多信息,请参阅将 Amazon Step Functions 与其他服务一起使用。
{
"Comment": "An example of the Amazon States Language for sending a custom event to Amazon EventBridge",
"StartAt": "Send a custom event",
"States": {
"Send a custom event": {
"Resource": "arn:<PARTITION>:states:::events:putEvents",
"Type": "Task",
"Parameters": {
"Entries": [{
"Detail": {
"Message": "Hello from Step Functions!"
},
"DetailType": "MessageFromStepFunctions",
"EventBusName": "<EVENT_BUS_NAME>",
"Source": "my.statemachine"
}]
},
"End": true
}
}
}
有关在将 Step Functions 与其他一起使用时如何配置 IAM 的信息Amazon服务,请参阅集成服务的 IAM 政策.
示例 IAM
这些示例Amazon Identity and Access Management(IAM) 策略包括执行状态机和相关资源所需的最小权限。我们建议您在 IAM 策略中仅包含这些必需的权限。
{
"Version": "2012-10-17",
"Statement": [
{
"Action": [
"events:PutEvents"
],
"Resource": [
"arn:aws:events:us-east-1:1234567890:event-bus/stepfunctions-sampleproject-eventbus"
],
"Effect": "Allow"
}
]
}
有关在将 Step Functions 与其他一起使用时如何配置 IAM 的信息Amazon服务,请参阅集成服务的 IAM 政策.