使用 Step Functions 状态机处理错误情形

登录到 IAM 控制台，然后依次选择角色、创建角色。

在选择受信任实体的类型页面上的 AWS 服务下，从列表中选择 Lambda，然后选择下一步: 权限。

在附加权限策略页面上，选择下一步: 审核。

在审核页面上，为角色名称 输入 MyLambdaRole，然后选择创建角色。

通过以下网址打开 AWS Lambda 控制台：https://console.amazonaws.cn/lambda/。

选择 Create a function。

在蓝图部分的筛选条件中输入 step-functions，然后选择 step-functions-error 蓝图。

在基本信息部分中，配置您的 Lambda 函数：

1. 对于名称，输入 FailFunction。

2. 对于 Role，选择 Choose an existing role。

3. 对于现有角色，选择您之前创建的 Lambda 角色。

   注意

   如果您创建的 IAM 角色未显示在列表中，该角色可能仍需要几分钟才能传播到 Lambda。

以下代码显示在 Lambda 函数代码窗格中。

'use strict';

exports.handler = (event, context, callback) => {
    function CustomError(message) {
        this.name = 'CustomError';
        this.message = message;
    }
    CustomError.prototype = new Error();

    const error = new CustomError('This is a custom error!');
    callback(error);
};

context 对象返回错误消息 This is a custom error!。

选择 Create function。

创建 Lambda 函数后，记下函数位于页面右上角的 Amazon 资源名称 (ARN)，如以下示例所示。

arn:aws-cn:lambda:us-east-1:123456789012:function:FailFunction

在 FailFunction 页面上，选择 Test。

在配置测试事件对话框中，为事件名称输入 FailFunction，然后选择创建。

在 FailFunction 页面上，对您的 Lambda 函数进行测试。

测试结果 (模拟错误) 显示在页面底部。

打开 Step Functions 控制台，然后选择 Create state machine (创建状态机)。

在 Create a state machine (创建状态机) 页面上，选择 Templates (模板)，然后选择 Catch failure (捕捉失败)。

在 Type (类型) 下，选择 Standard (标准)。为状态机输入一个 Name (名称)，例如 Catchfailure。

在 Code (代码) 窗格中，将您之前创建的 Lambda 函数的 ARN 添加到 Resource 字段，如以下示例所示。

{
   "Comment": "A Catch example of the Amazon States Language using an AWS Lambda function",
   "StartAt": "CreateAccount",
   "States": {
      "CreateAccount": {
         "Type": "Task",
         "Resource": "arn:aws-cn:lambda:us-east-1:123456789012:function:FailFunction",
         "Catch": [ {
            "ErrorEquals": ["CustomError"],
            "Next": "CustomErrorFallback"
         }, {
            "ErrorEquals": ["States.TaskFailed"],
            "Next": "ReservedTypeFallback"
         }, {
            "ErrorEquals": ["States.ALL"],
            "Next": "CatchAllFallback"
         } ],
         "End": true
      },
      "CustomErrorFallback": {
         "Type": "Pass",
         "Result": "This is a fallback from a custom Lambda function exception",
         "End": true
      },
      "ReservedTypeFallback": {
         "Type": "Pass",
         "Result": "This is a fallback from a reserved error code",
         "End": true
      },
      "CatchAllFallback": {
         "Type": "Pass",
         "Result": "This is a fallback from any error code",
         "End": true
      }
   }
}

这是使用 Amazon 状态语言的状态机的说明。它定义了名为 CreateAccount 的单个 Task 状态。有关更多信息，请参阅状态机结构。

有关 Retry 字段的语法的更多信息，请参阅使用 Retry 和使用 Catch 的示例。

使用 Visual Workflow (可视工作流) 窗格中的图表检查您的 Amazon 状态语言 代码是否正确描述了状态机。

如果您未看到该图表，请在 Visual Workflow (可视工作流) 窗格中选择 。

选择 Next。

创建或输入 IAM 角色：

选择 Create state machine (创建状态机)。

在 CatchStateMachine 页面上，选择 New execution。

此时将显示 New execution 页面。

（可选）为帮助您标识执行，您可以在 Enter an execution name (输入执行名称) 框中为执行指定一个 ID。如果未输入 ID，Step Functions 将自动生成一个唯一 ID。

选择 Start Execution (开始执行)。

此时将启动新的状态机执行，并显示一个说明正在运行的执行的新页面。

要查看工作流程的输出，请在 Execution Details (执行详细信息) 部分展开 Output (输出) 部分。

要查看您的自定义错误消息，请选择 Visual workflow (可视工作流程) 中的 CreateAccount，并展开 Output (输出) 部分。