Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# In che modo Step Functions associa le esecuzioni a una versione o a un alias
Step Functions associa un'esecuzione a una versione o alias basato sull'Amazon Resource Name (ARN) che usi per richiamare l'azione API. [StartExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartExecution.html) Step Functions esegue questa azione all'inizio dell'esecuzione.
È possibile avviare l'esecuzione di una macchina a stati utilizzando un ARN qualificato o non qualificato.
+ **ARN qualificato: si riferisce a un ARN** di una macchina a stati con il suffisso un numero di versione o un nome alias.
Il seguente esempio di ARN qualificato si riferisce alla versione `3` di una macchina a stati denominata. `myStateMachine`
```
arn:aws:states:region:account-id:stateMachine:myStateMachine:3
```
Il seguente esempio di ARN qualificato si riferisce a un alias denominato `PROD` di una macchina a stati denominata. `myStateMachine`
```
arn:aws:states:region:account-id:stateMachine:myStateMachine:PROD
```
+ **ARN non qualificato**: si riferisce all'ARN di una macchina a stati senza un numero di versione o un suffisso del nome alias.
```
arn:aws:states:region:account-id:stateMachine:myStateMachine
```
Ad esempio, se l'ARN qualificato si riferisce alla versione`3`, Step Functions associa l'esecuzione a questa versione. Non associa l'esecuzione a nessun alias che rimanda alla versione. `3`
Se l'ARN qualificato fa riferimento a un alias, Step Functions associa l'esecuzione a quell'alias e alla versione a cui fa riferimento l'alias. Un'esecuzione può essere associata a un solo alias.
**Nota**
Se si avvia un'esecuzione con un ARN non qualificato, Step Functions non associa tale esecuzione a una versione anche se la versione utilizza la stessa macchina a stati. [revision](concepts-cd-aliasing-versioning.md#statemachinerev) Ad esempio, se la versione 3 utilizza la revisione più recente, ma si avvia un'esecuzione con un ARN non qualificato, Step Functions non associa tale esecuzione alla versione 3.
## Visualizzazione delle esecuzioni iniziate con una versione o un alias
Step Functions offre i seguenti modi in cui è possibile visualizzare le esecuzioni iniziate con una versione o un alias:
### Utilizzo delle azioni API
Puoi visualizzare tutte le esecuzioni associate a una versione o a un alias richiamando le azioni [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)API. Queste azioni API restituiscono l'ARN della versione o dell'alias utilizzato per avviare l'esecuzione. Queste azioni restituiscono anche altri dettagli, tra cui lo stato e l'ARN dell'esecuzione.
Puoi anche fornire un alias di macchina a stati ARN o versione ARN per elencare le esecuzioni associate a un alias o a una versione specifici.
Il seguente esempio di risposta dell'azione [ListExecutions](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListExecutions.html)API mostra l'ARN dell'alias utilizzato per avviare un'esecuzione di una macchina a stati denominata. *myFirstExecution*
Il *italicized* testo nel seguente frammento di codice rappresenta informazioni specifiche della risorsa.
```
{
"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"
}
]
}
```
### Utilizzo della console Step Functions
Puoi anche visualizzare le esecuzioni avviate da una versione o da un alias dalla console [Step Functions](https://console.aws.amazon.com/states/home?region=us-east-1#/). La procedura seguente mostra come visualizzare le esecuzioni avviate con una versione specifica:
1. Apri la [console Step Functions](https://console.aws.amazon.com/states/home?region=us-east-1#/), quindi scegli una macchina a stati esistente per la quale hai pubblicato una [versione](concepts-state-machine-version.md#procedure-create-versions) o creato un [alias](concepts-state-machine-alias.md#procedure-create-aliases). Questo esempio mostra come visualizzare le esecuzioni iniziate con una versione specifica della macchina a stati.
1. Scegliete la scheda **Versioni**, quindi scegliete una versione dall'elenco **Versioni**.
**Suggerimento**
Filtra per proprietà o casella di valore per cercare una versione specifica.
1. Nella *pagina dei dettagli della versione*, è possibile visualizzare un elenco di tutte le esecuzioni in corso e passate di macchine a stati avviate con la versione selezionata.
L'immagine seguente mostra la pagina della console con *i dettagli della versione*. Questa pagina elenca le esecuzioni avviate dalla versione *4* di una macchina a stati denominata`MathAddDemo`. Questo elenco mostra anche un'esecuzione che è stata avviata da un alias denominato. `PROD` *Questo alias ha indirizzato il traffico di esecuzione alla versione 4.*
![\[Schermata illustrativa della pagina della console con i dettagli della versione della macchina a stati.\]](http://docs.aws.amazon.com/it_it/step-functions/latest/dg/images/view-version-executions.png)
### Utilizzo delle metriche CloudWatch
Per ogni esecuzione di una macchina a stati che si inizia con a[Qualified ARN](#qualifiedARN), Step Functions emette metriche aggiuntive con lo stesso nome e valore delle metriche emesse attualmente. Queste metriche aggiuntive contengono dimensioni per ogni identificatore di versione e nome alias con cui si avvia un'esecuzione. Con queste metriche, è possibile monitorare le esecuzioni delle macchine a stati a livello di versione e determinare quando potrebbe essere necessario uno scenario di rollback. Puoi anche [creare CloudWatch allarmi Amazon](procedure-cw-metrics.md#monitoring-using-cloudwatch-console-set-alarm) in base a questi parametri.
Step Functions emette le seguenti metriche per le esecuzioni che iniziano con un alias o una versione:
+ `ExecutionTime`
+ `ExecutionsAborted`
+ `ExecutionsFailed`
+ `ExecutionsStarted`
+ `ExecutionsSucceeded`
+ `ExecutionsTimedOut `
Se hai avviato l'esecuzione con una versione ARN, Step Functions pubblica la metrica con `StateMachineArn` e una seconda metrica con e dimensioni. `StateMachineArn` `Version`
Se hai avviato l'esecuzione con un alias ARN, Step Functions emette le seguenti metriche:
+ Due metriche per l'ARN e la versione non qualificati.
+ Una metrica con le dimensioni e. `StateMachineArn` `Alias`