@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.