feat(client-ec2): Stop Protection feature enables customers to protect their instances from accidental stop actions.

Author: awstools

clients/client-ec2/src/EC2.ts

@@ -5205,7 +5205,7 @@ export class EC2 extends EC2Client {
    *         <p>A launch template contains the parameters to launch an
    *             instance. When you launch an instance using <a>RunInstances</a>, you can
    *             specify a launch template instead of providing the launch parameters in the request. For
-   *             more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html">Launching an instance from a
+   *             more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html">Launch an instance from a
    *                 launch template</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>
    *         <p>If you want to clone an existing launch template as the basis for creating a new
    *             launch template, you can use the Amazon EC2 console. The API, SDKs, and CLI do not support
@@ -5246,7 +5246,9 @@ export class EC2 extends EC2Client {
    *             launch template from which to base the new version.</p>
    *         <p>Launch template versions are numbered in the order in which they are created. You
    *             cannot specify, change, or replace the numbering of launch template versions.</p>
-   *         <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html#manage-launch-template-versions">Managing launch template versions</a>in the
+   *         <p>Launch templates are immutable; after you create a launch template, you can't modify it.
+   *             Instead, you can create a new version of the launch template that includes any changes you require.</p>
+   *         <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html#manage-launch-template-versions">Modify a launch template (manage launch template versions)</a>in the
    *                 <i>Amazon Elastic Compute Cloud User Guide</i>.</p>
    */
   public createLaunchTemplateVersion(

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

@@ -27,7 +27,7 @@ export interface CreateLaunchTemplateCommandOutput extends CreateLaunchTemplateR
  *         <p>A launch template contains the parameters to launch an
  *             instance. When you launch an instance using <a>RunInstances</a>, you can
  *             specify a launch template instead of providing the launch parameters in the request. For
- *             more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html">Launching an instance from a
+ *             more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html">Launch an instance from a
  *                 launch template</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>
  *         <p>If you want to clone an existing launch template as the basis for creating a new
  *             launch template, you can use the Amazon EC2 console. The API, SDKs, and CLI do not support

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

@@ -27,7 +27,9 @@ export interface CreateLaunchTemplateVersionCommandOutput extends CreateLaunchTe
  *             launch template from which to base the new version.</p>
  *         <p>Launch template versions are numbered in the order in which they are created. You
  *             cannot specify, change, or replace the numbering of launch template versions.</p>
- *         <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html#manage-launch-template-versions">Managing launch template versions</a>in the
+ *         <p>Launch templates are immutable; after you create a launch template, you can't modify it.
+ *             Instead, you can create a new version of the launch template that includes any changes you require.</p>
+ *         <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html#manage-launch-template-versions">Modify a launch template (manage launch template versions)</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.

clients/client-ec2/src/models/models_1.ts

@@ -3853,7 +3853,7 @@ export namespace LaunchTemplateElasticInferenceAccelerator {
 
 /**
  * <p>Indicates whether the instance is enabled for Amazon Web Services Nitro Enclaves. For more
- *             information, see <a href="https://docs.aws.amazon.com/enclaves/latest/user/nitro-enclave.html"> What is Amazon Web Services Nitro Enclaves?</a>
+ *             information, see <a href="https://docs.aws.amazon.com/enclaves/latest/user/nitro-enclave.html">What is Amazon Web Services Nitro Enclaves?</a>
  *             in the <i>Amazon Web Services Nitro Enclaves User Guide</i>.</p>
  */
 export interface LaunchTemplateEnclaveOptionsRequest {
@@ -3875,7 +3875,7 @@ export namespace LaunchTemplateEnclaveOptionsRequest {
 
 /**
  * <p>Indicates whether the instance is configured for hibernation. This parameter is valid
- *             only if the instance meets the <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html#hibernating-prerequisites">hibernation
+ *             only if the instance meets the <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/hibernating-prerequisites.html">hibernation
  *                 prerequisites</a>.</p>
  */
 export interface LaunchTemplateHibernationOptionsRequest {
@@ -4487,9 +4487,8 @@ export interface RequestLaunchTemplateData {
    * <p>The ID of the kernel.</p>
    *         <important>
    *             <p>We recommend that you use PV-GRUB instead of kernels and RAM disks. For more
-   *                 information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedkernels.html">User Provided
-   *                     Kernels</a> in the <i>Amazon Elastic Compute Cloud User
-   *                     Guide</i>.</p>
+   *                 information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedkernels.html">User provided
+   *                     kernels</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>
    *         </important>
    */
   KernelId?: string;
@@ -4525,7 +4524,7 @@ export interface RequestLaunchTemplateData {
   ImageId?: string;
 
   /**
-   * <p>The instance type. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html">Instance Types</a> in the
+   * <p>The instance type. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html">Instance types</a> in the
    *                 <i>Amazon Elastic Compute Cloud User Guide</i>.</p>
    *         <p>If you specify <code>InstanceTypes</code>, you can't specify
    *                 <code>InstanceRequirements</code>.</p>
@@ -4556,9 +4555,8 @@ export interface RequestLaunchTemplateData {
    * <p>The ID of the RAM disk.</p>
    *         <important>
    *             <p>We recommend that you use PV-GRUB instead of kernels and RAM disks. For more
-   *                 information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedkernels.html">User Provided
-   *                     Kernels</a> in the <i>Amazon Elastic Compute Cloud User
-   *                     Guide</i>.</p>
+   *                 information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedkernels.html">User provided
+   *                     kernels</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>
    *         </important>
    */
   RamDiskId?: string;
@@ -4582,8 +4580,8 @@ export interface RequestLaunchTemplateData {
 
   /**
    * <p>The user data to make available to the instance. You must provide base64-encoded text.
-   *             User data is limited to 16 KB. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/user-data.html">Running Commands on Your Linux Instance
-   *                 at Launch</a> (Linux) or <a href="https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2-instance-metadata.html#instancedata-add-user-data">Adding User Data</a> (Windows).</p>
+   *             User data is limited to 16 KB. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/user-data.html">Run commands on your Linux instance
+   *                 at launch</a> (Linux) or <a href="https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/instancedata-add-user-data.html">Work with instance user data</a> (Windows) in the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>
    *
    *         <p>If you are creating the launch template for use with Batch, the user
    *             data must be provided in the <a href="https://cloudinit.readthedocs.io/en/latest/topics/format.html#mime-multi-part-archive"> MIME multi-part archive format</a>. For more information, see <a href="https://docs.aws.amazon.com/batch/latest/userguide/launch-templates.html">Amazon EC2 user data in launch templates</a> in the <i>Batch User Guide</i>.</p>
@@ -4652,7 +4650,7 @@ export interface RequestLaunchTemplateData {
 
   /**
    * <p>Indicates whether an instance is enabled for hibernation. This parameter is valid only
-   *             if the instance meets the <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html#hibernating-prerequisites">hibernation
+   *             if the instance meets the <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/hibernating-prerequisites.html">hibernation
    *                 prerequisites</a>. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html">Hibernate your instance</a> in the
    *                 <i>Amazon Elastic Compute Cloud User Guide</i>.</p>
    */
@@ -4690,6 +4688,13 @@ export interface RequestLaunchTemplateData {
    * <p>The maintenance options for the instance.</p>
    */
   MaintenanceOptions?: LaunchTemplateInstanceMaintenanceOptionsRequest;
+
+  /**
+   * <p>Indicates whether to enable the instance for stop protection. For more information,
+   *             see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Stop_Start.html#Using_StopProtection">Stop
+   *                 Protection</a>.</p>
+   */
+  DisableApiStop?: boolean;
 }
 
 export namespace RequestLaunchTemplateData {
@@ -4713,7 +4718,7 @@ export interface CreateLaunchTemplateRequest {
   /**
    * <p>Unique, case-sensitive identifier you provide to ensure the idempotency of the
    *             request. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring
-   *                 Idempotency</a>.</p>
+   *                 idempotency</a>.</p>
    *         <p>Constraint: Maximum 128 ASCII characters.</p>
    */
   ClientToken?: string;
@@ -4805,15 +4810,15 @@ export namespace LaunchTemplate {
 export interface ValidationError {
   /**
    * <p>The error code that indicates why the parameter or parameter combination is not valid.
-   *             For more information about error codes, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/errors-overview.html.html">Error
-   *             Codes</a>.</p>
+   *             For more information about error codes, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/errors-overview.html">Error
+   *             codes</a>.</p>
    */
   Code?: string;
 
   /**
    * <p>The error message that describes why the parameter or parameter combination is not
-   *             valid. For more information about error messages, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/errors-overview.html.html">Error
-   *             Codes</a>.</p>
+   *             valid. For more information about error messages, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/errors-overview.html">Error
+   *             codes</a>.</p>
    */
   Message?: string;
 }
@@ -4883,7 +4888,7 @@ export interface CreateLaunchTemplateVersionRequest {
   /**
    * <p>Unique, case-sensitive identifier you provide to ensure the idempotency of the
    *             request. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring
-   *                 Idempotency</a>.</p>
+   *                 idempotency</a>.</p>
    *         <p>Constraint: Maximum 128 ASCII characters.</p>
    */
   ClientToken?: string;
@@ -5887,6 +5892,12 @@ export interface ResponseLaunchTemplateData {
    * <p>The maintenance options for your instance.</p>
    */
   MaintenanceOptions?: LaunchTemplateInstanceMaintenanceOptions;
+
+  /**
+   * <p>Indicates whether the instance is enabled for stop protection.
+   *             For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Stop_Start.html#Using_StopProtection">Stop Protection</a>.</p>
+   */
+  DisableApiStop?: boolean;
 }
 
 export namespace ResponseLaunchTemplateData {

clients/client-ec2/src/models/models_3.ts

@@ -5217,6 +5217,7 @@ export namespace DescribeImportSnapshotTasksResult {
 
 export type InstanceAttributeName =
   | "blockDeviceMapping"
+  | "disableApiStop"
   | "disableApiTermination"
   | "ebsOptimized"
   | "enaSupport"
@@ -5453,6 +5454,12 @@ export interface InstanceAttribute {
    * <p>The user data.</p>
    */
   UserData?: AttributeValue;
+
+  /**
+   * <p>To enable the instance for Amazon Web Services Stop Protection, set this parameter to
+   *             <code>true</code>; otherwise, set it to <code>false</code>.</p>
+   */
+  DisableApiStop?: AttributeBooleanValue;
 }
 
 export namespace InstanceAttribute {

clients/client-ec2/src/models/models_5.ts

@@ -4823,6 +4823,13 @@ export interface ModifyInstanceAttributeRequest {
    *                 <code>instanceInitiatedShutdownBehavior</code> attribute.</p>
    */
   Value?: string;
+
+  /**
+   * <p>Indicates whether an instance is enabled for stop protection.
+   *             For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Stop_Start.html#Using_StopProtection">Stop Protection</a>.</p>
+   *         <p></p>
+   */
+  DisableApiStop?: AttributeBooleanValue;
 }
 
 export namespace ModifyInstanceAttributeRequest {
@@ -5716,7 +5723,7 @@ export interface ModifyLaunchTemplateRequest {
   /**
    * <p>Unique, case-sensitive identifier you provide to ensure the idempotency of the
    *             request. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring
-   *                 Idempotency</a>.</p>
+   *                 idempotency</a>.</p>
    *         <p>Constraint: Maximum 128 ASCII characters.</p>
    */
   ClientToken?: string;

clients/client-ec2/src/models/models_6.ts

@@ -1911,6 +1911,14 @@ export interface RunInstancesRequest {
    * <p>The maintenance and recovery options for the instance.</p>
    */
   MaintenanceOptions?: InstanceMaintenanceOptionsRequest;
+
+  /**
+   * <p>Indicates whether an instance is enabled for stop protection. For more information,
+   *             see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Stop_Start.html#Using_StopProtection">Stop
+   *                 Protection</a>.
+   *         </p>
+   */
+  DisableApiStop?: boolean;
 }
 
 export namespace RunInstancesRequest {

clients/client-ec2/src/protocols/Aws_ec2.ts

@@ -47000,6 +47000,13 @@ const serializeAws_ec2ModifyInstanceAttributeRequest = (
   if (input.Value !== undefined && input.Value !== null) {
     entries["Value"] = input.Value;
   }
+  if (input.DisableApiStop !== undefined && input.DisableApiStop !== null) {
+    const memberEntries = serializeAws_ec2AttributeBooleanValue(input.DisableApiStop, context);
+    Object.entries(memberEntries).forEach(([key, value]) => {
+      const loc = `DisableApiStop.${key}`;
+      entries[loc] = value;
+    });
+  }
   return entries;
 };
 
@@ -50340,6 +50347,9 @@ const serializeAws_ec2RequestLaunchTemplateData = (input: RequestLaunchTemplateD
       entries[loc] = value;
     });
   }
+  if (input.DisableApiStop !== undefined && input.DisableApiStop !== null) {
+    entries["DisableApiStop"] = input.DisableApiStop;
+  }
   return entries;
 };
 
@@ -51299,6 +51309,9 @@ const serializeAws_ec2RunInstancesRequest = (input: RunInstancesRequest, context
       entries[loc] = value;
     });
   }
+  if (input.DisableApiStop !== undefined && input.DisableApiStop !== null) {
+    entries["DisableApiStop"] = input.DisableApiStop;
+  }
   return entries;
 };
 
@@ -67140,6 +67153,7 @@ const deserializeAws_ec2InstanceAttribute = (output: any, context: __SerdeContex
     SourceDestCheck: undefined,
     SriovNetSupport: undefined,
     UserData: undefined,
+    DisableApiStop: undefined,
   };
   if (output.groupSet === "") {
     contents.Groups = [];
@@ -67210,6 +67224,9 @@ const deserializeAws_ec2InstanceAttribute = (output: any, context: __SerdeContex
   if (output["userData"] !== undefined) {
     contents.UserData = deserializeAws_ec2AttributeValue(output["userData"], context);
   }
+  if (output["disableApiStop"] !== undefined) {
+    contents.DisableApiStop = deserializeAws_ec2AttributeBooleanValue(output["disableApiStop"], context);
+  }
   return contents;
 };
 
@@ -75337,6 +75354,7 @@ const deserializeAws_ec2ResponseLaunchTemplateData = (
     InstanceRequirements: undefined,
     PrivateDnsNameOptions: undefined,
     MaintenanceOptions: undefined,
+    DisableApiStop: undefined,
   };
   if (output["kernelId"] !== undefined) {
     contents.KernelId = __expectString(output["kernelId"]);
@@ -75504,6 +75522,9 @@ const deserializeAws_ec2ResponseLaunchTemplateData = (
       context
     );
   }
+  if (output["disableApiStop"] !== undefined) {
+    contents.DisableApiStop = __parseBoolean(output["disableApiStop"]);
+  }
   return contents;
 };