As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Como o Step Functions associa as execuções a uma versão ou a um alias
O Step Functions associa uma execução a uma versão ou alias com base no nome do recurso da Amazon (ARN) que você usa para invocar a ação da API [StartExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartExecution.html). O Step Functions executa essa ação no horário de início da execução.
É possível iniciar a execução de uma máquina de estado usando um ARN qualificado ou não qualificado.
+ **ARN qualificado** — Refere-se ao ARN de uma máquina de estado com o sufixo de um número de versão ou nome de alias.
O seguinte exemplo de ARN qualificado se refere à versão `3` de uma máquina de estado chamada `myStateMachine`.
```
arn:aws:states:region:account-id:stateMachine:myStateMachine:3
```
O seguinte exemplo de ARN qualificado se refere a um alias chamado `PROD` de uma máquina de estado chamada `myStateMachine`.
```
arn:aws:states:region:account-id:stateMachine:myStateMachine:PROD
```
+ **ARN não qualificado** — Refere-se ao ARN de uma máquina de estado sem o sufixo de um número de versão ou nome de alias.
```
arn:aws:states:region:account-id:stateMachine:myStateMachine
```
Por exemplo, se o ARN qualificado se referir à versão `3`, o Step Functions associará a execução a essa versão. Ele não associa a execução a nenhum alias que aponte para a versão `3`.
Se o ARN qualificado se referir a um alias, o Step Functions associará a execução a esse alias e à versão para a qual o alias aponta. Uma execução só pode ser associada a um alias.
**nota**
Se você iniciar uma execução com um ARN não qualificado, o Step Functions não associará essa execução a uma versão, mesmo que a versão use a mesma máquina de estado [revision](concepts-cd-aliasing-versioning.md#statemachinerev). Por exemplo, se a versão 3 usar a revisão mais recente, mas você iniciar uma execução com um ARN não qualificado, o Step Functions não associará essa execução à versão 3.
## Como visualizar execuções iniciadas com uma versão ou um alias
O Step Functions fornece as seguintes maneiras pelas quais você pode visualizar as execuções iniciadas com uma versão ou um alias:
### Como usar ações de API
Você pode visualizar todas as execuções associadas a uma versão ou a um alias invocando as ações da API [DescribeExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeExecution.html) e [ListExecutions](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListExecutions.html). Essas ações de API retornam o ARN da versão ou alias usado para iniciar a execução. Essas ações também retornam outros detalhes, incluindo status e ARN da execução.
Você também pode fornecer um ARN ou ARN de versão do alias da máquina de estado para listar as execuções associadas a um alias ou versão específica.
O exemplo de resposta da ação da API [ListExecutions](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListExecutions.html) a seguir mostra o ARN do alias usado para iniciar a execução de uma máquina de estado denominada *myFirstExecution*.
O texto em *itálico* no trecho de código a seguir representa informações específicas do 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"
}
]
}
```
### Como usar o console do Step Functions
Você também pode ver as execuções iniciadas por uma versão ou um alias no [console do Step Functions](https://console.aws.amazon.com/states/home?region=us-east-1#/). O seguinte procedimento mostra como você pode visualizar as execuções iniciadas com uma versão específica:
1. Abra o [console do Step Functions](https://console.aws.amazon.com/states/home?region=us-east-1#/) e, em seguida, escolha uma máquina de estado existente para a qual você publicou uma [versão](concepts-state-machine-version.md#procedure-create-versions) ou criou um [alias](concepts-state-machine-alias.md#procedure-create-aliases). Este exemplo mostra como visualizar as execuções iniciadas com uma versão específica da máquina de estado.
1. Escolha a guia **Versões** e, em seguida, escolha uma versão na lista **Versões**.
**dica**
Filtre por propriedade ou caixa de valor para pesquisar uma versão específica.
1. Na *página de detalhes da versão*, você pode ver uma lista de todas as execuções de máquina de estado em andamento e anteriores iniciadas com a versão selecionada.
A seguinte imagem mostra a página do console *Detalhes da versão*. Essa página lista as execuções iniciadas pela versão *4* de uma máquina de estado chamada `MathAddDemo`. Essa lista também exibe uma execução que foi iniciada por um alias chamado `PROD`. Esse alias roteou o tráfego de execução para a versão *4*.
![\[Captura de tela ilustrativa da página do console de detalhes da versão da máquina de estado.\]](http://docs.aws.amazon.com/pt_br/step-functions/latest/dg/images/view-version-executions.png)
### Usar métricas do Amazon CloudWatch
Para cada execução de máquina de estado que você inicia com um [Qualified ARN](#qualifiedARN), o Step Functions emite métricas adicionais com o mesmo nome e valor das métricas emitidas atualmente. Essas métricas adicionais contêm dimensões para cada identificador de versão e nome de alias com os quais você inicia uma execução. Com essas métricas, você pode monitorar as execuções da máquina de estado no nível da versão e determinar quando um cenário de reversão pode ser necessário. Você também pode [criar alarmes do Amazon CloudWatch](procedure-cw-metrics.md#monitoring-using-cloudwatch-console-set-alarm) com base nessas métricas.
O Step Functions emite as seguintes métricas para execuções que você inicia com um alias ou uma versão:
+ `ExecutionTime`
+ `ExecutionsAborted`
+ `ExecutionsFailed`
+ `ExecutionsStarted`
+ `ExecutionsSucceeded`
+ `ExecutionsTimedOut `
Se você iniciou a execução com um ARN de versão, o Step Functions publica a métrica com o `StateMachineArn` e uma segunda métrica com dimensões `StateMachineArn` e `Version`.
Se você iniciou a execução com um ARN de alias, o Step Functions emite as seguintes métricas:
+ Duas métricas para o ARN não qualificado e a versão.
+ Uma métrica com as dimensões `StateMachineArn` e `Alias`.