Versiones de máquinas de estado en los flujos de trabajo de Step Functions - AWS Step Functions

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

Una versión es una instantánea numerada e inmutable de una máquina de estados. 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 estado de la máquina ARN y el número de versión separados por dos puntos (:). El siguiente ejemplo muestra el formato de una versión de máquina de estadosARN.

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 StartExecutionAPIacción con la versiónARN. 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.

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).

  • 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 y. TagResourceUntagResourceAPI

Las máquinas de estado también contienen propiedades que forman parte de cada versión y revision, pero estas propiedades pueden diferir entre dos versiones o revisiones determinadas. Estas propiedades incluyen la definición de la máquina de estado, la IAMfunción, la configuración de rastreo y la configuración de registro.

Publicación de una versión de una máquina de estado (Consola)

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 AWS Management Console. Puede eliminar manualmente las versiones no utilizadas de la consola o invocando la DeleteStateMachineVersionAPIacción.

Para publicar una versión de una máquina de estado
  1. Abra la consola de Step Functions y, a continuación, elija una máquina de estado existente.

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

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

  4. Elija Publicar versión.

  5. (Opcional) En el campo Descripción del cuadro de diálogo que aparece, introduzca una breve descripción de la versión de la máquina de estados.

  6. 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 API operaciones de Step Functions

Step Functions proporciona las siguientes API operaciones para publicar y gestionar las versiones de las máquinas de estado:

  • PublishStateMachineVersion— Publica una versión a partir de la versión actual revision de una máquina de estados.

  • UpdateStateMachine— 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— Publica la primera revisión de la máquina de estados si se establece el publish parámetro entrue.

  • ListStateMachineVersions— Muestra las versiones de la máquina de estados especificadaARN.

  • DescribeStateMachine— Devuelve los detalles de la versión de la máquina de estados para una versión ARN especificada enstateMachineArn.

  • DeleteStateMachineVersion— Elimina una versión de la 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:us-east-1:123456789012:stateMachine:myStateMachine

La respuesta devuelve el stateMachineVersionArn. Por ejemplo, el comando anterior devuelve una respuesta dearn:aws:states:us-east-1:123456789012: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

Para empezar a utilizar versiones de máquina de estado, primero debe publicar una versión de la máquina de estado actual revision. Para publicar una versión, utilice la consola Step Functions o invoque la PublishStateMachineVersionAPIacción. También puede invocar la UpdateStateMachineAliasAPIacción 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 StartExecutionAPIacción y proporcionando la versión. ARN También puede usar un alias para iniciar las ejecuciones de una versión. Según su configuración de direccionamiento, 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.

Para iniciar una ejecución utilizando una versión de una máquina de estado
  1. Abra la consola de Step Functions 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).

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

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

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

    2. Seleccione Iniciar ejecución.

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

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