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 con una versión o un alias
Step Functions asocia una ejecución a una versión o alias según el nombre de recurso de Amazon (ARN) que se utiliza para invocar la acción de la API [StartExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartExecution.html). 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 estado mediante un ARN completo o incompleto.
+ **ARN completo**: hace referencia al ARN de una máquina de estado que tiene sufijo con un número de versión o un nombre de alias.
El siguiente ejemplo de ARN completo hace referencia a la versión `3` de una máquina de estado denominada `myStateMachine`.
```
arn:aws:states:region:account-id:stateMachine:myStateMachine:3
```
El siguiente ejemplo de ARN completo hace referencia a un alias denominado `PROD` de una máquina de estado llamada `myStateMachine`.
```
arn:aws:states:region:account-id:stateMachine:myStateMachine:PROD
```
+ **ARN incompleto**: hace referencia al ARN de una máquina de estado sin número de versión ni sufijo de nombre de alias.
```
arn:aws:states:region:account-id:stateMachine:myStateMachine
```
Por ejemplo, si su ARN incompleto hace referencia a la versión `3`, 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 ARN completo 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.
**nota**
Si inicia una ejecución con un ARN incompleto, Step Functions no asocia esa ejecución a una versión aunque la versión utilice la misma [revision](concepts-cd-aliasing-versioning.md#statemachinerev) de la máquina de estado. Por ejemplo, si la versión 3 utiliza la última revisión, pero inicia una ejecución con un ARN incompleto, Step Functions no asocia esa ejecución a la versión 3.
## 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 de la API
Puede ver todas las ejecuciones asociadas a una versión o un alias invocando las acciones de la API [DescribeExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeExecution.html) y [ListExecutions](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListExecutions.html). Estas acciones de la API devuelven el ARN de 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 el ARN de la ejecución.
También puede proporcionar un ARN de alias de máquina de estado o un ARN de versión para enumerar las ejecuciones asociadas a un alias o una versión específicos.
En el siguiente ejemplo de respuesta de la acción de la API [ListExecutions](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListExecutions.html) se muestra el ARN del alias que se utiliza para iniciar la ejecución de una máquina de estado llamada *myFirstExecution*.
El texto en *cursiva* del siguiente fragmento de código representa información específica del recurso.
```
{
"executions": [
{
"executionArn": "arn:aws:states:region:account-id:execution:myStateMachine:myFirstExecution",
"stateMachineArn": "arn:aws:states:region:account-id:stateMachine:myStateMachine",
"stateMachineAliasArn": "arn:aws:states:region:account-id: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](https://console.aws.amazon.com/states/home?region=us-east-1#/). En el siguiente procedimiento se muestra cómo ver las ejecuciones iniciadas con una versión específica:
1. Abra la [consola de Step Functions](https://console.aws.amazon.com/states/home?region=us-east-1#/) y, a continuación, seleccione una máquina de estado existente para la que haya publicado una [versión](concepts-state-machine-version.md#procedure-create-versions) o creado un [alias](concepts-state-machine-alias.md#procedure-create-aliases). En este ejemplo se muestra cómo ver las ejecuciones iniciadas con una versión específica de la máquina de estado.
1. Seleccione la pestaña **Versiones** y, a continuación, elija una versión de la lista de **versiones**.
**sugerencia**
Filtre por propiedad o cuadro de valores para buscar una versión específica.
1. En la *página Detalles de la versión*, puede ver una lista de todas las ejecuciones de máquinas de estado en curso y pasadas que se hayan iniciado con la versión seleccionada.
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*.
![\[Captura de pantalla ilustrativa de la página de la consola de detalles de la versión de máquina de estado.\]](http://docs.aws.amazon.com/es_es/step-functions/latest/dg/images/view-version-executions.png)
### Uso de métricas de CloudWatch
Para cada ejecución de una máquina de estado que se inicie con un [Qualified ARN](#qualifiedARN), 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 puede [crear alarmas de Amazon CloudWatch](procedure-cw-metrics.md#monitoring-using-cloudwatch-console-set-alarm) 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:
+ `ExecutionTime`
+ `ExecutionsAborted`
+ `ExecutionsFailed`
+ `ExecutionsStarted`
+ `ExecutionsSucceeded`
+ `ExecutionsTimedOut `
Si ha iniciado la ejecución con un ARN de versión, Step Functions publica la métrica con `StateMachineArn` y una segunda métrica con las dimensiones `StateMachineArn` y`Version`.
Si ha iniciado la ejecución con un ARN de alias, Step Functions emite las siguientes métricas:
+ Dos métricas para el ARN incompleto y la versión.
+ Una métrica con las dimensiones `StateMachineArn` y `Alias`.