feat(client-acm): Adds support for Exportable Public Certificates

Author: awstools

clients/client-acm/README.md

@@ -6,10 +6,7 @@
 
 AWS SDK for JavaScript ACM Client for Node.js, Browser and React Native.
 
-<fullname>Certificate Manager</fullname>
-
-<p>You can use Certificate Manager (ACM) to manage SSL/TLS certificates for your Amazon Web Services-based websites
-and applications. For more information about using ACM, see the <a href="https://docs.aws.amazon.com/acm/latest/userguide/">Certificate Manager User Guide</a>.</p>
+<fullname>Certificate Manager</fullname> <p>You can use Certificate Manager (ACM) to manage SSL/TLS certificates for your Amazon Web Services-based websites and applications. For more information about using ACM, see the <a href="https://docs.aws.amazon.com/acm/latest/userguide/">Certificate Manager User Guide</a>.</p>
 
 ## Installing
 
@@ -317,6 +314,14 @@ ResendValidationEmail
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/acm/command/ResendValidationEmailCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-acm/Interface/ResendValidationEmailCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-acm/Interface/ResendValidationEmailCommandOutput/)
 
+</details>
+<details>
+<summary>
+RevokeCertificate
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/acm/command/RevokeCertificateCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-acm/Interface/RevokeCertificateCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-acm/Interface/RevokeCertificateCommandOutput/)
+
 </details>
 <details>
 <summary>

clients/client-acm/src/ACM.ts

@@ -73,6 +73,11 @@ import {
   ResendValidationEmailCommandInput,
   ResendValidationEmailCommandOutput,
 } from "./commands/ResendValidationEmailCommand";
+import {
+  RevokeCertificateCommand,
+  RevokeCertificateCommandInput,
+  RevokeCertificateCommandOutput,
+} from "./commands/RevokeCertificateCommand";
 import {
   UpdateCertificateOptionsCommand,
   UpdateCertificateOptionsCommandInput,
@@ -94,6 +99,7 @@ const commands = {
   RenewCertificateCommand,
   RequestCertificateCommand,
   ResendValidationEmailCommand,
+  RevokeCertificateCommand,
   UpdateCertificateOptionsCommand,
 };
 
@@ -335,6 +341,23 @@ export interface ACM {
     cb: (err: any, data?: ResendValidationEmailCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link RevokeCertificateCommand}
+   */
+  revokeCertificate(
+    args: RevokeCertificateCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<RevokeCertificateCommandOutput>;
+  revokeCertificate(
+    args: RevokeCertificateCommandInput,
+    cb: (err: any, data?: RevokeCertificateCommandOutput) => void
+  ): void;
+  revokeCertificate(
+    args: RevokeCertificateCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: RevokeCertificateCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link UpdateCertificateOptionsCommand}
    */
@@ -354,9 +377,7 @@ export interface ACM {
 }
 
 /**
- * <fullname>Certificate Manager</fullname>
- *          <p>You can use Certificate Manager (ACM) to manage SSL/TLS certificates for your Amazon Web Services-based websites
- *       and applications. For more information about using ACM, see the <a href="https://docs.aws.amazon.com/acm/latest/userguide/">Certificate Manager User Guide</a>.</p>
+ * <fullname>Certificate Manager</fullname> <p>You can use Certificate Manager (ACM) to manage SSL/TLS certificates for your Amazon Web Services-based websites and applications. For more information about using ACM, see the <a href="https://docs.aws.amazon.com/acm/latest/userguide/">Certificate Manager User Guide</a>.</p>
  * @public
  */
 export class ACM extends ACMClient implements ACM {}

clients/client-acm/src/ACMClient.ts

@@ -88,6 +88,7 @@ import {
   ResendValidationEmailCommandInput,
   ResendValidationEmailCommandOutput,
 } from "./commands/ResendValidationEmailCommand";
+import { RevokeCertificateCommandInput, RevokeCertificateCommandOutput } from "./commands/RevokeCertificateCommand";
 import {
   UpdateCertificateOptionsCommandInput,
   UpdateCertificateOptionsCommandOutput,
@@ -121,6 +122,7 @@ export type ServiceInputTypes =
   | RenewCertificateCommandInput
   | RequestCertificateCommandInput
   | ResendValidationEmailCommandInput
+  | RevokeCertificateCommandInput
   | UpdateCertificateOptionsCommandInput;
 
 /**
@@ -141,6 +143,7 @@ export type ServiceOutputTypes =
   | RenewCertificateCommandOutput
   | RequestCertificateCommandOutput
   | ResendValidationEmailCommandOutput
+  | RevokeCertificateCommandOutput
   | UpdateCertificateOptionsCommandOutput;
 
 /**
@@ -334,9 +337,7 @@ export type ACMClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpHa
 export interface ACMClientResolvedConfig extends ACMClientResolvedConfigType {}
 
 /**
- * <fullname>Certificate Manager</fullname>
- *          <p>You can use Certificate Manager (ACM) to manage SSL/TLS certificates for your Amazon Web Services-based websites
- *       and applications. For more information about using ACM, see the <a href="https://docs.aws.amazon.com/acm/latest/userguide/">Certificate Manager User Guide</a>.</p>
+ * <fullname>Certificate Manager</fullname> <p>You can use Certificate Manager (ACM) to manage SSL/TLS certificates for your Amazon Web Services-based websites and applications. For more information about using ACM, see the <a href="https://docs.aws.amazon.com/acm/latest/userguide/">Certificate Manager User Guide</a>.</p>
  * @public
  */
 export class ACMClient extends __Client<

clients/client-acm/src/commands/AddTagsToCertificateCommand.ts

@@ -28,20 +28,7 @@ export interface AddTagsToCertificateCommandInput extends AddTagsToCertificateRe
 export interface AddTagsToCertificateCommandOutput extends __MetadataBearer {}
 
 /**
- * <p>Adds one or more tags to an ACM certificate. Tags are labels that you can use to
- *       identify and organize your Amazon Web Services resources. Each tag consists of a <code>key</code> and an
- *       optional <code>value</code>. You specify the certificate on input by its Amazon Resource Name
- *       (ARN). You specify the tag by using a key-value pair. </p>
- *          <p>You can apply a tag to just one certificate if you want to identify a specific
- *       characteristic of that certificate, or you can apply the same tag to multiple certificates if
- *       you want to filter for a common relationship among those certificates. Similarly, you can
- *       apply the same tag to multiple resources if you want to specify a relationship among those
- *       resources. For example, you can add the same tag to an ACM certificate and an Elastic Load
- *       Balancing load balancer to indicate that they are both used by the same website. For more
- *       information, see <a href="https://docs.aws.amazon.com/acm/latest/userguide/tags.html">Tagging ACM
- *         certificates</a>. </p>
- *          <p>To remove one or more tags, use the <a>RemoveTagsFromCertificate</a> action. To
- *       view all of the tags that have been applied to the certificate, use the <a>ListTagsForCertificate</a> action. </p>
+ * <p>Adds one or more tags to an ACM certificate. Tags are labels that you can use to identify and organize your Amazon Web Services resources. Each tag consists of a <code>key</code> and an optional <code>value</code>. You specify the certificate on input by its Amazon Resource Name (ARN). You specify the tag by using a key-value pair. </p> <p>You can apply a tag to just one certificate if you want to identify a specific characteristic of that certificate, or you can apply the same tag to multiple certificates if you want to filter for a common relationship among those certificates. Similarly, you can apply the same tag to multiple resources if you want to specify a relationship among those resources. For example, you can add the same tag to an ACM certificate and an Elastic Load Balancing load balancer to indicate that they are both used by the same website. For more information, see <a href="https://docs.aws.amazon.com/acm/latest/userguide/tags.html">Tagging ACM certificates</a>. </p> <p>To remove one or more tags, use the <a>RemoveTagsFromCertificate</a> action. To view all of the tags that have been applied to the certificate, use the <a>ListTagsForCertificate</a> action. </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -76,12 +63,10 @@ export interface AddTagsToCertificateCommandOutput extends __MetadataBearer {}
  *  <p>An input parameter was invalid.</p>
  *
  * @throws {@link InvalidTagException} (client fault)
- *  <p>One or both of the values that make up the key-value pair is not valid. For example, you
- *       cannot specify a tag value that begins with <code>aws:</code>.</p>
+ *  <p>One or both of the values that make up the key-value pair is not valid. For example, you cannot specify a tag value that begins with <code>aws:</code>.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  <p>The specified certificate cannot be found in the caller's account or the caller's account
- *       cannot be found.</p>
+ *  <p>The specified certificate cannot be found in the caller's account or the caller's account cannot be found.</p>
  *
  * @throws {@link TagPolicyException} (client fault)
  *  <p>A specified tag did not comply with an existing tag policy and was rejected.</p>

clients/client-acm/src/commands/DeleteCertificateCommand.ts

@@ -28,14 +28,7 @@ export interface DeleteCertificateCommandInput extends DeleteCertificateRequest
 export interface DeleteCertificateCommandOutput extends __MetadataBearer {}
 
 /**
- * <p>Deletes a certificate and its associated private key. If this action succeeds, the
- *       certificate no longer appears in the list that can be displayed by calling the <a>ListCertificates</a> action or be retrieved by calling the <a>GetCertificate</a> action. The certificate will not be available for use by Amazon Web Services
- *       services integrated with ACM. </p>
- *          <note>
- *             <p>You cannot delete an ACM certificate that is being used by another Amazon Web Services service. To
- *         delete a certificate that is in use, the certificate association must first be
- *         removed.</p>
- *          </note>
+ * <p>Deletes a certificate and its associated private key. If this action succeeds, the certificate no longer appears in the list that can be displayed by calling the <a>ListCertificates</a> action or be retrieved by calling the <a>GetCertificate</a> action. The certificate will not be available for use by Amazon Web Services services integrated with ACM. </p> <note> <p>You cannot delete an ACM certificate that is being used by another Amazon Web Services service. To delete a certificate that is in use, the certificate association must first be removed.</p> </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -61,19 +54,16 @@ export interface DeleteCertificateCommandOutput extends __MetadataBearer {}
  *  <p>You do not have access required to perform this action.</p>
  *
  * @throws {@link ConflictException} (client fault)
- *  <p>You are trying to update a resource or configuration that is already being created or
- *       updated. Wait for the previous operation to finish and try again.</p>
+ *  <p>You are trying to update a resource or configuration that is already being created or updated. Wait for the previous operation to finish and try again.</p>
  *
  * @throws {@link InvalidArnException} (client fault)
  *  <p>The requested Amazon Resource Name (ARN) does not refer to an existing resource.</p>
  *
  * @throws {@link ResourceInUseException} (client fault)
- *  <p>The certificate is in use by another Amazon Web Services service in the caller's account. Remove the
- *       association and try again.</p>
+ *  <p>The certificate is in use by another Amazon Web Services service in the caller's account. Remove the association and try again.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  <p>The specified certificate cannot be found in the caller's account or the caller's account
- *       cannot be found.</p>
+ *  <p>The specified certificate cannot be found in the caller's account or the caller's account cannot be found.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
  *  <p>The request was denied because it exceeded a quota.</p>

clients/client-acm/src/commands/DescribeCertificateCommand.ts

@@ -28,9 +28,7 @@ export interface DescribeCertificateCommandInput extends DescribeCertificateRequ
 export interface DescribeCertificateCommandOutput extends DescribeCertificateResponse, __MetadataBearer {}
 
 /**
- * <p>Returns detailed metadata about the specified ACM certificate.</p>
- *          <p>If you have just created a certificate using the <code>RequestCertificate</code> action,
- *       there is a delay of several seconds before you can retrieve information about it.</p>
+ * <p>Returns detailed metadata about the specified ACM certificate.</p> <p>If you have just created a certificate using the <code>RequestCertificate</code> action, there is a delay of several seconds before you can retrieve information about it.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -128,6 +126,7 @@ export interface DescribeCertificateCommandOutput extends DescribeCertificateRes
  * //     RenewalEligibility: "ELIGIBLE" || "INELIGIBLE",
  * //     Options: { // CertificateOptions
  * //       CertificateTransparencyLoggingPreference: "ENABLED" || "DISABLED",
+ * //       Export: "ENABLED" || "DISABLED",
  * //     },
  * //   },
  * // };
@@ -144,8 +143,7 @@ export interface DescribeCertificateCommandOutput extends DescribeCertificateRes
  *  <p>The requested Amazon Resource Name (ARN) does not refer to an existing resource.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  <p>The specified certificate cannot be found in the caller's account or the caller's account
- *       cannot be found.</p>
+ *  <p>The specified certificate cannot be found in the caller's account or the caller's account cannot be found.</p>
  *
  * @throws {@link ACMServiceException}
  * <p>Base exception class for all service exceptions from ACM service.</p>

clients/client-acm/src/commands/ExportCertificateCommand.ts

@@ -33,13 +33,7 @@ export interface ExportCertificateCommandInput extends ExportCertificateRequest
 export interface ExportCertificateCommandOutput extends ExportCertificateResponse, __MetadataBearer {}
 
 /**
- * <p>Exports a private certificate issued by a private certificate authority (CA) for use
- *       anywhere. The exported file contains the certificate, the certificate chain, and the encrypted
- *       private 2048-bit RSA key associated with the public key that is embedded in the certificate.
- *       For security, you must assign a passphrase for the private key when exporting it. </p>
- *          <p>For information about exporting and formatting a certificate using the ACM console or
- *       CLI, see <a href="https://docs.aws.amazon.com/acm/latest/userguide/gs-acm-export-private.html">Export a
- *         Private Certificate</a>.</p>
+ * <p>Exports a private certificate issued by a private certificate authority (CA) or public certificate for use anywhere. The exported file contains the certificate, the certificate chain, and the encrypted private key associated with the public key that is embedded in the certificate. For security, you must assign a passphrase for the private key when exporting it. </p> <p>For information about exporting and formatting a certificate using the ACM console or CLI, see <a href="https://docs.aws.amazon.com/acm/latest/userguide/export-private.html">Export a private certificate</a> and <a href="https://docs.aws.amazon.com/acm/latest/userguide/export-public-certificate">Export a public certificate</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -70,12 +64,10 @@ export interface ExportCertificateCommandOutput extends ExportCertificateRespons
  *  <p>The requested Amazon Resource Name (ARN) does not refer to an existing resource.</p>
  *
  * @throws {@link RequestInProgressException} (client fault)
- *  <p>The certificate request is in process and the certificate in your account has not yet been
- *       issued.</p>
+ *  <p>The certificate request is in process and the certificate in your account has not yet been issued.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  <p>The specified certificate cannot be found in the caller's account or the caller's account
- *       cannot be found.</p>
+ *  <p>The specified certificate cannot be found in the caller's account or the caller's account cannot be found.</p>
  *
  * @throws {@link ACMServiceException}
  * <p>Base exception class for all service exceptions from ACM service.</p>

clients/client-acm/src/commands/GetCertificateCommand.ts

@@ -28,12 +28,7 @@ export interface GetCertificateCommandInput extends GetCertificateRequest {}
 export interface GetCertificateCommandOutput extends GetCertificateResponse, __MetadataBearer {}
 
 /**
- * <p>Retrieves a certificate and its certificate chain. The certificate may be either a public
- *       or private certificate issued using the ACM <code>RequestCertificate</code> action, or a
- *       certificate imported into ACM using the <code>ImportCertificate</code> action. The chain
- *       consists of the certificate of the issuing CA and the intermediate certificates of any other
- *       subordinate CAs. All of the certificates are base64 encoded. You can use <a href="https://wiki.openssl.org/index.php/Command_Line_Utilities">OpenSSL</a> to decode
- *       the certificates and inspect individual fields.</p>
+ * <p>Retrieves a certificate and its certificate chain. The certificate may be either a public or private certificate issued using the ACM <code>RequestCertificate</code> action, or a certificate imported into ACM using the <code>ImportCertificate</code> action. The chain consists of the certificate of the issuing CA and the intermediate certificates of any other subordinate CAs. All of the certificates are base64 encoded. You can use <a href="https://wiki.openssl.org/index.php/Command_Line_Utilities">OpenSSL</a> to decode the certificates and inspect individual fields.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -62,12 +57,10 @@ export interface GetCertificateCommandOutput extends GetCertificateResponse, __M
  *  <p>The requested Amazon Resource Name (ARN) does not refer to an existing resource.</p>
  *
  * @throws {@link RequestInProgressException} (client fault)
- *  <p>The certificate request is in process and the certificate in your account has not yet been
- *       issued.</p>
+ *  <p>The certificate request is in process and the certificate in your account has not yet been issued.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  <p>The specified certificate cannot be found in the caller's account or the caller's account
- *       cannot be found.</p>
+ *  <p>The specified certificate cannot be found in the caller's account or the caller's account cannot be found.</p>
  *
  * @throws {@link ACMServiceException}
  * <p>Base exception class for all service exceptions from ACM service.</p>