AWS SDK Wrapper icon

AWS SDK Wrapper

Implements the NPM AWS SDK packages; starts with V2 for all services and migrating to V3 for each service over time.
Join our community

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. It is useful when you want to perform various AWS API calls without needing a dedicated node for each service or operation. For example, you can retrieve account configuration details from the AWS Account service or list buckets in S3 by configuring the appropriate service and operation.

Properties

Name Meaning
Region Choose the AWS region where the service request will be sent. Examples include US East (N. Virginia), EU (Frankfurt), Asia Pacific (Tokyo), etc.
Service Select the AWS service to use for the request. Options include a wide range of AWS services such as S3, EC2, Lambda, IAM, Account, and many others.
Version The API version to use for the selected AWS service. This property appears dynamically based on the chosen service and allows selecting the specific API version for that service.
Request Has Input Boolean flag indicating whether the request requires input parameters. Set to false if the operation does not require any input (e.g., listing buckets).
Request Input JSON string representing the input parameters for the AWS service operation. This must be correctly formatted according to the AWS SDK API specification for the chosen operation.

Output

The node outputs an array of items, each containing a json field with the response data returned from the AWS SDK call. The structure of this JSON depends entirely on the AWS service and operation invoked. If the 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 configured in n8n (an API key credential with accessKeyId, secretAccessKey, and optionally sessionToken).
  • Uses the AWS SDK for JavaScript v2 internally.
  • No additional external dependencies beyond the AWS SDK and n8n environment.

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 one of the supported AWS services.
  • Invalid Operation Error: If the operation name does not exist for the selected service, an error is thrown. Ensure the operation name corresponds exactly to an AWS SDK method for that service.
  • Credential Issues: Errors related to missing or invalid credentials occur if the AWS access key or secret key are not set properly. Confirm that the credentials are correctly configured in n8n.
  • Malformed Input: Since the request input is a raw JSON string, malformed JSON or incorrect parameters for the operation may cause AWS API errors. Validate the JSON format and refer to AWS SDK documentation for correct input structure.
  • Continue On Fail: If enabled, the node will continue processing subsequent items even if one fails, returning the error details alongside the input data.

Links and References

Discussion