翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Step Functions ワークフローのステートマシンバージョン
バージョンとは、ステートマシンの番号が付けられた変更不可能なスナップショットです。そのステートマシンに作成された最新リビジョンのバージョンを公開します。各バージョンには一意の Amazon リソースネーム () がありますARN。これは、ステートマシンARNとコロン (:) で区切られたバージョン番号の組み合わせARNです。次の例は、ステートマシンバージョン の形式を示していますARN。
arn:partition
:states:region
:account-id
:stateMachine:myStateMachine
:1
ステートマシンのバージョンの使用を開始するには、最初のバージョンを公開する必要があります。バージョンを公開したら、バージョン を使用して StartExecutionAPIアクションを呼び出すことができますARN。バージョンを編集することはできませんが、ステートマシンを更新して新しいバージョンを公開することができます。ステートマシンの複数のバージョンを公開することもできます。
![バージョンがステートマシンのイミュータブルなスナップショットであることを示すあいまいな説明図。](images/versioning-concept.png)
ステートマシンの新しいバージョンを公開すると、Step Functions によってバージョン番号が割り当てられます。バージョン番号は 1 から始まり、新しいバージョンごとに単純に増えていきます。バージョン番号は特定のステートマシンでは再利用されません。ステートマシンのバージョン 10 を削除して新しいバージョンを公開する場合、Step Functions はそれをバージョン 11 として公開します。
以下のプロパティはステートマシンのすべてのバージョンで同じになります。
-
ステートマシンのすべてのバージョンは同じタイプ (標準または Express) を共有します。
-
ステートマシンの名前または作成日をバージョン間で変更することはできません。
-
タグはステートマシンにグローバルに適用されます。ステートマシンのタグは、 TagResourceおよび UntagResourceAPIアクションを使用して管理できます。
ステートマシンには各バージョンと revision に含まれるプロパティも含まれますが、これらのプロパティは 2 つのバージョンまたはリビジョンによって異なる場合があります。これらのプロパティには、ステートマシン定義 、IAMロール 、トレース設定 、ログ記録設定 が含まれます。
ステートマシンのバージョンの公開 (コンソール)
ステートマシンのバージョンは最大 1000 個公開できます。このソフトリミットの引き上げをリクエストするには、AWS Management Console の [サポートセンター] ページを使用してください。コンソールから、または DeleteStateMachineVersionAPIアクションを呼び出すことで、未使用のバージョンを手動で削除できます。
ステートマシンのバージョンを公開するには
-
Step Functions コンソール
を開き、既存のステートマシンを選択します。 -
[ステートマシンの詳細] ページで、[編集] を選択します。
-
必要に応じてステートマシン定義を編集し、[保存] を選択します。
-
[Publish version] を選択します。
-
(オプション) 表示されたダイアログボックスの[説明] フィールドに、ステートマシンのバージョンに関する簡単な説明を入力します。
-
[発行] を選択します。
注記
ステートマシンの新しいバージョンを公開すると、Step Functions によってバージョン番号が割り当てられます。バージョン番号は 1 から始まり、新しいバージョンごとに単純に増えていきます。バージョン番号は特定のステートマシンでは再利用されません。ステートマシンのバージョン 10 を削除して新しいバージョンを公開する場合、Step Functions はそれをバージョン 11 として公開します。
Step Functions APIオペレーションによるバージョンの管理
Step Functions には、ステートマシンのバージョンを公開および管理するための以下のAPIオペレーションが用意されています。
-
PublishStateMachineVersion – ステートマシンrevisionの現在の からバージョンを公開します。
-
UpdateStateMachine – ステートマシンを更新し、同じリクエスト
true
でpublish
パラメータを に設定すると、新しいステートマシンバージョンを公開します。 -
CreateStateMachine –
publish
パラメータを に設定した場合、ステートマシンの最初のリビジョンを公開しますtrue
。 -
ListStateMachineVersions – 指定されたステートマシン のバージョンを一覧表示しますARN。
-
DescribeStateMachine – でARN指定されたバージョンのステートマシンのバージョンの詳細を返します
stateMachineArn
。 -
DeleteStateMachineVersion – ステートマシンのバージョンを削除します。
を使用して というステートマシンの現在のリビジョンから新しいバージョンを発行するには AWS Command Line Interface、 myStateMachine
publish-state-machine-version
コマンドを使用します。
aws stepfunctions publish-state-machine-version --state-machine-arn arn:aws:states:us-east-1:
123456789012
:stateMachine:myStateMachine
レスポンスは stateMachineVersionArn
を返します。例えば、前のコマンドは arn:aws:states:us-east-1:
のレスポンスを返します。123456789012
:stateMachine:myStateMachine
:1
注記
ステートマシンの新しいバージョンを公開すると、Step Functions によってバージョン番号が割り当てられます。バージョン番号は 1 から始まり、新しいバージョンごとに単純に増えていきます。バージョン番号は特定のステートマシンでは再利用されません。ステートマシンのバージョン 10 を削除して新しいバージョンを公開する場合、Step Functions はそれをバージョン 11 として公開します。
コンソールからのステートマシンバージョンの実行
ステートマシンバージョンの使用を開始するには、まず現在のステートマシン revision からバージョンを公開する必要があります。バージョンを公開するには、Step Functions コンソールを使用するか、 PublishStateMachineVersionAPIアクションを呼び出します。また、 という名前のオプションパラメータを使用して UpdateStateMachineAliasAPIアクションを呼び出しpublish
、ステートマシンを更新し、そのバージョンを公開することもできます。
バージョンの実行を開始するには、コンソールを使用するか、 StartExecutionAPIアクションを呼び出してバージョン を指定しますARN。エイリアスを使用してバージョンの実行を開始することもできます。エイリアスはルーティング設定に基づいて、トラフィックを特定のバージョンにルーティングします。
バージョンを使用せずにステートマシンの実行を開始すると、Step Functions はステートマシンの最新リビジョンを使用して実行します。Step Functions が実行をバージョンに関連付ける方法については、「バージョンまたはエイリアスへの実行の関連付け」を参照してください。
ステートマシンバージョンを使用して実行を開始するには
-
Step Functions コンソール
を開き、1 つ以上のバージョンを公開している既存のステートマシンを選択します。バージョンを公開する方法については、「ステートマシンのバージョンの公開 (コンソール)」を参照してください。 -
[ステートマシンの詳細]」ページで [バージョン] タブを選択します。
-
[バージョン] セクションで、次の操作を行います。
-
実行の開始に使用するバージョンを選択します。
-
[実行のスタート] を選択します。
-
-
(オプション) [実行を開始] ダイアログボックスで、実行の名前を入力します。
-
(オプション) 必要に応じて実行の入力を指定し、[実行を開始] を選択します。