Step Functions
La acción Funciones de Pasos (stepFunctions
) inicia una máquina de estados AWS Step Functions.
Requisitos
Esta regla tiene los siguientes requisitos:
-
Un rol de IAM que AWS IoT puede asumir para realizar la operación
states:StartExecution
. Para obtener más información, consulte Otorgar a una regla AWS IoT el acceso que requiere.En la consola de AWS IoT, puede elegir o crear un rol que permita a AWS IoT realizar esta acción de regla.
Parámetros
Cuando cree una regla AWS IoT con esta acción, debe especificar la información siguiente:
stateMachineName
-
El nombre de la máquina de estado de Step Functions a iniciar.
Admite plantillas de sustitución: 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: Sí
roleArn
-
El ARN del rol que concede AWS IoT permiso para iniciar la máquina de estado. Para obtener más información, consulte Requisitos.
Admite plantillas de sustitución: No
Ejemplos
El siguiente ejemplo JSON define una acción Step Functions en una regla AWS IoT.
{ "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
-
¿Qué es AWS Step Functions? en la Guía para desarrolladores de AWS Step Functions