Step Functions が実行をバージョンまたはエイリアスに関連付ける方法

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Step Functions は、StartExecution API アクションの呼び出しに使用する Amazon リソースネーム (ARN) に基づいて、実行をバージョンまたはエイリアスに関連付けます。Step Functions は、実行開始時にこのアクションを実行します。

修飾 ARN または非修飾 ARN を使用して、ステートマシンの実行を開始できます。

例えば、修飾 ARN がバージョン 3 を参照している場合、Step Functions は実行をこのバージョンに関連付けます。実行は、バージョン 3 を指すエイリアスには関連付けられません。

修飾 ARN がエイリアスを参照している場合、Step Functions は実行をそのエイリアスとエイリアスが指すバージョンに関連付けます。1 つの実行は、1 つのエイリアスにのみ関連付けることができます。

特定のバージョンまたはエイリアスで開始された実行の表示

Step Functions では、バージョンまたはエイリアスで開始された実行を以下の方法で表示できます。

API アクションの使用

DescribeExecution と ListExecutions の API アクションを呼び出すことにより、バージョンまたはエイリアスに関連付けられているすべての実行を表示できます。これらの API アクションは、実行を開始するために使用されたバージョンまたはエイリアスの ARN を返します。これらのアクションは、実行のステータスや ARN など、その他の詳細も返します。

ステートマシンのエイリアス ARN またはバージョン ARN を指定して、特定のエイリアスまたはバージョンに関連する実行を一覧表示することもできます。

ListExecutions API アクションの、以下のレスポンス例は、ステートマシンの実行を開始するために使用される myFirstExecution という名前のエイリアスの ARN を示しています。

次のコードスニペットの斜体で示されているテキストは、リソース固有の情報を表しています。

{
    "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 コンソールから、バージョンまたはエイリアスによって開始された実行を確認することもできます。以下の手順は、特定のバージョンで開始された実行を表示する方法を示しています。

以下のイメージは、[バージョンの詳細] コンソールページを示しています。このページには、MathAddDemo というステートマシンのバージョン 4 によって開始された実行が一覧表示されます。このリストには、PROD というエイリアスによって開始された実行も表示されます。このエイリアスは実行トラフィックをバージョン 4 にルーティングしました。

CloudWatch メトリクスの使用

Qualified ARN で開始するステートマシンの実行ごとに、Step Functions は、現在出力されているメトリクスと同じ名前と値を持つ追加のメトリクスを出力します。これらの追加メトリクスには、実行を開始するバージョン識別子とエイリアス名のそれぞれのディメンションが含まれます。これらのメトリクスを使用すると、ステートマシンの実行をバージョンレベルでモニタリングし、ロールバックシナリオがいつ必要になるかを判断できます。これらのメトリクスに基づいて Amazon CloudWatch アラームを作成することもできます。

Step Functions は、エイリアスまたはバージョンで開始した実行について、以下のメトリクスを出力します。

バージョン ARN で実行を開始した場合、Step Functions は、StateMachineArn を含むメトリクスと、Version ディメンションを含む 2 つ目のメトリクスを公開します。

エイリアス ARN を使用して実行を開始した場合、Step Functions は次のメトリクスを出力します。