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

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

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

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

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

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

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

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

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

CloudWatch メトリクスの使用

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

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

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

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