翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Step Functions が実行をバージョンまたはエイリアスに関連付ける方法
Step Functions は、[StartExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartExecution.html) API アクションの呼び出しに使用する Amazon リソースネーム (ARN) に基づいて、実行をバージョンまたはエイリアスに関連付けます。Step Functions は、実行開始時にこのアクションを実行します。
修飾 ARN または非修飾 ARN を使用して、ステートマシンの実行を開始できます。
+ **修飾 ARN** - バージョン番号またはエイリアス名が末尾に付加されたステートマシン ARN を指します。
修飾 ARN の以下の例は、`myStateMachine` というステートマシンのバージョン `3` を表しています。
```
arn:aws:states:region:account-id:stateMachine:myStateMachine:3
```
修飾 ARN の以下の例は、`myStateMachine` というステートマシンの `PROD` というエイリアスを表しています。
```
arn:aws:states:region:account-id:stateMachine:myStateMachine:PROD
```
+ **非修飾 ARN** - バージョン番号やエイリアス名が末尾に付加されていないステートマシン ARN を指します。
```
arn:aws:states:region:account-id:stateMachine:myStateMachine
```
例えば、修飾 ARN がバージョン `3` を参照している場合、Step Functions は実行をこのバージョンに関連付けます。実行は、バージョン `3` を指すエイリアスには関連付けられません。
修飾 ARN がエイリアスを参照している場合、Step Functions は実行をそのエイリアスとエイリアスが指すバージョンに関連付けます。1 つの実行は、1 つのエイリアスにのみ関連付けることができます。
**注記**
修飾 ARN を使用して実行を開始した場合、そのバージョンが同じステートマシン [revision](concepts-cd-aliasing-versioning.md#statemachinerev) を使用していても、Step Functions はその実行をバージョンに関連付けません。例えば、バージョン 3 が最新リビジョンを使用しているが非修飾 ARN で実行を開始した場合、Step Functions はその実行をバージョン 3 に関連付けません。
## 特定のバージョンまたはエイリアスで開始された実行の表示
Step Functions では、バージョンまたはエイリアスで開始された実行を以下の方法で表示できます。
### API アクションの使用
[DescribeExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeExecution.html) と [ListExecutions](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListExecutions.html) の API アクションを呼び出すことにより、バージョンまたはエイリアスに関連付けられているすべての実行を表示できます。これらの API アクションは、実行を開始するために使用されたバージョンまたはエイリアスの ARN を返します。これらのアクションは、実行のステータスや ARN など、その他の詳細も返します。
ステートマシンのエイリアス ARN またはバージョン ARN を指定して、特定のエイリアスまたはバージョンに関連する実行を一覧表示することもできます。
[ListExecutions](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListExecutions.html) API アクションの、以下のレスポンス例は、ステートマシンの実行を開始するために使用される *myFirstExecution* という名前のエイリアスの ARN を示しています。
次のコードスニペットの*斜体で示されている*テキストは、リソース固有の情報を表しています。
```
{
"executions": [
{
"executionArn": "arn:aws:states:region:account-id:execution:myStateMachine:myFirstExecution",
"stateMachineArn": "arn:aws:states:region:account-id:stateMachine:myStateMachine",
"stateMachineAliasArn": "arn:aws:states:region:account-id: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 コンソール](https://console.aws.amazon.com/states/home?region=us-east-1#/)から、バージョンまたはエイリアスによって開始された実行を確認することもできます。以下の手順は、特定のバージョンで開始された実行を表示する方法を示しています。
1. [Step Functions コンソール](https://console.aws.amazon.com/states/home?region=us-east-1#/)を開き、[バージョン](concepts-state-machine-version.md#procedure-create-versions)を公開したか[エイリアス](concepts-state-machine-alias.md#procedure-create-aliases)を作成した既存のステートマシンを選択します。この例は、特定のステートマシンバージョンで開始された実行を表示する方法を示しています。
1. **[バージョン]** タブを選択し、**[バージョン]** リストからバージョンを選択します。
**ヒント**
プロパティまたは値ボックスでフィルタリングして、特定のバージョンを検索します。
1. *[バージョンの詳細]* ページには、選択したバージョンで開始された進行中および過去のステートマシン実行のリストが表示されます。
以下のイメージは、*[バージョンの詳細]* コンソールページを示しています。このページには、`MathAddDemo` というステートマシンのバージョン *4* によって開始された実行が一覧表示されます。このリストには、`PROD` というエイリアスによって開始された実行も表示されます。このエイリアスは実行トラフィックをバージョン *4* にルーティングしました。
![\[ステートマシンバージョンの [詳細] コンソールページを示すスクリーンショットの例\]](http://docs.aws.amazon.com/ja_jp/step-functions/latest/dg/images/view-version-executions.png)
### CloudWatch メトリクスの使用
[Qualified ARN](#qualifiedARN) で開始するステートマシンの実行ごとに、Step Functions は、現在出力されているメトリクスと同じ名前と値を持つ追加のメトリクスを出力します。これらの追加メトリクスには、実行を開始するバージョン識別子とエイリアス名のそれぞれのディメンションが含まれます。これらのメトリクスを使用すると、ステートマシンの実行をバージョンレベルでモニタリングし、ロールバックシナリオがいつ必要になるかを判断できます。これらのメトリクスに基づいて [Amazon CloudWatch アラームを作成](procedure-cw-metrics.md#monitoring-using-cloudwatch-console-set-alarm)することもできます。
Step Functions は、エイリアスまたはバージョンで開始した実行について、以下のメトリクスを出力します。
+ `ExecutionTime`
+ `ExecutionsAborted`
+ `ExecutionsFailed`
+ `ExecutionsStarted`
+ `ExecutionsSucceeded`
+ `ExecutionsTimedOut `
バージョン ARN で実行を開始した場合、Step Functions は、`StateMachineArn` を含むメトリクスと、`Version` ディメンションを含む 2 つ目のメトリクスを公開します。
エイリアス ARN を使用して実行を開始した場合、Step Functions は次のメトリクスを出力します。
+ 非修飾 ARN とバージョンの 2 つのメトリクス。
+ `StateMachineArn` と `Alias` のディメンションを含むメトリクス。