feat(client-ec2): Enable the option to automatically delete underlying Amazon EBS snapshots when deregistering Amazon Machine Images (AMIs)

Author: awstools

clients/client-ec2/src/commands/CancelImageLaunchPermissionCommand.ts

@@ -29,7 +29,7 @@ export interface CancelImageLaunchPermissionCommandOutput extends CancelImageLau
 
 /**
  * <p>Removes your Amazon Web Services account from the launch permissions for the specified AMI.
- *       For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/cancel-sharing-an-AMI.html"> Cancel having an AMI shared with
+ *       For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/cancel-sharing-an-AMI.html">Cancel having an AMI shared with
  *         your Amazon Web Services account</a> in the <i>Amazon EC2 User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

clients/client-ec2/src/commands/CopyImageCommand.ts

@@ -37,7 +37,7 @@ export interface CopyImageCommandOutput extends CopyImageResult, __MetadataBeare
  *       destination. Backing snapshots copied to an Outpost are encrypted by default using the default
  *       encryption key for the Region or the key that you specify. Outposts do not support unencrypted
  *       snapshots.</p>
- *          <p>For information about the prerequisites when copying an AMI, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/CopyingAMIs.html">Copy an AMI</a> in the
+ *          <p>For information about the prerequisites when copying an AMI, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/CopyingAMIs.html">Copy an Amazon EC2 AMI</a> in the
  *         <i>Amazon EC2 User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

clients/client-ec2/src/commands/CreateImageCommand.ts

@@ -34,8 +34,8 @@ export interface CreateImageCommandOutput extends CreateImageResult, __MetadataB
  *       to the root device volume, the new AMI contains block device mapping information for those
  *       volumes. When you launch an instance from this new AMI, the instance automatically launches
  *       with those additional volumes.</p>
- *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/creating-an-ami-ebs.html">Create an Amazon EBS-backed Linux
- *         AMI</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/creating-an-ami-ebs.html">Create an Amazon EBS-backed AMI</a> in
+ *       the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-ec2/src/commands/CreateRestoreImageTaskCommand.ts

@@ -30,10 +30,10 @@ export interface CreateRestoreImageTaskCommandOutput extends CreateRestoreImageT
 /**
  * <p>Starts a task that restores an AMI from an Amazon S3 object that was previously created by
  *       using <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateStoreImageTask.html">CreateStoreImageTask</a>.</p>
- *          <p>To use this API, you must have the required permissions. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-store-restore.html#ami-s3-permissions">Permissions for storing and restoring AMIs using Amazon S3</a> in the
+ *          <p>To use this API, you must have the required permissions. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/work-with-ami-store-restore.html#ami-s3-permissions">Permissions for storing and restoring AMIs using S3</a> in the
  *       <i>Amazon EC2 User Guide</i>.</p>
  *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-store-restore.html">Store and restore an AMI using
- *       Amazon S3</a> in the <i>Amazon EC2 User Guide</i>.</p>
+ *         S3</a> in the <i>Amazon EC2 User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-ec2/src/commands/CreateStoreImageTaskCommand.ts

@@ -29,10 +29,10 @@ export interface CreateStoreImageTaskCommandOutput extends CreateStoreImageTaskR
 
 /**
  * <p>Stores an AMI as a single object in an Amazon S3 bucket.</p>
- *          <p>To use this API, you must have the required permissions. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-store-restore.html#ami-s3-permissions">Permissions for storing and restoring AMIs using Amazon S3</a> in the
- *       <i>Amazon EC2 User Guide</i>.</p>
+ *          <p>To use this API, you must have the required permissions. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/work-with-ami-store-restore.html#ami-s3-permissions">Permissions for storing and restoring AMIs using S3</a> in the
+ *         <i>Amazon EC2 User Guide</i>.</p>
  *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-store-restore.html">Store and restore an AMI using
- *       Amazon S3</a> in the <i>Amazon EC2 User Guide</i>.</p>
+ *         S3</a> in the <i>Amazon EC2 User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-ec2/src/commands/DeregisterImageCommand.ts

@@ -33,17 +33,21 @@ export interface DeregisterImageCommandOutput extends DeregisterImageResult, __M
  *          <p>If a deregistered EBS-backed AMI matches a Recycle Bin retention rule, it moves to the
  *       Recycle Bin for the specified retention period. It can be restored before its retention period
  *       expires, after which it is permanently deleted. If the deregistered AMI doesn't match a
- *       retention rule, it is permanently deleted immediately. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/recycle-bin.html">Recycle Bin</a> in
- *       the <i>Amazon EBS User Guide</i>.</p>
+ *       retention rule, it is permanently deleted immediately. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/recycle-bin.html">Recover deleted Amazon EBS
+ *         snapshots and EBS-backed AMIs with Recycle Bin</a> in the <i>Amazon EBS User
+ *         Guide</i>.</p>
+ *          <p>When deregistering an EBS-backed AMI, you can optionally delete its associated snapshots
+ *       at the same time. However, if a snapshot is associated with multiple AMIs, it won't be deleted
+ *       even if specified for deletion, although the AMI will still be deregistered.</p>
  *          <p>Deregistering an AMI does not delete the following:</p>
  *          <ul>
  *             <li>
  *                <p>Instances already launched from the AMI. You'll continue to incur usage costs for the
  *           instances until you terminate them.</p>
  *             </li>
  *             <li>
- *                <p>For EBS-backed AMIs: The snapshots that were created of the root and data volumes of
- *           the instance during AMI creation. You'll continue to incur snapshot storage costs.</p>
+ *                <p>For EBS-backed AMIs: Snapshots that are associated with multiple AMIs. You'll continue
+ *           to incur snapshot storage costs.</p>
  *             </li>
  *             <li>
  *                <p>For instance store-backed AMIs: The files uploaded to Amazon S3 during AMI creation. You'll
@@ -60,11 +64,20 @@ export interface DeregisterImageCommandOutput extends DeregisterImageResult, __M
  * const client = new EC2Client(config);
  * const input = { // DeregisterImageRequest
  *   ImageId: "STRING_VALUE", // required
+ *   DeleteAssociatedSnapshots: true || false,
  *   DryRun: true || false,
  * };
  * const command = new DeregisterImageCommand(input);
  * const response = await client.send(command);
- * // {};
+ * // { // DeregisterImageResult
+ * //   Return: true || false,
+ * //   DeleteSnapshotResults: [ // DeleteSnapshotResultSet
+ * //     { // DeleteSnapshotReturnCode
+ * //       SnapshotId: "STRING_VALUE",
+ * //       ReturnCode: "success" || "skipped" || "missing-permissions" || "internal-error" || "client-error",
+ * //     },
+ * //   ],
+ * // };
  *
  * ```
  *
@@ -105,7 +118,7 @@ export class DeregisterImageCommand extends $Command
   protected declare static __types: {
     api: {
       input: DeregisterImageRequest;
-      output: {};
+      output: DeregisterImageResult;
     };
     sdk: {
       input: DeregisterImageCommandInput;

clients/client-ec2/src/commands/DescribeKeyPairsCommand.ts

@@ -6,8 +6,7 @@ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
 
 import { EC2ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EC2Client";
 import { commonParams } from "../endpoint/EndpointParameters";
-import { DescribeKeyPairsRequest } from "../models/models_4";
-import { DescribeKeyPairsResult } from "../models/models_5";
+import { DescribeKeyPairsRequest, DescribeKeyPairsResult } from "../models/models_5";
 import { de_DescribeKeyPairsCommand, se_DescribeKeyPairsCommand } from "../protocols/Aws_ec2";
 
 /**

clients/client-ec2/src/commands/DescribeStoreImageTasksCommand.ts

@@ -36,10 +36,10 @@ export interface DescribeStoreImageTasksCommandOutput extends DescribeStoreImage
  *       response shows the estimated progress as a percentage.</p>
  *          <p>Tasks are listed in reverse chronological order. Currently, only tasks from the past 31
  *       days can be viewed.</p>
- *          <p>To use this API, you must have the required permissions. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-store-restore.html#ami-s3-permissions">Permissions for storing and restoring AMIs using Amazon S3</a> in the
- *       <i>Amazon EC2 User Guide</i>.</p>
+ *          <p>To use this API, you must have the required permissions. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/work-with-ami-store-restore.html#ami-s3-permissions">Permissions for storing and restoring AMIs using S3</a> in the
+ *         <i>Amazon EC2 User Guide</i>.</p>
  *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-store-restore.html">Store and restore an AMI using
- *       Amazon S3</a> in the <i>Amazon EC2 User Guide</i>.</p>
+ *         S3</a> in the <i>Amazon EC2 User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-ec2/src/commands/DescribeVpcsCommand.ts

@@ -6,7 +6,7 @@ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
 
 import { EC2ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EC2Client";
 import { commonParams } from "../endpoint/EndpointParameters";
-import { DescribeVpcsRequest, DescribeVpcsResult } from "../models/models_5";
+import { DescribeVpcsRequest, DescribeVpcsResult } from "../models/models_6";
 import { de_DescribeVpcsCommand, se_DescribeVpcsCommand } from "../protocols/Aws_ec2";
 
 /**

clients/client-ec2/src/commands/DisableImageBlockPublicAccessCommand.ts

@@ -38,7 +38,7 @@ export interface DisableImageBlockPublicAccessCommandOutput
  *       <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_GetImageBlockPublicAccessState.html">GetImageBlockPublicAccessState</a>, the response will be
  *       <code>block-new-sharing</code>. When the API has completed the configuration, the response
  *       will be <code>unblocked</code>.</p>
- *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/sharingamis-intro.html#block-public-access-to-amis">Block
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-public-access-to-amis.html">Block
  *       public access to your AMIs</a> in the <i>Amazon EC2 User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

clients/client-ec2/src/commands/DisableImageDeprecationCommand.ts

@@ -29,7 +29,7 @@ export interface DisableImageDeprecationCommandOutput extends DisableImageDeprec
 
 /**
  * <p>Cancels the deprecation of the specified AMI.</p>
- *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-deprecate.html">Deprecate an AMI</a> in the
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-deprecate.html">Deprecate an Amazon EC2 AMI</a> in the
  *       <i>Amazon EC2 User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

clients/client-ec2/src/commands/DisableImageDeregistrationProtectionCommand.ts

@@ -41,8 +41,8 @@ export interface DisableImageDeregistrationProtectionCommandOutput
  *          <p>If you chose to include a 24-hour cooldown period when you enabled deregistration
  *       protection for the AMI, then, when you disable deregistration protection, you won’t
  *       immediately be able to deregister the AMI.</p>
- *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/deregister-ami.html#ami-deregistration-protection">Protect an
- *       AMI from deregistration</a> in the <i>Amazon EC2 User Guide</i>.</p>
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-deregistration-protection.html">Protect an Amazon EC2 AMI from
+ *         deregistration</a> in the <i>Amazon EC2 User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-ec2/src/commands/EnableImageBlockPublicAccessCommand.ts

@@ -37,7 +37,7 @@ export interface EnableImageBlockPublicAccessCommandOutput
  *       <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_GetImageBlockPublicAccessState.html">GetImageBlockPublicAccessState</a>, the response will be <code>unblocked</code>. When
  *       the API has completed the configuration, the response will be
  *       <code>block-new-sharing</code>.</p>
- *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/sharingamis-intro.html#block-public-access-to-amis">Block
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-public-access-to-amis.html">Block
  *       public access to your AMIs</a> in the <i>Amazon EC2 User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

clients/client-ec2/src/commands/EnableImageCommand.ts

@@ -34,8 +34,8 @@ export interface EnableImageCommandOutput extends EnableImageResult, __MetadataB
  *       disabled do not regain access automatically. Once the AMI is available, it can be shared with
  *       them again.</p>
  *          <p>Only the AMI owner can re-enable a disabled AMI.</p>
- *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/disable-an-ami.html">Disable an AMI</a> in the
- *       <i>Amazon EC2 User Guide</i>.</p>
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/disable-an-ami.html">Disable an Amazon EC2 AMI</a>
+ *       in the <i>Amazon EC2 User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-ec2/src/commands/EnableImageDeregistrationProtectionCommand.ts

@@ -40,8 +40,8 @@ export interface EnableImageDeregistrationProtectionCommandOutput
  *       the AMI can't be deregistered.</p>
  *          <p>To allow the AMI to be deregistered, you must first disable deregistration protection
  *       using <a>DisableImageDeregistrationProtection</a>.</p>
- *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/deregister-ami.html#ami-deregistration-protection">Protect an
- *       AMI from deregistration</a> in the <i>Amazon EC2 User Guide</i>.</p>
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-deregistration-protection.html">Protect an
+ *       Amazon EC2 AMI from deregistration</a> in the <i>Amazon EC2 User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-ec2/src/commands/GetImageBlockPublicAccessStateCommand.ts

@@ -35,7 +35,7 @@ export interface GetImageBlockPublicAccessStateCommandOutput
 /**
  * <p>Gets the current state of <i>block public access for AMIs</i> at the account
  *       level in the specified Amazon Web Services Region.</p>
- *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/sharingamis-intro.html#block-public-access-to-amis">Block
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-public-access-to-amis.html">Block
  *       public access to your AMIs</a> in the <i>Amazon EC2 User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

clients/client-ec2/src/commands/GetTransitGatewayMulticastDomainAssociationsCommand.ts

@@ -6,10 +6,8 @@ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
 
 import { EC2ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EC2Client";
 import { commonParams } from "../endpoint/EndpointParameters";
-import {
-  GetTransitGatewayMulticastDomainAssociationsRequest,
-  GetTransitGatewayMulticastDomainAssociationsResult,
-} from "../models/models_6";
+import { GetTransitGatewayMulticastDomainAssociationsRequest } from "../models/models_6";
+import { GetTransitGatewayMulticastDomainAssociationsResult } from "../models/models_7";
 import {
   de_GetTransitGatewayMulticastDomainAssociationsCommand,
   se_GetTransitGatewayMulticastDomainAssociationsCommand,

clients/client-ec2/src/commands/GetTransitGatewayPolicyTableAssociationsCommand.ts

@@ -6,8 +6,10 @@ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
 
 import { EC2ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EC2Client";
 import { commonParams } from "../endpoint/EndpointParameters";
-import { GetTransitGatewayPolicyTableAssociationsRequest } from "../models/models_6";
-import { GetTransitGatewayPolicyTableAssociationsResult } from "../models/models_7";
+import {
+  GetTransitGatewayPolicyTableAssociationsRequest,
+  GetTransitGatewayPolicyTableAssociationsResult,
+} from "../models/models_7";
 import {
   de_GetTransitGatewayPolicyTableAssociationsCommand,
   se_GetTransitGatewayPolicyTableAssociationsCommand,

clients/client-ec2/src/commands/RegisterImageCommand.ts

@@ -49,8 +49,8 @@ export interface RegisterImageCommandOutput extends RegisterImageResult, __Metad
  *       the encryption state of the volume using the block device mapping. If the snapshot is
  *       encrypted, or encryption by default is enabled, the root volume of an instance launched from
  *       the AMI is encrypted.</p>
- *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/creating-an-ami-ebs.html#creating-launching-ami-from-snapshot">Create an AMI from a snapshot</a> and <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIEncryption.html">Use encryption with Amazon EBS-backed
- *         AMIs</a> in the <i>Amazon EC2 User Guide</i>.</p>
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/creating-an-ami-ebs.html#creating-launching-ami-from-snapshot">Create an AMI from a snapshot</a> and <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIEncryption.html">Use encryption with EBS-backed AMIs</a>
+ *       in the <i>Amazon EC2 User Guide</i>.</p>
  *          <p>
  *             <b>Amazon Web Services Marketplace product codes</b>
  *          </p>

clients/client-ec2/src/commands/RejectVpcPeeringConnectionCommand.ts

@@ -6,7 +6,8 @@ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
 
 import { EC2ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EC2Client";
 import { commonParams } from "../endpoint/EndpointParameters";
-import { RejectVpcPeeringConnectionRequest, RejectVpcPeeringConnectionResult } from "../models/models_7";
+import { RejectVpcPeeringConnectionRequest } from "../models/models_7";
+import { RejectVpcPeeringConnectionResult } from "../models/models_8";
 import { de_RejectVpcPeeringConnectionCommand, se_RejectVpcPeeringConnectionCommand } from "../protocols/Aws_ec2";
 
 /**

clients/client-ec2/src/commands/ReleaseAddressCommand.ts

@@ -6,7 +6,7 @@ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
 
 import { EC2ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EC2Client";
 import { commonParams } from "../endpoint/EndpointParameters";
-import { ReleaseAddressRequest } from "../models/models_7";
+import { ReleaseAddressRequest } from "../models/models_8";
 import { de_ReleaseAddressCommand, se_ReleaseAddressCommand } from "../protocols/Aws_ec2";
 
 /**