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 the RequestCertificate operation under the Default resource (which corresponds to the ACM service), this node enables requesting an SSL/TLS certificate from AWS Certificate Manager. This can be used in scenarios where you need to automate certificate issuance for your domains, such as securing websites, APIs, or other resources.

Practical examples:

  • Automatically request a new SSL certificate for a domain during deployment workflows.
  • Integrate certificate requests into infrastructure automation pipelines.
  • Manage certificates programmatically without manual intervention in the AWS console.

Properties

Name Meaning
Region The AWS region where the service request will be made. Options include all standard AWS regions like US East (N. Virginia), EU (Ireland), Asia Pacific (Tokyo), etc. Defaults to "us-east-1".
Service The AWS service to use. For requesting a certificate, 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 operations like RequestCertificate, this should be true.
Request Input JSON string representing the input parameters for the AWS SDK operation. This must be correctly formatted according to the AWS SDK specification for the chosen operation. For RequestCertificate, this includes details like domain name, validation method, etc.

Output

The node outputs an array of items, each containing a json field with the response from the AWS SDK call corresponding to the requested operation.

For the RequestCertificate operation, the output JSON typically contains information about the requested certificate, such as the certificate ARN (Amazon Resource Name) and status details.

If the operation returns binary data (not typical for RequestCertificate), it would be included accordingly, but this operation primarily returns JSON metadata.

Dependencies

  • Requires valid AWS credentials with permissions to perform the specified operation (e.g., ACM permissions for RequestCertificate).
  • The node uses the AWS SDK for JavaScript v2 internally.
  • AWS region must be specified correctly.
  • Properly formatted JSON input for the request parameters is required.

Troubleshooting

  • Invalid Service Error: If the specified service name is incorrect or unsupported, the node throws an error stating the service is not valid. Ensure the service name matches AWS SDK service names exactly (e.g., "ACM").
  • Invalid Operation Error: If the operation name does not exist for the selected service, an error is thrown. Verify the operation name is correct and supported by the AWS SDK for that service.
  • Credential Errors: If AWS credentials are missing or invalid, the node will throw an error indicating no credentials were returned. Make sure to configure valid AWS credentials with necessary permissions.
  • Malformed JSON Input: If the Request Input JSON is malformed or does not conform to the expected structure for the operation, the AWS SDK call will fail. Validate the JSON input carefully.
  • Region Issues: Using an incorrect or unsupported AWS region may cause failures. Confirm the region is valid for the service and operation.

Links and References

Discussion