Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

La acción Step Functions (`stepFunctions`) inicia una máquina de AWS Step Functions estados.

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

Esta regla tiene los siguientes requisitos:
+ Una función de IAM que AWS IoT puede asumir para realizar la `states:StartExecution` operación. Para obtener más información, consulte [Otorgar a una AWS IoT regla el acceso que requiere](iot-create-role.md).

  En la AWS IoT consola, puede elegir o crear un rol que permita AWS IoT realizar esta acción de regla.

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

Al crear una AWS IoT regla con esta acción, debe especificar la siguiente información:

`stateMachineName`  
El nombre de la máquina de estado de Step Functions a iniciar.  
Admite [plantillas de sustitución](iot-substitution-templates.md): API y AWS CLI únicamente

`executionNamePrefix`  
(Opcional) El nombre dado a la ejecución de la máquina de estado consiste en este prefijo seguido de un UUID. Si no se facilita uno, Step Functions crea automáticamente un nombre exclusivo para cada ejecución de la máquina de estado.  
Admite [plantillas de sustitución](iot-substitution-templates.md): Sí

`roleArn`  
El ARN del rol que concede el AWS IoT permiso para iniciar la máquina de estados. Para obtener más información, consulte [Requisitos](#stepfunctions-rule-action-requirements).  
Admite [plantillas de sustitución](iot-substitution-templates.md): No

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

El siguiente ejemplo de JSON define una acción de Step Functions en una AWS IoT regla.

```
{
    "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"
                }
            }
        ]
    }
}
```

## Véase también
<a name="stepfunctions-rule-action-see-also"></a>
+ [¿Qué es AWS Step Functions?](https://docs.aws.amazon.com/step-functions/latest/dg/) en la *Guía AWS Step Functions para desarrolladores*