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 operations on various AWS services without needing dedicated nodes for each service.

For the AddTagsToCertificate operation under the Default resource, this node enables adding tags to an AWS Certificate Manager (ACM) certificate. This can be beneficial in scenarios where you want to organize, categorize, or manage ACM certificates using tags for easier identification, billing, or automation purposes.

Practical example:
You have multiple SSL/TLS certificates managed in ACM and want to tag them based on environment (e.g., "Production", "Staging") or project ownership. Using this node, you can add such tags programmatically to certificates to facilitate management and reporting.

Properties

Name Meaning
Region The AWS region where the service request will be sent. Options include all standard AWS regions like US East (N. Virginia), EU (Frankfurt), Asia Pacific (Tokyo), etc.
Service The AWS service to use for the request. For this operation, it should be set to ACM (AWS Certificate Manager).
Version The API version of the selected AWS service. For ACM, the default and only option is 2015-12-08.
Request Has Input Boolean indicating whether the request requires input parameters. For AddTagsToCertificate, this should be true because the operation needs input data.
Request Input JSON object representing the input parameters for the AWS SDK operation. For AddTagsToCertificate, this should include the certificate ARN and the tags to add, formatted according to the AWS SDK specification.

Output

The output is a JSON object containing the response from the AWS SDK call to the specified operation. For the AddTagsToCertificate operation, the AWS SDK typically returns an empty object {} upon success, indicating that the tags were added successfully.

The output structure:

{
  "json": {
    // Response from AWS SDK AddTagsToCertificate operation, usually empty on success
  },
  "pairedItem": <index_of_input_item>
}

No binary data is produced by this node.

Dependencies

  • Requires valid AWS credentials with permissions to perform the specified operation (AddTagsToCertificate requires permissions to tag ACM certificates).
  • The node uses the AWS SDK v2 internally.
  • AWS region must be correctly specified.
  • The user must provide correctly formatted JSON input for the request parameters.

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 is set to ACM for this operation.
  • Invalid Operation Error: If the operation name is misspelled or unsupported by the chosen service, an error will indicate the operation is invalid. Use the exact operation name AddTagsToCertificate.
  • Credential Errors: If AWS credentials are missing or incomplete (missing access key or secret key), the node will throw an error asking to set proper credentials.
  • Malformed JSON Input: The Request Input must be valid JSON matching the AWS SDK's expected input format. Invalid JSON or incorrect parameter structure will cause the AWS SDK call to fail.
  • Permission Denied: If the AWS credentials do not have permission to tag ACM certificates, the operation will fail with an authorization error. Ensure the IAM role or user has the necessary permissions.
  • Region Mismatch: Specifying a wrong or unsupported AWS region may cause failures. Verify the region matches where your ACM certificates reside.

Links and References

Discussion