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 particularly useful when you want to perform operations on various AWS services without needing dedicated nodes for each service.

For the ListCertificates operation under the Default resource (which corresponds to the ACM service), this node lists the certificates managed by AWS Certificate Manager in the specified region.

Common scenarios:

  • Automating certificate management workflows by listing all certificates.
  • Integrating AWS ACM data into broader automation pipelines.
  • Fetching certificate details dynamically for monitoring or auditing purposes.

Example:
You can use this node to list all ACM certificates in the "us-east-1" region, then filter or process them further in your workflow.

Properties

Name Meaning
Region The AWS region where the request will be sent. Options include all standard AWS regions such as US East (N. Virginia), EU (Ireland), Asia Pacific (Tokyo), etc. Default is "us-east-1".
Service The AWS service to use. For ListCertificates, this should be set to "ACM". The node supports a wide range of AWS services (e.g., S3, EC2, Lambda, etc.).
Version The API version to use for the selected service. For ACM, the default and only option is "2015-12-08".
Request Has Input Boolean indicating whether the request requires input parameters. For ListCertificates, this would typically be true if you want to specify filters or pagination; false if no input is needed.
Request Input JSON object representing the input parameters for the AWS SDK operation. This must be correctly formatted according to the AWS SDK documentation for the specific operation. For ListCertificates, it can include filters.

Output

The output is an array of items, each containing a json field with the response from the AWS SDK call.

For the ListCertificates operation, the json output contains the list of certificates returned by AWS ACM. This includes details such as certificate ARNs, domain names, statuses, and other metadata as provided by the AWS SDK.

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

Dependencies

  • Requires valid AWS credentials with permissions to access the specified AWS service (e.g., ACM for ListCertificates).
  • The node uses the AWS SDK for JavaScript v2 internally.
  • You must configure AWS credentials in n8n (an API key credential with accessKeyId, secretAccessKey, and optionally sessionToken).
  • Network access to AWS endpoints for the chosen region and service.

Troubleshooting

  • Invalid service error: If you specify a service name that does not exist or is misspelled, the node throws an error stating the service is invalid.
  • Invalid operation error: If the operation name is incorrect or not supported by the chosen service, an error indicates the operation is invalid.
  • Credential errors: Missing or incorrect AWS credentials cause errors. Ensure credentials are properly configured and have necessary permissions.
  • Malformed input: The Request Input JSON must be valid and conform to the AWS SDK's expected input structure. Invalid JSON or incorrect parameters will cause the AWS SDK to return errors.
  • Region issues: Using a region that does not support the service or operation may result in errors.
  • To resolve errors, verify service and operation names, check credentials, validate JSON input, and confirm region compatibility.

Links and References

Discussion