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 services, 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 import a certificate into AWS Certificate Manager (ACM) by selecting the ACM service, choosing the importCertificate operation, and providing the necessary certificate data in JSON format. This flexibility makes it ideal for automating workflows that involve multiple AWS services or less common AWS API calls.

Properties

Name Meaning
Region Choose the AWS region where the service request will be sent. 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. Examples include ACM, S3, Lambda, EC2, DynamoDB, and many others.
Version Specify the API version of the selected AWS service. The available versions depend on the chosen service.
Operation The specific operation to perform on the selected AWS service. For example, for ACM, an operation could be importCertificate.
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).
Request Input JSON string representing the input parameters for the AWS service operation. Must be correctly formatted according to the AWS SDK API specification for the chosen operation.

Output

The node outputs an array of JSON objects, each corresponding to one input item processed. Each output object contains:

  • json: The response from the AWS SDK call, which includes the data returned by the specified AWS service operation.
  • pairedItem: The index of the input item this output corresponds to.

If the AWS operation returns binary data, it will be included in the json output field as part of the response structure.

Dependencies

  • Requires valid AWS credentials with appropriate permissions for the selected service and operation.
  • The node uses the AWS SDK for JavaScript v2 internally.
  • AWS credentials must be configured in n8n and linked to the node.
  • No additional environment variables are required beyond the AWS credentials.

Troubleshooting

  • Invalid Service Error: If you receive an error stating the service is invalid, verify that the service name matches exactly one of the supported AWS services.
  • Invalid Operation Error: If the operation is not recognized for the selected service, check the spelling and case of the operation name. Operations are case-sensitive and typically camelCase.
  • Credential Errors: Errors related to missing or invalid credentials indicate that the AWS API key and secret are not properly set or lack necessary permissions.
  • Malformed Input: Since the request input is a raw JSON string, ensure it is well-formed and matches the expected input schema for the AWS operation.
  • Continue On Fail: If enabled, the node will continue processing subsequent items even if one fails, returning error details in the output.

Links and References

This summary focuses on the "Default" resource and the "ImportCertificate" operation context, describing how to configure and use the node for importing certificates via AWS ACM.

Discussion