

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.

# Versiones de máquinas de estado en los flujos de trabajo de Step Functions
<a name="concepts-state-machine-version"></a>

Una *versión* es una instantánea numerada e **inmutable** de una máquina de estado. Usted publica versiones de la revisión más reciente realizada en esa máquina de estado. Cada versión tiene un nombre de recurso de Amazon (ARN) único, que es una combinación del ARN de la máquina de estado y el número de versión separados por dos puntos (:). En el ejemplo siguiente se muestra el formato de un ARN de versión de máquina de estado.

```
arn:{{partition}}:states:{{region}}:{{account-id}}:stateMachine:{{myStateMachine}}:1
```

Para empezar a utilizar versiones de máquinas de estado, debe publicar la primera versión. Tras publicar una versión, puede invocar la acción de la [StartExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartExecution.html)API con el ARN de la versión. No se puede editar una versión, pero es posible actualizar una máquina de estado y publicar una versión nueva. También se puede publicar varias versiones de la máquina de estado.

![Diagrama ilustrativo difuso que muestra cómo las versiones son instantáneas inmutables de máquinas de estado.](http://docs.aws.amazon.com/es_es/step-functions/latest/dg/images/versioning-concept.png)


Cuando se publica una nueva versión de la máquina de estado, Step Functions le asigna un número de versión. Los números de versión comienzan en 1 y aumentan de forma monótona para cada nueva versión. Los números de versión no se reutilizan para una máquina de estados dada. Si se elimina la versión 10 de la máquina de estado y, a continuación, se publica una nueva versión, Step Functions la publica como versión 11.

Las siguientes propiedades son las mismas para todas las versiones de una máquina de estado:
+ Todas las versiones de una máquina de estado comparten el mismo tipo [(estándar o rápido)](choosing-workflow-type.md).
+ No se puede cambiar el nombre o la fecha de creación de una máquina de estado de una versión a otra.
+ Las etiquetas se aplican globalmente a las máquinas de estado. Puede administrar las etiquetas de las máquinas de estado mediante las acciones [TagResource](https://docs.aws.amazon.com/step-functions/latest/apireference/API_TagResource.html)y de la [UntagResource](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UntagResource.html)API.

Las máquinas de estado también contienen propiedades que forman parte de cada versión y [revision](concepts-cd-aliasing-versioning.md#statemachinerev), pero estas propiedades pueden diferir entre dos versiones o revisiones determinadas. Estas propiedades incluyen la [Definición de la máquina de estado](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html#StepFunctions-UpdateStateMachine-request-definition), el [rol de IAM](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html#StepFunctions-UpdateStateMachine-request-roleArn), [la configuración de seguimiento](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html#StepFunctions-UpdateStateMachine-request-tracingConfiguration) y la [configuración de registro](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html#StepFunctions-UpdateStateMachine-request-loggingConfiguration).

## Publicación de una versión de una máquina de estado (Consola)
<a name="procedure-create-versions"></a>

Puede publicar hasta 1000 versiones de una máquina de estado. Para solicitar un aumento de este límite flexible, utilice la página **Centro de soporte** de [Consola de administración de AWS](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html). Puedes eliminar manualmente las versiones no utilizadas de la consola o invocando la acción de la [DeleteStateMachineVersion](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteStateMachineVersion.html)API.

**Para publicar una versión de una máquina de estado**

1. Abra la [consola de Step Functions](https://console.aws.amazon.com/states/home?region=us-east-1#/) y, a continuación, elija una máquina de estado existente.

1. En la página **Detalle de la máquina de estado**, elija **Editar**.

1. Edite la definición de la máquina de estados según sea necesario y, a continuación, elija **Guardar**.

1. Elija **Publicar versión**.

1. (Opcional) En el campo **Descripción** del cuadro de diálogo que aparece, escriba una breve descripción de la versión de la máquina de estado.

1. Elija **Publicar**.

**nota**  
Cuando se publica una nueva versión de la máquina de estado, Step Functions le asigna un número de versión. Los números de versión comienzan en 1 y aumentan de forma monótona para cada nueva versión. Los números de versión no se reutilizan para una máquina de estados dada. Si se elimina la versión 10 de la máquina de estado y, a continuación, se publica una nueva versión, Step Functions la publica como versión 11.

## Gestión de versiones con operaciones de API de Step Functions
<a name="manage-versions-with-api"></a>

Step Functions proporciona las siguientes operaciones de API para publicar y gestionar versiones de máquinas de estado:
+ [PublishStateMachineVersion](https://docs.aws.amazon.com/step-functions/latest/apireference/API_PublishStateMachineVersion.html)— Publica una versión a partir de la versión actual [revision](concepts-cd-aliasing-versioning.md#statemachinerev) de una máquina de estados.
+ [UpdateStateMachine](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html)— Publica una nueva versión de la máquina de estados si se actualiza una máquina de estados y se establece el `publish` parámetro `true` en la misma solicitud.
+ [CreateStateMachine](https://docs.aws.amazon.com/step-functions/latest/apireference/API_CreateStateMachine.html)— Publica la primera revisión de la máquina de estados si se establece el `publish` parámetro en`true`.
+ [ListStateMachineVersions](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListStateMachineVersions.html)— Muestra las versiones del ARN de la máquina de estado especificada.
+ [DescribeStateMachine](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeStateMachine.html)— Devuelve los detalles de la versión de la máquina de estados para una versión ARN especificada en. `stateMachineArn`
+ [DeleteStateMachineVersion](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteStateMachineVersion.html)— Elimina una versión de máquina de estados.

Para publicar una nueva versión de la revisión actual de una máquina de estados llamada `{{myStateMachine}}` mediante el AWS Command Line Interface, utilice el `publish-state-machine-version` comando:

```
aws stepfunctions publish-state-machine-version --state-machine-arn arn:aws:states:{{region}}:{{account-id}}:stateMachine:{{myStateMachine}}
```

La respuesta devuelve el `stateMachineVersionArn`. Por ejemplo, el comando anterior devuelve una respuesta de`arn:aws:states:{{region}}:{{account-id}}:stateMachine:{{myStateMachine}}:1`.

**nota**  
Cuando se publica una nueva versión de la máquina de estado, Step Functions le asigna un número de versión. Los números de versión comienzan en 1 y aumentan de forma monótona para cada nueva versión. Los números de versión no se reutilizan para una máquina de estados dada. Si se elimina la versión 10 de la máquina de estado y, a continuación, se publica una nueva versión, Step Functions la publica como versión 11.

## Ejecución de una versión de una máquina de estado desde la consola
<a name="procedure-run-version"></a>

Para empezar a utilizar versiones de máquina de estado, primero debe publicar una versión de la máquina de estado actual [revision](concepts-cd-aliasing-versioning.md#statemachinerev). Para publicar una versión, utilice la consola Step Functions o invoque la acción de la [PublishStateMachineVersion](https://docs.aws.amazon.com/step-functions/latest/apireference/API_PublishStateMachineVersion.html)API. También puede invocar la acción de la [UpdateStateMachineAlias](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachineAlias.html)API con un parámetro opcional denominado `publish` para actualizar una máquina de estados y publicar su versión.

Puede iniciar las ejecuciones de una versión mediante la consola o invocando la acción de la [StartExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartExecution.html)API y proporcionando el ARN de la versión. También puede usar un [alias](concepts-state-machine-alias.md) para iniciar las ejecuciones de una versión. Según su [configuración de direccionamiento](concepts-state-machine-alias.md#alias-routing-config), un alias dirige el tráfico a una versión específica.

Si inicia la ejecución de una máquina de estado sin usar una versión, Step Functions utilizará la revisión más reciente de la máquina de estado para la ejecución. Para obtener información sobre cómo Step Functions asocia una ejecución a una versión, consulte [Asociar ejecuciones a una versión o alias](execution-alias-version-associate.md).

**Para iniciar una ejecución utilizando una versión de una máquina de estado**

1. Abra la [consola de Step Functions](https://console.aws.amazon.com/states/home?region=us-east-1#/) y, a continuación, elija una máquina de estado existente de la que haya publicado una o más versiones. Para aprender a publicar una versión, consulte [Publicación de una versión de una máquina de estado (Consola)](#procedure-create-versions).

1. En la página **Detalle de la máquina de estado**, elija la pestaña **Versiones**.

1. En la sección **Versiones**, haga lo siguiente:

   1. Seleccione la versión con la que desee iniciar la ejecución.

   1. Seleccione **Iniciar ejecución**.

1. (Opcional) En el cuadro de diálogo **Iniciar ejecución**, escriba un nombre para la ejecución.

1. (Opcional) Introduzca la entrada de ejecución y, a continuación, seleccione **Iniciar ejecución**.