@aws-sdk/client-acm

What is @aws-sdk/client-acm?

@aws-sdk/client-acm is a part of the AWS SDK for JavaScript, which allows developers to interact with the AWS Certificate Manager (ACM) service. This package provides methods to request, manage, and deploy SSL/TLS certificates for use with AWS services and internal connected resources.

What are @aws-sdk/client-acm's main functionalities?

Request a Certificate

This feature allows you to request a new SSL/TLS certificate for a specified domain. The code sample demonstrates how to request a certificate for 'example.com' using email validation.

const { ACMClient, RequestCertificateCommand } = require('@aws-sdk/client-acm');

const client = new ACMClient({ region: 'us-west-2' });
const command = new RequestCertificateCommand({
  DomainName: 'example.com',
  ValidationMethod: 'EMAIL',
});

client.send(command).then(
  (data) => console.log(data),
  (error) => console.error(error)
);

List Certificates

This feature allows you to list all the certificates in your AWS account. The code sample demonstrates how to retrieve and log the list of certificates.

const { ACMClient, ListCertificatesCommand } = require('@aws-sdk/client-acm');

const client = new ACMClient({ region: 'us-west-2' });
const command = new ListCertificatesCommand({});

client.send(command).then(
  (data) => console.log(data),
  (error) => console.error(error)
);

Describe Certificate

This feature allows you to get detailed information about a specific certificate. The code sample demonstrates how to describe a certificate using its ARN.

const { ACMClient, DescribeCertificateCommand } = require('@aws-sdk/client-acm');

const client = new ACMClient({ region: 'us-west-2' });
const command = new DescribeCertificateCommand({
  CertificateArn: 'arn:aws:acm:us-west-2:123456789012:certificate/abcd1234-5678-90ab-cdef-EXAMPLE11111',
});

client.send(command).then(
  (data) => console.log(data),
  (error) => console.error(error)
);

Delete Certificate

This feature allows you to delete a specified certificate. The code sample demonstrates how to delete a certificate using its ARN.

const { ACMClient, DeleteCertificateCommand } = require('@aws-sdk/client-acm');

const client = new ACMClient({ region: 'us-west-2' });
const command = new DeleteCertificateCommand({
  CertificateArn: 'arn:aws:acm:us-west-2:123456789012:certificate/abcd1234-5678-90ab-cdef-EXAMPLE11111',
});

client.send(command).then(
  (data) => console.log(data),
  (error) => console.error(error)
);

Other packages similar to @aws-sdk/client-acm

node-acme

node-acme is a client library for the ACME protocol, which is used by Let's Encrypt to automate the process of obtaining SSL/TLS certificates. Unlike @aws-sdk/client-acm, which is specific to AWS Certificate Manager, node-acme can be used to interact with any ACME-compliant certificate authority.

acme-client

acme-client is another library for the ACME protocol, providing a simple and flexible way to interact with ACME servers like Let's Encrypt. It offers similar functionalities to node-acme but with a different API design. It is not tied to AWS services and can be used with any ACME-compliant CA.

README

@aws-sdk/client-acm

For SDK usage, please step to SDK readme.

Changelog

1.0.0-rc.7 (2020-11-20)

Bug Fixes

• abort-controller: make AbortSignal WHATWG Spec compliant (#1699) (723ec4d)
• codegen: add aws-iam-traits dependency (#1686) (d6fb1f6)
• fetch-http-handler: omit body for HEAD/GET methods (#1698) (778b305)
• node-http-handler: throw TimeoutError for Node.js timeouts (#1693) (96f61bb)
• change paginators to export paginateOperationName (#1692) (6d02935)

Features

• update clients as of 11/18/2020 (#1700) (8adfed1)
• api-reference: add typedoc plugins for api reference (#1694) (2cb016f)
• ci: add GitHub Action to test codegen (#1684) (41e9359)
• node-http-handler: update timeout code and tests (#1691) (9e58bbb)
• service-error-classification: add 429 response as Throttling (#1690) (9a62c0a)

BREAKING CHANGES

• change paginators to export paginateOperationName to be consistent with verb nouns across AWS