バージョンまたはエイリアスへのステートマシン実行の関連付け - AWS Step Functions
特定のバージョンまたはエイリアスで開始された実行の表示

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

バージョンまたはエイリアスへのステートマシン実行の関連付け

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

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

  • 修飾 ARN - バージョン番号またはエイリアス名が末尾に付加されたステートマシン ARN を指します。

    修飾 ARN の以下の例は、myStateMachine というステートマシンのバージョン 3 を表しています。

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

    修飾 ARN の以下の例は、myStateMachine というステートマシンの PROD というエイリアスを表しています。

    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 は実行をそのエイリアスとエイリアスが指すバージョンに関連付けます。1 つの実行は、1 つのエイリアスにのみ関連付けることができます。

注記

修飾 ARN を使用して実行を開始した場合、そのバージョンが同じステートマシン revision を使用していても、Step Functions はその実行をバージョンに関連付けません。例えば、バージョン 3 が最新リビジョンを使用しているが非修飾 ARN で実行を開始した場合、Step Functions はその実行をバージョン 3 に関連付けません。

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

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

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

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

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

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

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

  1. Step Functions コンソールを開き、バージョンを公開したかエイリアスを作成した既存のステートマシンを選択します。この例は、特定のステートマシンバージョンで開始された実行を表示する方法を示しています。

  2. [バージョン] タブを選択し、[バージョン] リストからバージョンを選択します。

    ヒント

    プロパティまたは値ボックスでフィルタリングして、特定のバージョンを検索します。

  3. [バージョンの詳細] ページには、選択したバージョンで開始された進行中および過去のステートマシン実行のリストが表示されます。

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

バージョン 4 によって開始された 3 つの実行のリストを表示する [バージョンの詳細] コンソールページ。これらの実行のうちの 2 つは、バージョン 4 で開始されたものです。3 回目の実行は、PROD というエイリアスによって開始されました。このエイリアスは実行トラフィックをバージョン 4 にルーティングしました。

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

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

  • ExecutionTime

  • ExecutionsAborted

  • ExecutionsFailed

  • ExecutionsStarted

  • ExecutionsSucceeded

  • ExecutionsTimedOut

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

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

  • 非修飾 ARN とバージョンの 2 つのメトリクス。

  • StateMachineArn と Alias のディメンションを含むメトリクス。