Actions8
Overview
This node integrates with AWS Step Functions, allowing users to interact programmatically with state machine executions. Specifically, the "Describe Execution" operation retrieves detailed information about a particular execution of a state machine using its Amazon Resource Name (ARN). This is useful for monitoring and debugging workflows by fetching the current status, start time, stop time, input, output, and other metadata related to an execution.
Common scenarios include:
- Checking the status of a running or completed workflow execution.
- Retrieving execution details to log or audit workflow runs.
- Debugging failed executions by examining their metadata.
Example: A user can provide the ARN of a specific execution to get its current status and output data, helping them decide subsequent automation steps based on the execution result.
Properties
| Name | Meaning |
|---|---|
| Execution ARN | The Amazon Resource Name (ARN) of the execution to describe. This uniquely identifies the execution whose details are to be retrieved. |
Output
The node outputs a JSON object containing all the details returned by the AWS Step Functions describeExecution API call. This includes fields such as:
executionArn: The ARN of the execution.stateMachineArn: The ARN of the state machine.name: The name of the execution.status: Current status of the execution (e.g., RUNNING, SUCCEEDED, FAILED).startDate: Timestamp when the execution started.stopDate: Timestamp when the execution stopped (if applicable).input: The JSON input provided to the execution.output: The JSON output produced by the execution (if available).- Other metadata related to the execution lifecycle.
No binary data is output by this operation.
Dependencies
- Requires valid AWS credentials with permissions to access AWS Step Functions.
- The node uses the AWS SDK for JavaScript to communicate with AWS services.
- The user must configure AWS credentials in n8n that include access key ID, secret access key, and region.
Troubleshooting
- Invalid ARN: If the provided execution ARN is incorrect or does not exist, the node will throw an error indicating the resource was not found. Verify the ARN format and existence.
- Permission Denied: Insufficient AWS IAM permissions will cause authorization errors. Ensure the credentials have the necessary Step Functions read permissions.
- Network Issues: Connectivity problems to AWS endpoints may cause timeouts or request failures. Check network settings and AWS service availability.
- Malformed Input: Although this operation only requires the ARN, ensure no extra invalid parameters are passed.
If the node is set to continue on failure, it will append error details to the output for each failed item instead of stopping execution.