AWS SDK Wrapper
Actions15
Overview
This node acts as a generic wrapper for AWS SDK service requests, allowing users to interact with any AWS service by specifying the service name, operation, and input parameters dynamically. It is particularly useful when you want to perform various AWS operations without needing a dedicated node for each service or operation.
For example, you can use this node to export an ACM certificate by selecting the "ACM" service and the "exportCertificate" operation, providing the necessary input parameters in JSON format. This flexibility enables automation workflows that integrate deeply with AWS services, such as managing certificates, querying S3 buckets, or invoking Lambda functions.
Properties
| Name | Meaning |
|---|---|
| Region | Choose the AWS region where the service request will be executed. Examples include "US East (N. Virginia)", "EU (Frankfurt)", "Asia Pacific (Tokyo)", etc. |
| Service | Select the AWS service to interact with. Options include a wide range of AWS services like ACM, S3, Lambda, EC2, DynamoDB, and many more. |
| Version | Specify the API version to use for the selected AWS service. The available versions depend on the chosen service. |
| Request Has Input | Boolean flag indicating whether the AWS operation requires input parameters. Set to false if the operation does not require input (e.g., listing buckets). |
| Request Input | JSON string representing the input parameters for the AWS operation. Must be correctly formatted according to the AWS SDK documentation for the selected operation. |
Output
The node outputs an array of items, each containing a json field with the response from the AWS SDK call corresponding to the requested operation. The structure of the output JSON depends entirely on the AWS service and operation invoked.
If the AWS operation returns binary data, it will be included in the output accordingly, but this node primarily handles JSON responses.
Dependencies
- Requires valid AWS credentials with appropriate permissions for the selected service and operation.
- The node uses the AWS SDK for JavaScript v2 internally.
- Users must configure AWS credentials (access key ID, secret access key, and optionally session token) in n8n's credential manager.
- The node dynamically loads the AWS service client based on the selected service and version.
Troubleshooting
- Invalid Service Error: If you receive an error stating the service is not valid, verify that the service name matches one of the supported AWS services exactly.
- Invalid Operation Error: If the operation is invalid for the selected service, check the AWS SDK documentation for the correct operation name and ensure it is camelCase starting with a lowercase letter.
- Credential Errors: Errors related to missing or invalid credentials indicate that the AWS credentials are not properly configured or lack required permissions.
- JSON Parsing Errors: Ensure that the "Request Input" JSON is well-formed and matches the expected input schema for the AWS operation.
- No Input Required: For operations that do not require input parameters, set "Request Has Input" to false to avoid parsing errors.