Versioni di macchine a stati nei flussi di lavoro Step Functions - AWS Step Functions
Pubblicazione di una versione di una macchina a stati (Console)Gestione delle versioni con APIsEsecuzione di una versione di macchina a stati dalla console

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 versioni a partire dalla revisione più recente apportata a quella macchina a stati. Ogni versione ha un Amazon Resource Name (ARN) univoco. Si ARN tratta di una combinazione di macchina a stati ARN e numero di versione separati da due punti (:). L'esempio seguente mostra il formato di una versione di una macchina a statiARN.

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, è possibile richiamare l'StartExecutionAPIazione con la versioneARN. Non puoi modificare una versione, ma puoi aggiornare una macchina a stati e pubblicare una nuova versione. Puoi anche pubblicare più versioni della tua macchina a stati.

Diagramma illustrativo fuzzy che mostra come le versioni siano istantanee immutabili di macchine a stati.

Quando pubblicate una nuova versione della vostra macchina a stati, Step Functions le assegna un numero di versione. I numeri di versione iniziano 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).

  • 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 UntagResourceAPIazioni TagResourceand.

Le macchine a stati contengono anche proprietà che fanno parte di ogni versionerevision, ma queste proprietà possono differire tra due versioni o revisioni specifiche. Queste proprietà includono la definizione della macchina a stati, IAMil ruolo, la configurazione di traccia e la configurazione di registrazione.

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 AWS Management Console. È possibile eliminare manualmente le versioni non utilizzate dalla console o richiamando l'DeleteStateMachineVersionAPIazione.

Per pubblicare una versione di una macchina a stati

  1. Apri la console Step Functions, quindi scegli una macchina a stati esistente.

  2. Nella pagina dei dettagli della macchina a stati, scegliete Modifica.

  3. Modifica la definizione della macchina a stati come richiesto, quindi scegli Salva.

  4. Scegliere Publish version (Pubblica versione).

  5. (Facoltativo) Nel campo Descrizione della finestra di dialogo che appare, inserisci una breve descrizione sulla versione della macchina a stati.

  6. Seleziona Publish (Pubblica).

Nota

Quando pubblicate una nuova versione della vostra macchina a stati, Step Functions le assegna un numero di versione. I numeri di versione iniziano 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 API operazioni Step Functions

Step Functions fornisce le seguenti API operazioni per pubblicare e gestire le versioni delle macchine a stati:

  • PublishStateMachineVersion— Pubblica una versione della versione corrente revision di una macchina a stati.

  • UpdateStateMachine— 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— Pubblica la prima revisione della macchina a stati se si imposta il publish parametro su. true

  • ListStateMachineVersions— Elenca le versioni per la macchina a stati specificata. ARN

  • DescribeStateMachine— Restituisce i dettagli della versione della macchina a stati per una versione ARN specificata instateMachineArn.

  • DeleteStateMachineVersion— 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:us-east-1:123456789012:stateMachine:myStateMachine

La risposta restituisce il stateMachineVersionArn. Ad esempio, il comando precedente restituisce una risposta diarn:aws:states:us-east-1:123456789012: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 iniziano 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 correnterevision. Per pubblicare una versione, usa la console Step Functions o richiama l'PublishStateMachineVersionAPIazione. È inoltre possibile richiamare l'UpdateStateMachineAliasAPIazione 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'StartExecutionAPIazione e fornendo la versione. ARN Puoi anche usare un alias per avviare le esecuzioni di una versione. In base alla configurazione di routing, 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, vedereAssociazione delle esecuzioni a una versione o a un alias.

Per avviare un'esecuzione utilizzando una versione di macchina a stati

  1. Apri la console Step Functions, quindi scegli una macchina a stati esistente per la quale hai pubblicato una o più versioni. Per informazioni su come pubblicare una versione, consultaPubblicazione di una versione di una macchina a stati (Console).

  2. Nella pagina dei dettagli della macchina a stati, scegli la scheda Versioni.

  3. Nella sezione Versioni, procedi come segue:

    1. Seleziona la versione con cui vuoi iniziare l'esecuzione.

    2. Selezionare Start execution (Avvia esecuzione).

  4. (Facoltativo) Nella finestra di dialogo Avvia esecuzione, inserite un nome per l'esecuzione.

  5. (Facoltativo), inserite l'input di esecuzione, quindi scegliete Avvia esecuzione.