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.

Overview

This node acts as a generic AWS SDK wrapper, 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 operations on AWS services that may not have dedicated nodes in n8n or when you need to access specific API operations directly.

For the RemoveTagsFromCertificate operation under the Default resource (which corresponds to the ACM service), this node enables removing tags from an AWS Certificate Manager (ACM) certificate by calling the appropriate AWS SDK method.

Practical examples:

  • Removing metadata tags from an ACM certificate to manage resource organization or billing.
  • Automating tag cleanup for certificates as part of a larger AWS infrastructure management workflow.
  • Integrating with other AWS services by dynamically invoking various AWS SDK operations without needing separate nodes.

Properties

Name Meaning
Region 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 The AWS service to use. This node supports all AWS services available in the AWS SDK v2, including ACM, S3, Lambda, EC2, and many others.
Version The API version to use for the selected AWS service. Different services have different versions; the default is set per service (e.g., "2015-12-08" for ACM).
Request Has Input Boolean flag indicating whether the operation requires input parameters. For example, some operations like listing buckets do not require input, so this can be set to false.
Request Input JSON string representing the input parameters for the AWS SDK operation. This must be correctly formatted according to the AWS SDK documentation for the chosen operation.

Output

The output of the node is an array of JSON objects, each corresponding to the result of the AWS SDK operation for each input item processed. Each output item contains:

  • json: The full response object returned by the AWS SDK call for the specified operation.
  • pairedItem: The index of the input item this output corresponds to.

For the RemoveTagsFromCertificate operation, the output JSON will contain the response from the AWS ACM service's removeTagsFromCertificate method, which typically does not return data if successful but may include metadata or confirmation.

This node does not output binary data.

Dependencies

  • Requires valid AWS credentials with permissions to perform the specified operation (e.g., permissions to remove tags from ACM certificates).
  • The node uses the AWS SDK for JavaScript v2 internally.
  • AWS credentials must be configured in n8n and linked to the node.
  • Network connectivity to AWS endpoints for the selected region.

Troubleshooting

  • Invalid Service Error: If the specified service name is incorrect or unsupported, the node throws an error stating the service is invalid. Verify the service name matches AWS SDK service names exactly.
  • 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 Errors: If AWS credentials are missing or incomplete (missing access key or secret key), the node will throw an error. Confirm that credentials are properly set up in n8n.
  • Malformed Input: The Request Input property must be valid JSON matching the expected input structure for the AWS SDK operation. Invalid JSON or incorrect parameter names/types will cause the AWS SDK call to fail.
  • Permissions Issues: Insufficient IAM permissions for the AWS credentials used will result in authorization errors. Make sure the credentials have the necessary permissions for the operation.
  • Region Mismatch: Using a region where the service or resource does not exist can cause errors. Select the correct region for your resources.

Links and References

Discussion