AWS SDK Wrapper
Actions15
Overview
The AWS SDK Wrapper node allows users to interact with any AWS service by making direct API calls using the AWS SDK for JavaScript (v2). It supports a wide range of AWS services and operations, enabling flexible integration with AWS resources. This node is beneficial when you want to perform custom or less common AWS operations that are not covered by dedicated n8n nodes.
For example, you can use this node to update certificate options in AWS Certificate Manager (ACM), manage S3 buckets, invoke Lambda functions, or interact with any other AWS service by specifying the service name, operation, and input parameters.
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. Default is "us-east-1". |
| Service | Select the AWS service to use for the request. The list includes all supported AWS services such as ACM, S3, Lambda, EC2, DynamoDB, and many more. |
| Version | Specify the API version to use for the selected AWS service. Different services have different available versions; the default version is preselected based on the service. |
| Operation | The specific operation to perform on the chosen AWS service. For example, for ACM, operations might include updating certificate options. |
| Request Has Input | Boolean flag indicating whether the operation requires input parameters. Set to false if the operation does not require any input (e.g., listing buckets). Default is true. |
| Request Input | JSON string representing the input parameters for the AWS service operation. This must be correctly formatted according to the AWS SDK documentation for the chosen operation. |
Output
The node outputs an array of items, each containing a json field with the response from the AWS SDK call. The structure of the json output depends on the AWS service and operation invoked. It directly reflects the data returned by the AWS SDK for the specified operation.
If the AWS operation returns binary data, it would be included in the output accordingly, but this node primarily handles JSON responses from AWS SDK calls.
Dependencies
- Requires valid AWS credentials with appropriate permissions for the requested service and operation.
- The node uses the AWS SDK for JavaScript v2 internally.
- Users must configure AWS API credentials (access key ID, secret access key, and optionally session token) in n8n credentials to authenticate requests.
- Proper AWS IAM permissions are necessary to successfully execute the chosen operations.
Troubleshooting
- Invalid Service Error: If the specified AWS service name is incorrect or unsupported, the node throws an error stating the service is not valid. Verify the service name matches AWS SDK service identifiers.
- Invalid Operation Error: If the operation name does not exist for the selected service, an error is thrown. Ensure the operation name is correct and supported by the AWS SDK for that service.
- Credential Issues: Errors related to missing or invalid credentials occur if AWS credentials are not set or incomplete. Confirm that the AWS credentials are properly configured in n8n and have the required permissions.
- Malformed Input: Providing incorrectly formatted JSON in the "Request Input" property can cause parsing errors or AWS API errors. Validate the JSON input against AWS SDK requirements for the operation.
- API Version Mismatch: Using an incompatible API version for the service may lead to unexpected errors. Use the recommended or default API version unless a specific version is needed.