Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Step Functions
<a name="stepfunctions-rule-action"></a>

Die Aktion Step Functions (`stepFunctions`) startet eine AWS Step Functions Zustandsmaschine.

## Voraussetzungen
<a name="stepfunctions-rule-action-requirements"></a>

Diese Regelaktion hat die folgenden Anforderungen:
+ Eine IAM-Rolle, die die Ausführung des `states:StartExecution` Vorgangs übernehmen AWS IoT kann. Weitere Informationen finden Sie unter [Gewähren Sie einer AWS IoT Regel den Zugriff, den sie benötigt](iot-create-role.md).

  In der AWS IoT Konsole können Sie eine Rolle auswählen oder erstellen, um die Ausführung dieser Regelaktion AWS IoT zu ermöglichen.

## Parameters
<a name="stepfunctions-rule-action-parameters"></a>

Wenn Sie eine AWS IoT Regel mit dieser Aktion erstellen, müssen Sie die folgenden Informationen angeben:

`stateMachineName`  
Der Name des zu startenden Step Functions-Zustandsautomaten.  
Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): API und nur AWS CLI 

`executionNamePrefix`  
(Optional) Der Name, der der Ausführung des Zustandsautomaten gegeben wird, besteht aus diesem Präfix, gefolgt von einer UUID. Step Functions erstellt einen eindeutigen Namen für jede Zustandsautomaten-Ausführung, sofern keiner angegeben wird.  
Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Ja

`roleArn`  
Der ARN der Rolle, die die AWS IoT Erlaubnis zum Starten der Zustandsmaschine erteilt. Weitere Informationen finden Sie unter [Voraussetzungen](#stepfunctions-rule-action-requirements).  
Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Nein

## Beispiele
<a name="stepfunctions-rule-action-examples"></a>

Das folgende JSON-Beispiel definiert eine Step Functions Functions-Aktion in einer AWS IoT Regel.

```
{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'",
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "stepFunctions": {
                    "stateMachineName": "myStateMachine",
                    "executionNamePrefix": "myExecution",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_step_functions"
                }
            }
        ]
    }
}
```

## Weitere Informationen finden Sie auch unter
<a name="stepfunctions-rule-action-see-also"></a>
+ [Was ist AWS Step Functions?](https://docs.aws.amazon.com/step-functions/latest/dg/) im *AWS Step Functions Developer Guide*