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à.
# Alias di macchine a stati nei flussi di lavoro di Step Functions
Un *alias* è un puntatore per un massimo di due versioni della stessa macchina a stati. È possibile creare più alias per le proprie macchine a stati. Ogni alias ha un Amazon Resource Name (ARN) univoco. L'alias ARN è una combinazione dell'ARN della macchina a stati e del nome dell'alias, separati da due punti (:). L'esempio seguente mostra il formato di un alias ARN di una macchina a stati.
```
arn:partition:states:region:account-id:stateMachine:myStateMachine:aliasName
```
È possibile utilizzare un alias per [indirizzare il traffico](#alias-routing-config) tra una delle due versioni della macchina a stati. È inoltre possibile creare un alias che punti a una singola versione. Gli alias possono puntare solo a versioni di macchine a stati. Non è possibile utilizzare un alias per puntare a un altro alias. È inoltre possibile aggiornare un alias in modo che punti a una versione diversa della macchina a stati.
![\[Diagramma che mostra un alias che invia l'80% delle richieste alla v1 e il 20% alla v2.\]](http://docs.aws.amazon.com/it_it/step-functions/latest/dg/images/aliases-concept.png)
**Topics**
+ [Creazione di un alias per una macchina a stati (Console)](#procedure-create-aliases)
+ [Gestione degli alias con APIs](#manage-aliases-with-api)
+ [Configurazione del routing dell'alias](#alias-routing-config)
+ [Esecuzione di una macchina a stati utilizzando un alias (Console)](#procedure-run-exec-with-alias)
## Creazione di un alias per una macchina a stati (Console)
È possibile creare fino a 100 alias per ogni macchina a stati utilizzando la console Step Functions o richiamando l'azione [CreateStateMachineAlias](https://docs.aws.amazon.com/step-functions/latest/apireference/API_CreateStateMachineAlias.html)API. Per richiedere un aumento di questo limite flessibile, utilizza la pagina **Support Center** nel [Console di gestione AWS](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html). Elimina gli alias non utilizzati dalla console o richiamando l'[DeleteStateMachineAlias](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteStateMachineAlias.html)azione API.
**Per creare un alias di una macchina a stati**
1. Apri la [console Step Functions](https://console.aws.amazon.com/states/home?region=us-east-1#/), quindi scegli una macchina a stati esistente.
1. Nella pagina dei **dettagli della macchina a stati**, scegliete la scheda **Alias**.
1. Scegli **Crea nuovo alias**.
1. Nella pagina **Create alias (Crea alias)**, eseguire le operazioni seguenti:
1. Inserisci un nome **alias**.
1. (Facoltativo) Immettere una **Description (Descrizione)** per l'alias.
1. Per configurare il routing sull'alias, vedi Configurazione del routing degli [alias](#alias-routing-config).
1. Scegli **Crea alias**.
## Gestione degli alias con le operazioni dell'API Step Functions
Step Functions fornisce le seguenti operazioni API che è possibile utilizzare per creare e gestire alias di macchine a stati o ottenere informazioni sugli alias:
+ [CreateStateMachineAlias](https://docs.aws.amazon.com/step-functions/latest/apireference/API_CreateStateMachineAlias.html)— Crea un alias per una macchina a stati.
+ [DescribeStateMachineAlias](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeStateMachineAlias.html)— Restituisce dettagli su un alias di una macchina a stati.
+ [ListStateMachineAliases](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListStateMachineAliases.html)— Elenca gli alias per l'ARN della macchina a stati specificata.
+ [UpdateStateMachineAlias](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachineAlias.html)— Aggiorna la configurazione di un alias di una macchina a stati esistente modificandone o. `description` `routingConfiguration`
+ [DeleteStateMachineAlias](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteStateMachineAlias.html)— Elimina un alias di una macchina a stati.
Per creare un alias denominato `PROD` che punti alla versione 1 di una macchina a stati denominata `myStateMachine` utilizzando il AWS Command Line Interface, utilizzare il comando. `create-state-machine-alias`
```
aws stepfunctions create-state-machine-alias --name PROD --routing-configuration "[{\"stateMachineVersionArn\":\"arn:aws:states:region:account-id:stateMachine:myStateMachine:1\",\"weight\":100}]"
```
## Configurazione del routing dell'alias
È possibile utilizzare un alias per indirizzare il traffico di esecuzione tra due versioni di una macchina a stati. Ad esempio, supponiamo che tu voglia lanciare una nuova versione della tua macchina a stati. È possibile ridurre i rischi associati alla distribuzione della nuova versione configurando il routing su un alias. Configurando il routing, è possibile inviare la maggior parte del traffico a una versione precedente e testata della macchina a stati. La nuova versione può quindi ricevere una percentuale inferiore, fino a quando non confermerai che il rollforward della nuova versione è sicuro.
Per definire la configurazione del routing, assicurati di pubblicare entrambe le versioni della macchina a stati a cui fa riferimento il tuo alias. Quando si avvia un'esecuzione da un alias, Step Functions sceglie in modo casuale la versione della macchina a stati da eseguire tra le versioni specificate nella configurazione del routing. Basa questa scelta sulla percentuale di traffico assegnata a ciascuna versione nella configurazione di routing degli alias.
**Per configurare la configurazione del routing su un alias**
+ Nella pagina **Crea alias**, in **Configurazione del routing**, procedi come segue:
1. Per **Versione**, scegli la prima versione della macchina a stati a cui punta l'alias.
1. Seleziona la casella di controllo **Dividi il traffico tra due versioni**.
**Suggerimento**
Per puntare a una singola versione, deseleziona la casella di controllo **Dividi il traffico tra due versioni**.
1. Per **Versione**, scegli la seconda versione a cui deve puntare l'alias.
1. Nei campi **Percentuale di traffico**, specifica la percentuale di traffico da indirizzare verso ciascuna versione. Ad esempio, inserisci **60** e **40** indirizza il 60 percento del traffico di esecuzione verso la prima versione e il 40 percento del traffico verso la seconda versione.
Le percentuali di traffico combinate devono essere pari al 100 percento.
## Esecuzione di una macchina a stati utilizzando un alias (Console)
È possibile avviare le esecuzioni delle macchine a stati con un alias dalla console o richiamando l'azione [StartExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartExecution.html)API con l'ARN dell'alias. Step Functions esegue quindi la versione specificata dall'alias. Per impostazione predefinita, se non si specifica una versione o un alias quando si avvia l'esecuzione di una macchina a stati, Step Functions utilizza la revisione più recente.
**Per avviare l'esecuzione di una macchina a stati utilizzando un alias**
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 creato un alias. Per informazioni sulla creazione di un alias, consulta. [Creazione di un alias per una macchina a stati (Console)](#procedure-create-aliases)
1. Nella pagina dei **dettagli della macchina a stati**, scegli la scheda **Alias**.
1. Nella sezione **Alias**, procedi come segue:
1. Seleziona l'alias con cui vuoi iniziare l'esecuzione.
1. Selezionare **Start execution (Avvia esecuzione)**.
1. (Facoltativo) Nella finestra di dialogo **Avvia esecuzione**, immettete un nome per l'esecuzione.
1. Se necessario, immettete l'input di esecuzione, quindi scegliete **Avvia esecuzione**.