Actions8
Overview
This node integrates with AWS Step Functions, specifically enabling interaction with tasks managed by Step Functions workflows. The "Send Task Failure" operation allows the user to report a failure for a specific task identified by a task token. This is useful in scenarios where a worker or external process needs to notify Step Functions that a task it was assigned has failed, providing error details and cause information.
Practical examples include:
- Reporting a failure when an external service or manual step cannot complete its work.
- Integrating custom error handling logic into Step Functions workflows by signaling task failures programmatically.
- Automating retries or compensating transactions based on failure reports sent from this node.
Properties
| Name | Meaning |
|---|---|
| Task Token | The token representing the specific task to report failure for. These tokens are generated by Step Functions when tasks are assigned to workers or appear in the workflow context during task states. |
| Error | The error code string describing the type of failure encountered. |
| Cause | A more detailed explanation or message describing the cause of the failure. |
Output
The output JSON contains the response from the AWS Step Functions API after sending the task failure. Typically, this response is empty or minimal since the operation mainly acknowledges receipt of the failure report.
No binary data is produced by this operation.
Dependencies
- Requires valid AWS credentials with permissions to interact with AWS Step Functions.
- The node uses the AWS SDK internally to call the
sendTaskFailureAPI. - AWS region must be specified as part of the credentials configuration.
- Proper task tokens must be obtained from Step Functions workflow executions to identify tasks.
Troubleshooting
- Invalid or expired task token: If the task token is incorrect or expired, the API will reject the failure report. Ensure the token is current and correctly copied from the workflow context.
- Insufficient permissions: The AWS credentials used must have permission to call
SendTaskFailure. Lack of permissions will result in authorization errors. - Missing required parameters: Omitting the task token or error code may cause the request to fail validation.
- Network or AWS service issues: Temporary connectivity problems or AWS service outages can cause failures; retrying later may help.
- Error messages typically include AWS SDK error responses indicating invalid tokens, access denied, or parameter validation errors. Review these messages to adjust inputs or credentials accordingly.