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 Step Functions asocia las ejecuciones a una versión o un alias

Step Functions asocia una ejecución a una versión o alias en función del nombre de recurso de Amazon (ARN) que se utiliza para invocar la StartExecutionAPIacción. Step Functions realiza esta acción en el momento en que comienza la ejecución.

Puede iniciar la ejecución de una máquina de estados utilizando un código cualificado o no ARN cualificado.

Por ejemplo, si su calificación ARN se refiere a la versión3, Step Functions asocia la ejecución a esta versión. No asocia la ejecución a ningún alias que apunte a la versión 3.

Si su cualificado ARN hace referencia a un alias, Step Functions asocia la ejecución a ese alias y a la versión a la que apunta el alias. Una ejecución solo puede asociarse a un alias.

Ver las ejecuciones iniciadas con una versión o un alias

Step Functions ofrece las siguientes formas de ver las ejecuciones iniciadas con una versión o un alias:

Uso de acciones API

Puede ver todas las ejecuciones asociadas a una versión o un alias invocando ListExecutionsAPIlas acciones DescribeExecutiony. Estas API acciones devuelven ARN la versión o el alias que se utilizó para iniciar la ejecución. Estas acciones también devuelven otros detalles, como el estado y ARN la ejecución.

También puede proporcionar un alias ARN o una versión de la máquina de estados ARN para enumerar las ejecuciones asociadas a un alias o versión específicos.

En el siguiente ejemplo de respuesta de la ListExecutionsAPIacción se muestra el ARN alias utilizado para iniciar una ejecución en una máquina de estados denominada myFirstExecution.

La italicized el texto del siguiente fragmento de código representa información específica del recurso.

{
    "executions": [
        {
            "executionArn": "arn:aws:states:us-east-1:123456789012:execution:myStateMachine:myFirstExecution",
            "stateMachineArn": "arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine",
            "stateMachineAliasArn": "arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:PROD",
            "name": "myFirstExecution",
            "status": "SUCCEEDED",
            "startDate": "2023-04-20T23:07:09.477000+00:00",
            "stopDate": "2023-04-20T23:07:09.732000+00:00"
        }
    ]
}

Uso de la consola de Step Functions

También puede ver las ejecuciones iniciadas por una versión o un alias desde la consola de Step Functions. En el siguiente procedimiento se muestra cómo ver las ejecuciones iniciadas con una versión específica:

En la siguiente imagen se muestra la página Detalles de la versión de la consola. Esta página muestra las ejecuciones iniciadas por la versión 4 de una máquina de estado denominada MathAddDemo. Esta lista también muestra una ejecución que se inició con un alias denominado PROD. Este alias enrutaba el tráfico de ejecución a la versión 4.

Uso de métricas CloudWatch

Para cada ejecución de una máquina de estado que se inicie con un Qualified ARN, Step Functions emite métricas adicionales con el mismo nombre y valor que las métricas emitidas actualmente. Estas métricas adicionales contienen dimensiones para cada identificador de la versión y nombre de alias con los que se inicia una ejecución. Con estas métricas, puede supervisar las ejecuciones de la máquinas de estado en el nivel de versión y determinar cuándo podría ser necesaria una reversión. También puedes crear CloudWatch alarmas de Amazon en función de estas métricas.

Step Functions emite las siguientes métricas para las ejecuciones que se inician con un alias o una versión:

Si ha iniciado la ejecución con una versiónARN, Step Functions publica la métrica con las dimensiones StateMachineArn y una segunda métrica con Version las dimensiones StateMachineArn y.

Si ha iniciado la ejecución con un aliasARN, Step Functions emite las siguientes métricas: