Estado de flujo de trabajo fallido - AWS Step Functions
Ejemplos de definición de estado Fail

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Estado de flujo de trabajo fallido

Un estado Fail ("Type": "Fail") detiene la ejecución de la máquina de estado y la marca como errónea, a menos que lo detecte un bloque Catch.

El estado Fail solo permite el uso de los campos Type y Comment del conjunto de campos de estado comunes. Además, el estado permite Fail los siguientes campos.

Cause (opcional)

Cadena personalizada que describe la causa del error. Puede especificar este campo con fines operativos o de diagnóstico.

CausePath (opcional)

Si desea proporcionar una descripción detallada de la causa del error de forma dinámica a partir de la entrada de estado utilizando una ruta de referencia, utilice CausePath. Una vez resuelto, la ruta de referencia debe seleccionar un campo que contenga un valor de cadena.

También puede especificar CausePath mediante una función intrínseca que devuelva una cadena. Estos elementos intrínsecos son: States.Format, States.JsonToString, States.ArrayGetItem, States.Base64Encode, States.Base64Decode, States.Hash y States.UUID.

importante

  • Puede especificar Cause o CausePath, pero no ambos, en su definición de estado Fail.

  • Como práctica recomendada de seguridad de la información, le aconsejamos que elimine de la descripción de la causa toda la información confidencial y los detalles del sistema interno.

Error (opcional)

Un nombre de error que pueda proporcionar para gestionar los errores mediante los campos Retry o Catch. También puede proporcionar un nombre de error con fines operativos o de diagnóstico.

ErrorPath (opcional)

Si desea proporcionar un nombre para el error de forma dinámica a partir de la entrada de estado utilizando una ruta de referencia, utilice ErrorPath. Una vez resuelto, la ruta de referencia debe seleccionar un campo que contenga un valor de cadena.

También puede especificar ErrorPath mediante una función intrínseca que devuelva una cadena. Estos elementos intrínsecos son: States.Format, States.JsonToString, States.ArrayGetItem, States.Base64Encode, States.Base64Decode, States.Hash y States.UUID.

importante

  • Puede especificar Error o ErrorPath, pero no ambos, en su definición de estado Fail.

  • Como práctica recomendada de seguridad de la información, le aconsejamos que elimine del nombre del error toda la información confidencial y los detalles del sistema interno.

Como el estado Fail siempre cierra la máquina de estado, no existe un campo Next ni se requiere un campo End.

Ejemplos de definición de estado Fail

En el siguiente ejemplo de definición de estado Fail se especifican valores de campo Error y Cause estáticos.

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

En el siguiente ejemplo de definición de estado Fail, se utilizan rutas de referencia de forma dinámica para resolver los valores de campo de Error y Cause.

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

En el siguiente ejemplo de definición de estado Fail, se utiliza la función intrínseca States.Format para especificar los valores de campo Error y Cause campo de forma dinámica.

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