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à.
# Versioni di macchine a stati nei flussi di lavoro Step Functions
Una *versione* è un'istantanea numerata e **immutabile di** una macchina a stati. Si pubblicano le versioni della revisione più recente apportata a quella macchina a stati. Ogni versione ha un Amazon Resource Name (ARN) univoco, che è una combinazione dell'ARN della macchina a stati e del numero di versione separati da due punti (:). L'esempio seguente mostra il formato di una versione ARN di una macchina a stati.
```
arn:{{partition}}:states:{{region}}:{{account-id}}:stateMachine:{{myStateMachine}}:1
```
Per iniziare a utilizzare le versioni delle macchine a stati, è necessario pubblicare la prima versione. Dopo aver pubblicato una versione, puoi richiamare l'azione [StartExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartExecution.html)API con la versione ARN. Non è possibile modificare una versione, ma è possibile aggiornare una macchina a stati e pubblicare una nuova versione. Puoi anche pubblicare più versioni della tua macchina a stati.
Quando pubblicate una nuova versione della vostra macchina a stati, Step Functions le assegna un numero di versione. I numeri di versione partono da 1 e aumentano in modo monotono per ogni nuova versione. I numeri di versione non vengono riutilizzati per una determinata macchina a stati. Se elimini la versione 10 della tua macchina a stati e poi pubblichi una nuova versione, Step Functions la pubblica come versione 11.
Le seguenti proprietà sono le stesse per tutte le versioni di una macchina a stati:
+ Tutte le versioni di una macchina a stati condividono lo stesso tipo [(Standard o Express)](choosing-workflow-type.md).
+ Non è possibile modificare il nome o la data di creazione di una macchina a stati tra le versioni.
+ I tag si applicano a livello globale alle macchine a stati. È possibile gestire i tag per le macchine a stati utilizzando le azioni [TagResource](https://docs.aws.amazon.com/step-functions/latest/apireference/API_TagResource.html)e [UntagResource](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UntagResource.html)API.
Le macchine a stati contengono anche proprietà che fanno parte di ogni versione[revision](concepts-cd-aliasing-versioning.md#statemachinerev), ma queste proprietà possono differire tra due versioni o revisioni specifiche. Queste proprietà includono la [definizione della macchina a stati](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html#StepFunctions-UpdateStateMachine-request-definition), il [ruolo IAM](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html#StepFunctions-UpdateStateMachine-request-roleArn), [la configurazione di tracciamento e la configurazione](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html#StepFunctions-UpdateStateMachine-request-tracingConfiguration) di [registrazione](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html#StepFunctions-UpdateStateMachine-request-loggingConfiguration).
## Pubblicazione di una versione di una macchina a stati (Console)
È possibile pubblicare fino a 1000 versioni di una macchina a stati. 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). È possibile eliminare manualmente le versioni non utilizzate dalla console o richiamando l'azione [DeleteStateMachineVersion](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteStateMachineVersion.html)API.
**Per pubblicare una versione 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 **Modifica**.
1. Modifica la definizione della macchina a stati come richiesto, quindi scegli **Salva**.
1. Scegliere **Publish version (Pubblica versione)**.
1. (Facoltativo) Nel campo **Descrizione** della finestra di dialogo che appare, inserisci una breve descrizione sulla versione della macchina a stati.
1. Seleziona **Pubblica**.
**Nota**
Quando pubblicate una nuova versione della vostra macchina a stati, Step Functions le assegna un numero di versione. I numeri di versione partono da 1 e aumentano in modo monotono per ogni nuova versione. I numeri di versione non vengono riutilizzati per una determinata macchina a stati. Se elimini la versione 10 della tua macchina a stati e poi pubblichi una nuova versione, Step Functions la pubblica come versione 11.
## Gestione delle versioni con le operazioni dell'API Step Functions
Step Functions fornisce le seguenti operazioni API per pubblicare e gestire le versioni delle macchine a stati:
+ [PublishStateMachineVersion](https://docs.aws.amazon.com/step-functions/latest/apireference/API_PublishStateMachineVersion.html)— Pubblica una versione della versione corrente [revision](concepts-cd-aliasing-versioning.md#statemachinerev) di una macchina a stati.
+ [UpdateStateMachine](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html)— Pubblica una nuova versione della macchina a stati se si aggiorna una macchina a stati e si imposta il `publish` parametro su `true` nella stessa richiesta.
+ [CreateStateMachine](https://docs.aws.amazon.com/step-functions/latest/apireference/API_CreateStateMachine.html)— Pubblica la prima revisione della macchina a stati se si imposta il `publish` parametro su. `true`
+ [ListStateMachineVersions](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListStateMachineVersions.html)— Elenca le versioni per l'ARN della macchina a stati specificata.
+ [DescribeStateMachine](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeStateMachine.html)— Restituisce i dettagli della versione della macchina a stati per una versione ARN specificata in. `stateMachineArn`
+ [DeleteStateMachineVersion](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteStateMachineVersion.html)— Elimina la versione di una macchina a stati.
Per pubblicare una nuova versione della revisione corrente di una macchina a stati chiamata `{{myStateMachine}}` utilizzando il AWS Command Line Interface, utilizzare il `publish-state-machine-version` comando:
```
aws stepfunctions publish-state-machine-version --state-machine-arn arn:aws:states:{{region}}:{{account-id}}:stateMachine:{{myStateMachine}}
```
La risposta restituisce il `stateMachineVersionArn`. Ad esempio, il comando precedente restituisce una risposta di`arn:aws:states:{{region}}:{{account-id}}:stateMachine:{{myStateMachine}}:1`.
**Nota**
Quando pubblicate una nuova versione della vostra macchina a stati, Step Functions le assegna un numero di versione. I numeri di versione partono da 1 e aumentano in modo monotono per ogni nuova versione. I numeri di versione non vengono riutilizzati per una determinata macchina a stati. Se elimini la versione 10 della tua macchina a stati e poi pubblichi una nuova versione, Step Functions la pubblica come versione 11.
## Esecuzione di una versione di macchina a stati dalla console
Per iniziare a utilizzare le versioni delle macchine a stati, è necessario prima pubblicare una versione dalla macchina a stati corrente[revision](concepts-cd-aliasing-versioning.md#statemachinerev). Per pubblicare una versione, usa la console Step Functions o richiama l'azione [PublishStateMachineVersion](https://docs.aws.amazon.com/step-functions/latest/apireference/API_PublishStateMachineVersion.html)API. Puoi anche richiamare l'azione [UpdateStateMachineAlias](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachineAlias.html)API con un parametro opzionale denominato `publish` per aggiornare una macchina a stati e pubblicarne la versione.
È possibile avviare l'esecuzione di una versione utilizzando la console o richiamando l'azione [StartExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartExecution.html)API e fornendo la versione ARN. Puoi anche usare un [alias](concepts-state-machine-alias.md) per avviare le esecuzioni di una versione. In base alla [configurazione di routing](concepts-state-machine-alias.md#alias-routing-config), un alias indirizza il traffico verso una versione specifica.
Se si avvia l'esecuzione di una macchina a stati senza utilizzare una versione, Step Functions utilizza la revisione più recente della macchina a stati per l'esecuzione. Per informazioni su come Step Functions associa un'esecuzione a una versione, vedere[Associazione delle esecuzioni a una versione o a un alias](execution-alias-version-associate.md).
**Per avviare un'esecuzione utilizzando una versione di 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 per la quale hai pubblicato una o più versioni. Per informazioni su come pubblicare una versione, consulta[Pubblicazione di una versione di una macchina a stati (Console)](#procedure-create-versions).
1. Nella pagina dei **dettagli della macchina a stati**, scegli la scheda **Versioni**.
1. Nella sezione **Versioni**, procedi come segue:
1. Seleziona la versione con cui vuoi iniziare l'esecuzione.
1. Selezionare **Start execution (Avvia esecuzione)**.
1. (Facoltativo) Nella finestra di dialogo **Avvia esecuzione**, inserite un nome per l'esecuzione.
1. (Facoltativo), immettete l'input di esecuzione, quindi scegliete **Avvia esecuzione**.