Step Functions 如何将执行与版本或别名关联起来

Step Functions 根据您用来调用StartExecutionAPI操作的亚马逊资源名称 (ARN) 将执行与版本或别名关联起来。Step Functions 在执行开始时进行此操作。

您可以使用限定或不ARN合格的启动状态机执行。

• 限定 ARN — 指以版本号或别名为ARN后缀的状态机。

  以下限定ARN示例指的是名为3的状态机的版本myStateMachine。

  arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:3

  以下限定ARN示例指的是名为PROD的状态机的别名myStateMachine。

  arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:PROD

• 不合格 ARN — 指ARN没有版本号或别名后缀的状态机。

  arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine

例如，如果您的限定ARN指的是版本3，则 Step Functions 会将执行与该版本相关联。它不会将执行与任何指向版本 3 的别名相关联。

如果您的限定ARN指的是别名，则 Step Functions 会将执行与该别名以及该别名指向的版本相关联。一次执行只能与一个别名关联。

注意

如果您使用不合格的开始执行，即使版本使用相同的状态机 ARNrevision，Step Functions 也不会将该执行与版本相关联。例如，如果版本 3 使用最新修订版，但您以不合格的版本开始执行ARN，则 Step Functions 不会将该执行与版本 3 相关联。

查看使用版本或别名启动的执行

Step Functions 提供了以下方式，您可以通过这些方式查看使用版本或别名启动的执行：

使用API动作

您可以通过调用DescribeExecution和ListExecutionsAPI操作来查看与版本或别名关联的所有执行。这些API操作返回用于启动执行的版本或别名。ARN这些操作还会返回其他细节，包括状态和执行ARN情况。

您还可以提供状态机别名ARN或版本ARN来列出与特定别名或版本关联的执行。

以下ListExecutionsAPI操作的示例响应显示了用于启动名为ARN的状态机执行的别名 myFirstExecution.

这些区域有：italicized 以下代码片段中的文本表示特定于资源的信息。

{
    "executions": [
        {
            "executionArn": "arn:aws:states:us-east-1:123456789012:execution:myStateMachine:myFirstExecution",
            "stateMachineArn": "arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine",
            "stateMachineAliasArn": "arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:PROD",
            "name": "myFirstExecution",
            "status": "SUCCEEDED",
            "startDate": "2023-04-20T23:07:09.477000+00:00",
            "stopDate": "2023-04-20T23:07:09.732000+00:00"
        }
    ]
}

使用 Step Functions 控制台

您还可以从 Step Functions 控制台中查看由版本或别名启动的执行。以下步骤显示如何查看使用特定版本启动的执行：

1. 打开 Step Functions 控制台，然后选择一个已发布版本或创建别名的现有状态机。此示例说明如何查看使用特定状态机版本启动的执行。

2. 选择版本选项卡，然后从版本列表中选择一个版本。

   提示

   按属性或值框筛选，搜索特定版本。

3. 在版本详细信息页面上，您可以看到使用所选版本启动的所有正在进行和过去的状态机执行列表。

下图显示了版本详细信息 控制台页面。该页面列出了由名为 MathAddDemo 的状态机版本 4 启动的执行。此列表还显示由名为 PROD 的别名启动的执行。此别名将执行流量路由到版本 4。

使用 CloudWatch 指标

对于使用Qualified ARN 启动的每个状态机执行，Step Functions 都会发出与当前发出的指标具有相同名称和值的其他指标。这些其他指标包含启动执行时使用的每个版本标识符和别名的维度。利用这些指标，您可以监控版本级别的状态机执行，并确定何时可能需要回滚方案。您也可以根据这些指标创建 Amazon CloudWatch 警报。

Step Functions 会针对您使用别名或版本启动的执行发出以下指标：

• ExecutionTime

• ExecutionsAborted

• ExecutionsFailed

• ExecutionsStarted

• ExecutionsSucceeded

• ExecutionsTimedOut

如果您使用版本开始执行ARN，Step Functions 会发布带有StateMachineArnStateMachineArn和Version维度的第二个指标。

如果您使用别名开始执行ARN，Step Functions 会发出以下指标：

• 不合格版本ARN和版本的两个指标。

• 具有 StateMachineArn 和 Alias 维度的指标。