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 GetCertificate operation under the Default resource (which corresponds to the ACM service), this node retrieves details about an AWS Certificate Manager (ACM) certificate. This can be beneficial in scenarios where you need to programmatically fetch certificate information for monitoring, auditing, or automation workflows involving SSL/TLS certificates.

Example use cases:

  • Automatically retrieve and verify SSL certificate details before deploying infrastructure.
  • Integrate certificate status checks into CI/CD pipelines.
  • Audit certificates across multiple AWS regions.

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 (Ireland), Asia Pacific (Tokyo), etc.
Service Select the AWS service to interact with. For GetCertificate, this should be set to ACM. The node supports a wide range of AWS services.
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 GetCertificate, this should be true because the operation requires input (e.g., certificate ARN).
Request Input JSON string representing the input parameters for the AWS SDK operation. For GetCertificate, this would typically include the certificate ARN in the correct format expected by the ACM getCertificate API call.

Output

The output is a JSON object containing the response from the AWS SDK call to the specified service and operation.

For the GetCertificate operation, the output JSON will contain the certificate details returned by the ACM service, including fields such as:

  • CertificateArn
  • Certificate
  • CertificateChain
  • KeyAlgorithm
  • SignatureAlgorithm
  • Status
  • NotBefore
  • NotAfter
  • Issuer
  • Subject
  • Serial
  • RenewalSummary
  • etc.

The exact structure matches the AWS ACM getCertificate API response.

No binary data output is produced by this operation.

Dependencies

  • Requires valid AWS credentials with permissions to access the specified service and operation (e.g., ACM permissions to get certificate details).
  • The node uses the AWS SDK for JavaScript v2 internally.
  • AWS region must be correctly specified.
  • Proper API version selection for the service is required (default versions are provided).

Troubleshooting

  • Invalid Service Error: If the service name is incorrect or not supported, the node throws an error stating the service is invalid. Ensure the service name matches one of the AWS SDK service names.
  • Invalid Operation Error: If the operation name does not exist for the chosen service, an error is thrown. Verify the operation name is correct and supported by the AWS service.
  • Credential Errors: If AWS credentials are missing or incomplete (missing access key or secret key), the node will throw an error. Make sure credentials are properly configured in n8n.
  • Malformed Input: The Request Input property expects a valid JSON string matching the AWS SDK operation's input schema. Invalid JSON or incorrect parameters will cause the AWS SDK call to fail.
  • Region Issues: Using an unsupported or incorrect AWS region may result in errors. Confirm the region is valid for the service and operation.
  • API Version Mismatch: Although defaults are provided, using an incorrect API version might cause unexpected errors. Use the recommended version for the service.

Links and References

This summary focuses on the GetCertificate operation of the Default resource (ACM service) within the AWS SDK Wrapper node, describing its usage, inputs, outputs, dependencies, and common troubleshooting tips.

Discussion