Actions8
Overview
This node integrates with AWS Step Functions to interact with state machine executions and tasks. Specifically, the "Send Task Success" operation reports to AWS Step Functions that a particular task, identified by a task token, has completed successfully. This is useful in workflows where an external worker or process performs a task asynchronously and needs to notify Step Functions of its successful completion.
Common scenarios include:
- Reporting the successful completion of a manual or automated task within a Step Functions workflow.
- Integrating external systems or services that perform work outside of AWS Step Functions but need to update the workflow status.
- Coordinating long-running or asynchronous jobs by signaling success back to the state machine.
Example: A workflow assigns a task to an external service via a task token. Once the service finishes processing, it uses this node to send the success signal along with any output data, allowing the workflow to continue.
Properties
| Name | Meaning |
|---|---|
| Task Token | The token representing the specific task assigned by AWS Step Functions. It authenticates and identifies the task to report success for. |
| Output | The JSON-formatted output data of the task. This data is sent back to Step Functions as the result of the task. Payload size limits apply (UTF-8 bytes). |
Output
The node outputs a JSON object reflecting the response from AWS Step Functions after reporting task success. Typically, this response is empty or contains metadata confirming the success of the API call.
No binary data output 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 communicate with the Step Functions API.
- AWS region must be specified in the credentials configuration.
- The user must provide a valid task token generated by Step Functions when the task was assigned.
Troubleshooting
- Invalid or expired task token: If the task token is incorrect or expired, the API call will fail. Ensure the token is copied correctly and used promptly.
- Insufficient AWS permissions: The AWS credentials must have permission to call
SendTaskSuccess. Lack of permissions will cause authorization errors. - Payload size exceeded: The output JSON must respect AWS Step Functions payload size limits (in bytes UTF-8 encoded). Large outputs may cause failures.
- Network or connectivity issues: Failures to reach AWS endpoints can cause errors; verify network access and AWS endpoint availability.
- Error handling: If the node is configured to continue on failure, errors will be attached to the output item; otherwise, execution stops with an error.