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 operations without needing a dedicated node for each service or operation. For example, you can use it to manage S3 buckets, invoke Lambda functions, or configure AWS accounts by dynamically specifying the service and operation.

Practical scenarios include:

  • Automating AWS resource management across multiple services.
  • Integrating AWS API calls into workflows where specific AWS SDK functionality is required but no dedicated n8n node exists.
  • Quickly testing or prototyping AWS API calls within n8n.

Properties

Name Meaning
Region Choose the AWS region to use for the request. Options include all standard AWS regions such as US East (N. Virginia), EU (Frankfurt), Asia Pacific (Tokyo), etc.
Service Select the AWS service to interact with, e.g., S3, Lambda, EC2, IAM, DynamoDB, etc. A comprehensive list of AWS services is provided as options.
Version The API version to use for the selected AWS service. This property appears conditionally based on the chosen service and allows selecting the appropriate API version for that service.
Request Has Input Boolean flag indicating whether the AWS operation 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 operation. This must be correctly formatted according to the AWS SDK specification for the chosen operation. Only shown if "Request Has Input" is true.

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. Each output item is paired with its input item index.

  • json: Contains the full response object returned by the AWS SDK operation.
  • If the operation returns binary data, it would be included in the response JSON accordingly, but this node primarily handles JSON responses.

Dependencies

  • Requires valid AWS credentials configured in n8n (an API key credential with access key ID, secret access key, and optionally a session token).
  • Uses the AWS SDK for JavaScript v2 internally.
  • The node expects correct AWS service names, operation names, and input parameters as per AWS SDK documentation.
  • No additional environment variables are explicitly required beyond AWS credentials.

Troubleshooting

  • Invalid Service Error: If the specified service name is not recognized by the AWS SDK, the node throws an error stating the service is invalid. Ensure the service name matches exactly one of the supported AWS services.
  • Invalid Operation Error: If the operation name does not exist for the selected service, an error is thrown. Verify the operation name corresponds to a valid method of the AWS service client.
  • Credential Errors: If AWS credentials are missing or incomplete, the node will throw an error asking to set credentials properly.
  • Malformed Input: The Request Input must be valid JSON matching the expected input structure for the AWS operation. Invalid JSON or incorrect parameters will cause the AWS SDK call to fail.
  • Continue On Fail: If enabled, the node will continue processing subsequent items even if some fail, returning error details alongside successful results.

Links and References

Discussion