• AWS Systems Manager CloudWatch ダッシュボードは、2026 年 4 月 30 日以降は利用できなくなります。お客様は、これまでと同様に Amazon CloudWatch コンソールを使用して、Amazon CloudWatch ダッシュボードの表示、作成、管理を継続できます。詳細については、「[Amazon CloudWatch ダッシュボードのドキュメント](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)」を参照してください。

# `aws:executeStateMachine` – AWS Step Functions ステートマシンを実行する
<a name="automation-action-executeStateMachine"></a>

AWS Step Functions ステートマシンを実行します。

**注記**  
`aws:executeStateMachine` アクションは、自動スロットリング再試行をサポートしています。詳細については、「[スロットリングされたオペレーションの自動再試行の設定](automation-throttling-retry.md)」を参照してください。

**Input** (入力)

このアクションでは、Step Functions [StartExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartExecution.html) API オペレーションのほとんどのパラメータがサポートされています。

**必要な AWS Identity and Access Management (IAM) アクセス許可**
+ `states:DescribeExecution`
+ `states:StartExecution`
+ `states:StopExecution`

------
#### [ YAML ]

```
name: executeTheStateMachine
action: aws:executeStateMachine
inputs:
  stateMachineArn: StateMachine_ARN
  input: '{"parameters":"values"}'
  name: name
```

------
#### [ JSON ]

```
{
    "name": "executeTheStateMachine",
    "action": "aws:executeStateMachine",
    "inputs": {
        "stateMachineArn": "StateMachine_ARN",
        "input": "{\"parameters\":\"values\"}",
        "name": "name"
    }
}
```

------

stateMachineArn  
Step Functions ステートマシンの Amazon Resource Name (ARN)。  
型: 文字列  
必須: はい

name  
実行の名前。  
型: 文字列  
必須: いいえ

input  
実行に必要な JSON 入力データを含む文字列。  
型: 文字列  
必須: いいえ

**アウトプット**  
このアクションでは、以下の出力が事前に定義されています。

executionArn  
実行の ARN。  
タイプ: 文字列

input  
実行の入力データ (JSON) を含む文字列。このデータ長は、ペイロードのサイズにより制約を受け、UTF-8 エンコーディングによりバイト数で表現されます。  
タイプ: 文字列

名前  
実行の名前。  
タイプ: 文字列

output  
実行の出力データ (JSON)。このデータ長は、ペイロードのサイズにより制約を受け、UTF-8 エンコーディングによりバイト数で表現されます。  
タイプ: 文字列

startDate  
実行が開始された日付。  
タイプ: 文字列

stateMachineArn  
実行されたステートマシンの ARN。  
タイプ: 文字列

ステータス  
実行に関する現在の状態。  
タイプ: 文字列

stopDate  
実行がすでに終了している場合の、その実行が停止した日付。  
タイプ: 文字列