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 un alias basato su Amazon Resource Name (ARN) che usi per richiamare l'azione. StartExecutionAPI Step Functions esegue questa azione all'inizio dell'esecuzione.
È possibile avviare l'esecuzione di una macchina a stati utilizzando una macchina a stati qualificata o non qualificataARN.
-
Qualificata ARN: si riferisce a una macchina a stati con il ARN suffisso un numero di versione o un nome alias.
Il seguente ARN esempio qualificato si riferisce alla versione
3
di una macchina a stati denominata.myStateMachine
arn:aws:
states:us-east-1
:123456789012
:stateMachine:myStateMachine
:3Il seguente ARN esempio qualificato si riferisce a un alias denominato
PROD
di una macchina a stati denominatamyStateMachine
.arn:aws:
states:us-east-1
:123456789012
:stateMachine:myStateMachine
:PROD
-
Non qualificata ARN: si riferisce a una macchina a stati ARN senza un numero di versione o un suffisso del nome alias.
arn:aws:
states:us-east-1
:123456789012
:stateMachine:myStateMachine
Ad esempio, se il nome qualificato ARN si riferisce alla versione3
, Step Functions associa l'esecuzione a questa versione. Non associa l'esecuzione a nessun alias che rimanda alla versione. 3
Se il tuo qualificato ARN si riferisce a un alias, Step Functions associa l'esecuzione a quell'alias e alla versione a cui punta l'alias. Un'esecuzione può essere associata a un solo alias.
Nota
Se si avvia un'esecuzione con un valore non qualificatoARN, Step Functions non associa tale esecuzione a una versione anche se la versione utilizza la stessa macchina revision a stati. Ad esempio, se la versione 3 utilizza la revisione più recente, ma si avvia un'esecuzione con un valore non qualificatoARN, 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
È possibile visualizzare tutte le esecuzioni associate a una versione o a un alias richiamando le DescribeExecutionazioni and. ListExecutionsAPI Queste API azioni restituiscono ARN la versione o l'alias utilizzati per avviare l'esecuzione. Queste azioni restituiscono anche altri dettagli, tra cui lo stato e ARN l'esecuzione.
È inoltre possibile fornire un alias ARN o una versione della macchina a stati ARN per elencare le esecuzioni associate a un alias o a una versione specifici.
Il seguente esempio di risposta dell'ListExecutionsAPIazione mostra l'alias utilizzato per avviare un'esecuzione ARN di una macchina a stati denominata myFirstExecution
.
Il italicized
il testo nel seguente frammento di codice rappresenta informazioni specifiche della risorsa.
{
"executions": [
{
"executionArn": "arn:aws:states:us-east-1
:123456789012
:execution:myStateMachine:myFirstExecution
",
"stateMachineArn": "arn:aws:states:us-east-1
:123456789012
:stateMachine:myStateMachine
",
"stateMachineAliasArn": "arn:aws:states:us-east-1
:123456789012
: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
-
Apri la console Step Functions
, quindi scegli una macchina a stati esistente per la quale hai pubblicato una versione o creato un alias. Questo esempio mostra come visualizzare le esecuzioni iniziate con una versione specifica della macchina a stati. -
Scegliete la scheda Versioni, quindi scegliete una versione dall'elenco Versioni.
Suggerimento
Filtra per proprietà o casella di valore per cercare una versione specifica.
-
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
. Questo elenco mostra anche un'esecuzione che è stata avviata da un alias denominato. MathAddDemo
Questo alias ha indirizzato il traffico di esecuzione alla versione 4.PROD
![Schermata illustrativa della pagina della console con i dettagli della versione della macchina a stati.](images/view-version-executions.png)
Utilizzo delle metriche CloudWatch
Per ogni esecuzione di una macchina a stati che si inizia con aQualified ARN, 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 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 iniziato l'esecuzione con una versioneARN, Step Functions pubblica la metrica con StateMachineArn
e una seconda metrica con StateMachineArn
e dimensioni. Version
Se hai avviato l'esecuzione con un aliasARN, Step Functions emette le seguenti metriche:
-
Due metriche per la versione non qualificata e. ARN
-
Una metrica con le dimensioni e
StateMachineArn
.Alias