翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Step Functions ワークフローのステートマシンバージョン
*バージョン*とは、ステートマシンの番号が付けられた**変更不可能な**スナップショットです。そのステートマシンに作成された最新リビジョンのバージョンを公開します。各バージョンには、ステートマシン ARN とコロン (:) で区切られたバージョン番号を組み合わせた一意の Amazon リソースネーム (ARN) があります。次の例は、ステートマシンのバージョン ARN の形式を示しています。
```
arn:{{partition}}:states:{{region}}:{{account-id}}:stateMachine:{{myStateMachine}}:1
```
ステートマシンのバージョンの使用を開始するには、最初のバージョンを公開する必要があります。バージョンを公開した後は、バージョン ARN を使用して [StartExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartExecution.html) API アクションを呼び出すことができます。バージョンを編集することはできませんが、ステートマシンを更新して新しいバージョンを公開することができます。ステートマシンの複数のバージョンを公開することもできます。
ステートマシンの新しいバージョンを公開すると、Step Functions によってバージョン番号が割り当てられます。バージョン番号は 1 から始まり、新しいバージョンごとに単純に増えていきます。バージョン番号は特定のステートマシンでは再利用されません。ステートマシンのバージョン 10 を削除して新しいバージョンを公開する場合、Step Functions はそれをバージョン 11 として公開します。
以下のプロパティはステートマシンのすべてのバージョンで同じになります。
+ ステートマシンのすべてのバージョンは同じタイプ [(標準または Express)](choosing-workflow-type.md) を共有します。
+ ステートマシンの名前または作成日をバージョン間で変更することはできません。
+ タグはステートマシンにグローバルに適用されます。[TagResource](https://docs.aws.amazon.com/step-functions/latest/apireference/API_TagResource.html) と [UntagResource](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UntagResource.html) の API アクションを使用して、ステートマシンのタグを管理できます。
ステートマシンには各バージョンと [revision](concepts-cd-aliasing-versioning.md#statemachinerev) に含まれるプロパティも含まれますが、これらのプロパティは 2 つのバージョンまたはリビジョンによって異なる場合があります。これらのプロパティには、[ステートマシン定義](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html#StepFunctions-UpdateStateMachine-request-definition)、[IAM ロール](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html#StepFunctions-UpdateStateMachine-request-roleArn)、[トレーシング設定](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html#StepFunctions-UpdateStateMachine-request-tracingConfiguration)、[ログ記録設定](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html#StepFunctions-UpdateStateMachine-request-loggingConfiguration)が含まれます。
## ステートマシンのバージョンの公開 (コンソール)
ステートマシンのバージョンは最大 1000 個公開できます。このソフトリミットの引き上げをリクエストするには、[AWS マネジメントコンソール](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html) の **[サポートセンター]** ページを使用してください。未使用のバージョンはコンソールから手動で削除するか、[DeleteStateMachineVersion](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteStateMachineVersion.html) API アクションを呼び出して削除できます。
**ステートマシンのバージョンを公開するには**
1. [Step Functions コンソール](https://console.aws.amazon.com/states/home?region=us-east-1#/)を開き、既存のステートマシンを選択します。
1. **[ステートマシンの詳細]** ページで、**[編集]** を選択します。
1. 必要に応じてステートマシン定義を編集し、**[保存]** を選択します。
1. [**Publish version**] を選択します。
1. (オプション) 表示されたダイアログボックスの **[説明]** フィールドに、ステートマシンのバージョンに関する簡単な説明を入力します。
1. **[公開]** を選択します。
**注記**
ステートマシンの新しいバージョンを公開すると、Step Functions によってバージョン番号が割り当てられます。バージョン番号は 1 から始まり、新しいバージョンごとに単純に増えていきます。バージョン番号は特定のステートマシンでは再利用されません。ステートマシンのバージョン 10 を削除して新しいバージョンを公開する場合、Step Functions はそれをバージョン 11 として公開します。
## Step Functions API 操作によるバージョンの管理
Step Functions には、ステートマシンのバージョンを公開および管理するための次の API オペレーションが用意されています。
+ [PublishStateMachineVersion](https://docs.aws.amazon.com/step-functions/latest/apireference/API_PublishStateMachineVersion.html) - ステートマシンの現在の [revision](concepts-cd-aliasing-versioning.md#statemachinerev) からバージョンを公開します。
+ [UpdateStateMachine](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html) - 同じリクエストでステートマシンを更新して `publish` パラメータを `true` に設定した場合、新しいステートマシンバージョンが公開されます。
+ [CreateStateMachine](https://docs.aws.amazon.com/step-functions/latest/apireference/API_CreateStateMachine.html) - `publish` パラメータを `true` に設定した場合、ステートマシンの最初のリビジョンが公開されます。
+ [ListStateMachineVersions](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListStateMachineVersions.html) - 指定されたステートマシン ARN のバージョンを一覧表示します。
+ [DescribeStateMachine](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeStateMachine.html) - `stateMachineArn` で指定されているバージョン ARN のステートマシンバージョン詳細を返します。
+ [DeleteStateMachineVersion](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteStateMachineVersion.html) - ステートマシンのバージョンを削除します。
`{{myStateMachine}}` を使用して と呼ばれるステートマシンの現在のリビジョンから新しいバージョンを発行するには AWS Command Line Interface、 `publish-state-machine-version` コマンドを使用します。
```
aws stepfunctions publish-state-machine-version --state-machine-arn arn:aws:states:{{region}}:{{account-id}}:stateMachine:{{myStateMachine}}
```
レスポンスは `stateMachineVersionArn` を返します。例えば、前のコマンドは `arn:aws:states:{{region}}:{{account-id}}:stateMachine:{{myStateMachine}}:1` のレスポンスを返します。
**注記**
ステートマシンの新しいバージョンを公開すると、Step Functions によってバージョン番号が割り当てられます。バージョン番号は 1 から始まり、新しいバージョンごとに単純に増えていきます。バージョン番号は特定のステートマシンでは再利用されません。ステートマシンのバージョン 10 を削除して新しいバージョンを公開する場合、Step Functions はそれをバージョン 11 として公開します。
## コンソールからのステートマシンバージョンの実行
ステートマシンバージョンの使用を開始するには、まず現在のステートマシン [revision](concepts-cd-aliasing-versioning.md#statemachinerev) からバージョンを公開する必要があります。バージョンを公開するには、Step Functions コンソールを使用するか、[PublishStateMachineVersion](https://docs.aws.amazon.com/step-functions/latest/apireference/API_PublishStateMachineVersion.html) API アクションを呼び出します。`publish` というオプションパラメータを使用して [UpdateStateMachineAlias](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachineAlias.html) API アクションを呼び出し、ステートマシンを更新してそのバージョンを公開することもできます。
コンソールを使用するか、[StartExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartExecution.html) API アクションを呼び出してバージョン ARN を指定することにより、バージョンの実行を開始できます。[エイリアス](concepts-state-machine-alias.md)を使用してバージョンの実行を開始することもできます。エイリアスは[ルーティング設定](concepts-state-machine-alias.md#alias-routing-config)に基づいて、トラフィックを特定のバージョンにルーティングします。
バージョンを使用せずにステートマシンの実行を開始すると、Step Functions はステートマシンの最新リビジョンを使用して実行します。Step Functions が実行をバージョンに関連付ける方法については、「[バージョンまたはエイリアスへの実行の関連付け](execution-alias-version-associate.md)」を参照してください。
**ステートマシンバージョンを使用して実行を開始するには**
1. [Step Functions コンソール](https://console.aws.amazon.com/states/home?region=us-east-1#/)を開き、1 つ以上のバージョンを公開している既存のステートマシンを選択します。バージョンを公開する方法については、「[ステートマシンのバージョンの公開 (コンソール)](#procedure-create-versions)」を参照してください。
1. **[ステートマシンの詳細]**」ページで **[バージョン]** タブを選択します。
1. **[バージョン]** セクションで、次の操作を行います。
1. 実行の開始に使用するバージョンを選択します。
1. **[実行のスタート]** を選択します。
1. (オプション) **[実行を開始]** ダイアログボックスで、実行の名前を入力します。
1. (オプション) 必要に応じて実行の入力を指定し、**[実行を開始]** を選択します。