Stato del flusso di lavoro fallito - AWS Step Functions
Esempi di definizione dello stato di errore

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à.

Stato del flusso di lavoro fallito

Uno Fail state ("Type": "Fail") interrompe l'esecuzione della macchina a stati e la contrassegna come un errore, a meno che non venga intercettata da un Catch blocco.

Lo stato Fail autorizza soltanto l'utilizzo dei campi Type e Comment dal set di campi di stato comuni. Inoltre, lo stato Fail consente i seguenti campi.

Cause (facoltativo).

Una stringa personalizzata che descrive la causa dell'errore. È possibile specificare questo campo per scopi operativi o diagnostici.

CausePath (facoltativo).

Se si desidera fornire una descrizione dettagliata della causa dell'errore in modo dinamico a partire dallo stato immesso utilizzando un percorso di riferimento, utilizzareCausePath. Una volta risolto, il percorso di riferimento deve selezionare un campo che contiene un valore di stringa.

È inoltre possibile specificare CausePath utilizzando una funzione intrinseca che restituisce una stringa. Questi elementi intrinseci sono: States.Format,,,,States.JsonToString, States.ArrayGetItem States.Hash e. States.Base64EncodeStates.Base64Decode States.UUID

Importante

  • È possibile specificare uno Cause o entrambiCausePath, ma non entrambi nella definizione dello stato Fail.

  • Come best practice in materia di sicurezza delle informazioni, consigliamo di rimuovere tutte le informazioni sensibili o i dettagli interni del sistema dalla descrizione della causa.

Error (facoltativo).

Un nome di errore che è possibile fornire per eseguire la gestione degli errori utilizzando i campi Retry o Catch. È inoltre possibile fornire un nome di errore per scopi operativi o diagnostici.

ErrorPath (facoltativo).

Se si desidera fornire un nome per l'errore in modo dinamico a partire dall'input dello stato utilizzando un percorso di riferimento, utilizzareErrorPath. Una volta risolto, il percorso di riferimento deve selezionare un campo che contiene un valore di stringa.

È inoltre possibile specificare ErrorPath utilizzando una funzione intrinseca che restituisce una stringa. Questi elementi intrinseci sono: States.Format,,,,States.JsonToString, States.ArrayGetItem States.Hash e. States.Base64EncodeStates.Base64Decode States.UUID

Importante

  • È possibile specificare uno Error o entrambiErrorPath, ma non entrambi nella definizione dello stato Fail.

  • Come best practice in materia di sicurezza delle informazioni, si consiglia di rimuovere dal nome dell'errore tutte le informazioni riservate o i dettagli interni del sistema.

Poiché gli stati Fail escono sempre dalla macchina a stati, non hanno campi Next e non richiedono un campo End.

Esempi di definizione dello stato di errore

Il seguente esempio di definizione dello stato di errore specifica i valori statici Error e di Cause campo.

"FailState": {
  "Type": "Fail",
  "Cause": "Invalid response.",
  "Error": "ErrorA"
}

Il seguente esempio di definizione dello stato Fail utilizza i percorsi di riferimento in modo dinamico per risolvere i valori dei Cause campi Error e.

"FailState": {
  "Type": "Fail",
  "CausePath": "$.Cause",
  "ErrorPath": "$.Error"
}

Il seguente esempio di definizione dello stato Fail utilizza la funzione intrinseca States.Format per specificare dinamicamente i valori dei Error campi e. Cause

"FailState": {
  "Type": "Fail",
  "CausePath": "States.Format('This is a custom error message for {}, caused by {}.', $.Error, $.Cause)",
  "ErrorPath": "States.Format('{}', $.Error)"
}