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 dynamically. It is particularly useful when you want to perform various AWS operations without needing a dedicated node for each service or operation.

For the DeleteCertificate operation under the Default resource (which corresponds to the ACM service), this node enables deleting an ACM certificate by providing the necessary input parameters.

Practical examples:

  • Deleting an ACM SSL/TLS certificate by specifying its ARN.
  • Performing any other AWS service operation by configuring the service, operation, and request input JSON accordingly.

Properties

Name Meaning
Region Choose the AWS region where the service request will be executed. Examples include "US East (N. Virginia)", "EU (Ireland)", "Asia Pacific (Tokyo)", etc. Default is "us-east-1".
Service Select the AWS service to use. This node supports all AWS services available in the AWS SDK v2, such as ACM, S3, Lambda, EC2, etc. For DeleteCertificate, the relevant service is "ACM".
Version The API version of the selected AWS service to use. Different services have different versions; for ACM, the default is "2015-12-08".
Request Has Input Boolean indicating whether the AWS operation requires input parameters. For example, some operations like listing buckets do not require input, while others like deleting a certificate do. Default is true.
Request Input JSON string representing the input parameters for the AWS operation. This must be correctly formatted according to the AWS SDK documentation for the chosen service and operation. For DeleteCertificate, this would include the certificate ARN.

Output

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

  • json: The response from the AWS SDK operation call. For DeleteCertificate, this typically includes confirmation of deletion or an empty object if successful.
  • pairedItem: The index of the input item that produced this output.

If the operation returns binary data (not typical for DeleteCertificate), it would be included accordingly, but for this operation, only JSON output is expected.

Dependencies

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

Troubleshooting

  • Invalid Service Error: If the specified service name is incorrect or unsupported, the node throws an error stating the service is invalid. Ensure 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. Verify the operation name against AWS SDK documentation.
  • Credential Errors: If AWS credentials are missing or incomplete, the node will throw an error. Make sure the credentials include access key ID and secret access key, and optionally a session token.
  • Malformed Input JSON: The Request Input property must be valid JSON matching the expected input structure for the operation. Invalid JSON or incorrect parameters will cause the AWS SDK call to fail.
  • Permission Denied: If the AWS user/role lacks permission to delete certificates, the operation will fail. Ensure the IAM policy allows acm:DeleteCertificate.
  • Region Mismatch: Deleting a certificate requires specifying the correct region where the certificate exists. Using the wrong region may result in errors or no action.

Links and References

Discussion