

 AWS Cloud9 ya no está disponible para nuevos clientes. Los clientes existentes de AWS Cloud9 pueden seguir utilizando el servicio con normalidad. [Más información](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/)

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.

# Cómo trabajar AWS Step Functions con el AWS kit de herramientas
<a name="bulding-stepfunctions"></a>

El AWS kit de herramientas proporciona soporte para. [AWS Step Functions](https://aws.amazon.com/step-functions/) Step Functions le permite crear máquinas de estados que definen los flujos de trabajo para AWS Lambda las funciones y otros AWS servicios que admiten aplicaciones críticas para la empresa.

Puede usar el AWS kit de herramientas para hacer lo siguiente con Step Functions:
+ Cree y publique una máquina de estado, que es un flujo de trabajo compuesto por pasos individuales.
+ Descargue un archivo que defina un flujo de trabajo de máquina de estado.
+ Ejecute un flujo de trabajo de máquina de estado con la entrada que ha ingresado o seleccionado. 

**Topics**
+ [Requisitos previos](#bulding-stepfunctions-pre)
+ [Creación y publicación de una máquina de estado](#state-machine-create)
+ [Ejecute una máquina de estados en Toolkit AWS](#starting-stepfunctions)
+ [Descargue un archivo de definición de máquina de estado y visualice su flujo de trabajo](#sfn-download)

## Requisitos previos
<a name="bulding-stepfunctions-pre"></a>

Step Functions puede ejecutar código y acceder a AWS recursos (por ejemplo, invocar una función Lambda). Para mantener la seguridad, debe conceder a Step Functions acceso a esos recursos mediante un rol de IAM. 

Con AWS Toolkit, puede aprovechar las funciones de IAM generadas automáticamente que son válidas para la AWS región en la que cree la máquina de estados. *Para crear su propia función de IAM para una máquina de estados, consulte [Cómo AWS Step Functions funciona con IAM](https://docs.aws.amazon.com/step-functions/latest/dg/procedure-create-iam-role.html) en la Guía para desarrolladores.AWS Step Functions * 

## Creación y publicación de una máquina de estado
<a name="state-machine-create"></a>

Cuando crea una máquina de estados con AWS Toolkit, elige una plantilla inicial que defina un flujo de trabajo para un modelo de negocio. A continuación, puede editar o reemplazar esa plantilla para que se adapte mejor a sus necesidades específicas. Para obtener más información sobre la definición de una máquina de estado en un archivo que representa su estructura, consulte [Lenguaje de estados de Amazon](https://docs.aws.amazon.com/step-functions/latest/dg/concepts-amazon-states-language.html) en la *Guía para desarrolladores de AWS Step Functions *.

1. En el panel de **AWS Explorer**, abra el menú contextual (haga clic con el botón derecho) de **Step Functions** y, a continuación, elija **Create a new Step Function state machine** (Crear una nueva máquina de estado de Step Functions).

1. En el panel de comandos, elija una plantilla inicial para el flujo de trabajo de la máquina de estado. 

1. A continuación, elija un formato para el archivo de Lenguaje de estados de Amazon (ASL) que define su máquina de estado.

   Se abre un editor para mostrar el archivo de ASL que define el flujo de trabajo de la máquina de estado.
**nota**  
Para obtener información sobre editar el archivo de ASL para personalizar el flujo de trabajo, consulte [Estructura de las máquinas de estado](https://docs.aws.amazon.com/step-functions/latest/dg/amazon-states-language-state-machine-structure.html). 

1. En el archivo ASL, selecciona **Publicar en Step Functions** para añadir tu máquina de estados a la AWS nube. 
**nota**  
También puede elegir **Render graph** (Gráfico de representación) en el archivo de ASL para mostrar una representación visual del flujo de trabajo de la máquina de estado.  
![\[Diagrama que muestra cómo elegir Publicar en Step Functions\]](http://docs.aws.amazon.com/es_es/cloud9/latest/user-guide/images/publish-stepfunction.png)

1. En el panel de comandos, elija una AWS región para alojar la función Step.

1. A continuación, puede optar por crear una nueva instancia de Step Functions o actualizar una existente.

------
#### [ Quick Create  ]

   Esta opción le permite crear una nueva función de paso a partir del archivo ASL utilizando [step- functions/latest/dg/concepts - standard-vs-express .html.](https://docs.aws.amazon.com/step-functions/latest/dg/concepts-standard-vs-express.html) Se le pide que especifique lo siguiente:
   + Un rol de IAM que permite a la función step ejecutar código y acceder a los recursos. AWS (Puede elegir un rol de IAM generado automáticamente que sea válido para la AWS región en la que creó la máquina de estados).
   + Un nombre para la nueva función.

   Puede comprobar que su máquina de estados se creó correctamente y obtener su ARN en la pestaña de resultados del AWS kit de herramientas.

------
#### [ Quick Update ]

   Si ya existe una máquina de estados en la AWS región, puede elegir una para actualizarla con el archivo ASL actual. 

   Puede comprobar que su máquina de estados se ha actualizado correctamente y obtener su ARN en la pestaña de resultados del AWS kit de herramientas.

------

   Después de crear una máquina de estado, aparece en **Step Functions** en el panel **AWS Explorer**. Si no aparece inmediatamente, elija el menú **Toolkit**, **Refresh Explorer** (Actualizar Explorer).

## Ejecute una máquina de estados en Toolkit AWS
<a name="starting-stepfunctions"></a>

Puede usar AWS Toolkit para ejecutar máquinas de estado remotas. La máquina de estado en ejecución recibe un texto JSON como entrada y transfiere dicha entrada al primer estado del flujo de trabajo. Los estados individuales reciben JSON como entrada y normalmente pasan JSON como salida al siguiente estado. Para obtener más información, consulte [Procesamiento de entrada y salida en Step Functions](https://docs.aws.amazon.com/step-functions/latest/dg/concepts-input-output-filtering.html).

1. En el panel **AWS Explorer**, elija **Step Functions**. A continuación, abra el menú contextual (haga clic con el botón derecho) de una máquina de estado específica y elija **Start Execution** (Iniciar ejecución).

1. En el panel **Start Execution** (Iniciar ejecución), agregue la entrada en formato JSON para el flujo de trabajo de la máquina de estado. Para ello, ingrese el texto directamente en el campo siguiente o cargue un archivo desde su dispositivo local.

1. Elija **Execute** (Ejecutar).

   La pestaña de salida del AWS kit de herramientas muestra una confirmación de que el flujo de trabajo se ha iniciado y el ARN del ID del proceso. Puede usar ese ID de proceso para comprobar en la AWS Step Functions consola si el flujo de trabajo se ha ejecutado correctamente. También puede ver las marcas de tiempo de cuándo inició y finalizó el flujo de trabajo. 

## Descargue un archivo de definición de máquina de estado y visualice su flujo de trabajo
<a name="sfn-download"></a>

Descargar una máquina de estado significa que descarga un archivo que contiene texto JSON que representa la estructura de esa máquina de estado. A continuación, puede editar este archivo para crear una máquina de estado nueva o para actualizar una existente. Para obtener más información, consulte [Lenguaje de estados de Amazon](https://docs.aws.amazon.com/step-functions/latest/dg/concepts-amazon-states-language.html) en la *Guía para desarrolladores de AWS Step Functions *.

1. En el panel **AWS Explorer**, elija **Step Functions**. A continuación, abra el menú contextual (haga clic con el botón derecho) de una máquina de estado específica y elija **Download Definition** (Descargar definición).
**nota**  
El menú contextual también ofrece las opciones **Copy Name** (Copiar nombre) y **Copy ARN** (Copiar ARN).

1. En el cuadro de diálogo **Save** (Guardar), seleccione la carpeta del entorno en la que almacena el archivo de máquina de estado descargado y, a continuación, elija **Save** (Guardar).

   El archivo con formato JSON que define el flujo de trabajo de la máquina de estado se muestra en un editor.

1. Para mostrar una representación visual del flujo de trabajo, elija **Render graph** (Gráfico de representación).

   Una ventana muestra un diagrama de flujo, que muestra la secuencia de estados del flujo de trabajo de la máquina de estado.  
![\[Representación visual del flujo de trabajo de la máquina de estado\]](http://docs.aws.amazon.com/es_es/cloud9/latest/user-guide/images/render-graph.png)