@aws-sdk/client-ec2 3.850.0 → 3.852.0

package/dist-cjs/index.js

@@ -39490,6 +39490,9 @@ var se_StopInstancesRequest = /* @__PURE__ */ __name((input, context) => {
   if (input[_Hi] != null) {
     entries[_Hi] = input[_Hi];
   }
+  if (input[_SOS] != null) {
+    entries[_SOS] = input[_SOS];
+  }
   if (input[_DRr] != null) {
     entries[_DRr] = input[_DRr];
   }
@@ -39727,6 +39730,9 @@ var se_TerminateInstancesRequest = /* @__PURE__ */ __name((input, context) => {
       entries[loc] = value;
     });
   }
+  if (input[_SOS] != null) {
+    entries[_SOS] = input[_SOS];
+  }
   if (input[_DRr] != null) {
     entries[_DRr] = input[_DRr];
   }
@@ -65722,6 +65728,7 @@ var _SNe = "ServiceName";
 var _SNeq = "SequenceNumber";
 var _SNer = "ServiceNames";
 var _SO = "SpotOptions";
+var _SOS = "SkipOsShutdown";
 var _SOT = "S3ObjectTags";
 var _SP = "S3Prefix";
 var _SPA = "SamlProviderArn";

package/dist-es/protocols/Aws_ec2.js

@@ -37897,6 +37897,9 @@ const se_StopInstancesRequest = (input, context) => {
     if (input[_Hi] != null) {
         entries[_Hi] = input[_Hi];
     }
+    if (input[_SOS] != null) {
+        entries[_SOS] = input[_SOS];
+    }
     if (input[_DRr] != null) {
         entries[_DRr] = input[_DRr];
     }
@@ -38134,6 +38137,9 @@ const se_TerminateInstancesRequest = (input, context) => {
             entries[loc] = value;
         });
     }
+    if (input[_SOS] != null) {
+        entries[_SOS] = input[_SOS];
+    }
     if (input[_DRr] != null) {
         entries[_DRr] = input[_DRr];
     }
@@ -65654,6 +65660,7 @@ const _SNe = "ServiceName";
 const _SNeq = "SequenceNumber";
 const _SNer = "ServiceNames";
 const _SO = "SpotOptions";
+const _SOS = "SkipOsShutdown";
 const _SOT = "S3ObjectTags";
 const _SP = "S3Prefix";
 const _SPA = "SamlProviderArn";

package/dist-types/commands/StartDeclarativePoliciesReportCommand.d.ts

@@ -35,10 +35,9 @@ declare const StartDeclarativePoliciesReportCommand_base: {
  *             accounts that fall under the specified organizational unit (OU) or root (the entire
  *                 Amazon Web Services Organization).</p>
  *          <p>The report is saved to your specified S3 bucket, using the following path structure
- *             (with the <i>italicized placeholders</i> representing your specific
- *             values):</p>
+ *             (with the capitalized placeholders representing your specific values):</p>
  *          <p>
- *             <code>s3://<i>amzn-s3-demo-bucket</i>/<i>your-optional-s3-prefix</i>/ec2_<i>targetId</i>_<i>reportId</i>_<i>yyyyMMdd</i>T<i>hhmm</i>Z.csv</code>
+ *             <code>s3://AMZN-S3-DEMO-BUCKET/YOUR-OPTIONAL-S3-PREFIX/ec2_TARGETID_REPORTID_YYYYMMDDTHHMMZ.csv</code>
  *          </p>
  *          <p class="title">
  *             <b>Prerequisites for generating a report</b>

package/dist-types/commands/StopInstancesCommand.d.ts

@@ -30,17 +30,21 @@ declare const StopInstancesCommand_base: {
  * <p>Stops an Amazon EBS-backed instance. You can restart your instance at any time using
  *             the <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_StartInstances.html">StartInstances</a> API. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Stop_Start.html">Stop and start Amazon EC2
  *                 instances</a> in the <i>Amazon EC2 User Guide</i>.</p>
- *          <p>When you stop an instance, we shut it down.</p>
- *          <p>You can use the Stop operation together with the Hibernate parameter to hibernate an
- *             instance if the instance is <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/enabling-hibernation.html">enabled for
+ *          <p>When you stop or hibernate an instance, we shut it down. By default, this includes a
+ *             graceful operating system (OS) shutdown. To bypass the graceful shutdown, use the
+ *                 <code>skipOsShutdown</code> parameter; however, this might risk data
+ *             integrity.</p>
+ *          <p>You can use the StopInstances operation together with the <code>Hibernate</code>
+ *             parameter to hibernate an instance if the instance is <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/enabling-hibernation.html">enabled for
  *                 hibernation</a> and meets the <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/hibernating-prerequisites.html">hibernation
  *                 prerequisites</a>. Stopping an instance doesn't preserve data stored in RAM,
  *             while hibernation does. If hibernation fails, a normal shutdown occurs. For more
  *             information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html">Hibernate your Amazon EC2
  *                 instance</a> in the <i>Amazon EC2 User Guide</i>.</p>
  *          <p>If your instance appears stuck in the <code>stopping</code> state, there might be an
- *             issue with the underlying host computer. You can use the Stop operation together with
- *             the Force parameter to force stop your instance. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/TroubleshootingInstancesStopping.html">Troubleshoot
+ *             issue with the underlying host computer. You can use the StopInstances operation
+ *             together with the Force parameter to force stop your instance. For more information, see
+ *                 <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/TroubleshootingInstancesStopping.html">Troubleshoot
  *                     Amazon EC2 instance stop issues</a> in the
  *                 <i>Amazon EC2 User Guide</i>.</p>
  *          <p>Stopping and hibernating an instance differs from rebooting or terminating it. For
@@ -65,6 +69,7 @@ declare const StopInstancesCommand_base: {
  *     "STRING_VALUE",
  *   ],
  *   Hibernate: true || false,
+ *   SkipOsShutdown: true || false,
  *   DryRun: true || false,
  *   Force: true || false,
  * };

package/dist-types/commands/TerminateInstancesCommand.d.ts

@@ -77,16 +77,23 @@ declare const TerminateInstancesCommand_base: {
  *             hour).</p>
  *          <p>By default, Amazon EC2 deletes all EBS volumes that were attached when the instance
  *             launched. Volumes attached after instance launch continue running.</p>
+ *          <p>By default, the TerminateInstances operation includes a graceful operating system (OS)
+ *             shutdown. To bypass the graceful shutdown, use the <code>skipOsShutdown</code>
+ *             parameter; however, this might risk data integrity.</p>
  *          <p>You can stop, start, and terminate EBS-backed instances. You can only terminate
  *             instance store-backed instances. What happens to an instance differs if you stop or
  *             terminate it. For example, when you stop an instance, the root device and any other
  *             devices attached to the instance persist. When you terminate an instance, any attached
  *             EBS volumes with the <code>DeleteOnTermination</code> block device mapping parameter set
  *             to <code>true</code> are automatically deleted. For more information about the
- *             differences between stopping and terminating instances, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-lifecycle.html">Instance lifecycle</a>
- *             in the <i>Amazon EC2 User Guide</i>.</p>
- *          <p>For more information about troubleshooting, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/TroubleshootingInstancesShuttingDown.html">Troubleshooting terminating your instance</a> in the
- *    <i>Amazon EC2 User Guide</i>.</p>
+ *             differences between stopping and terminating instances, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-lifecycle.html">Amazon EC2
+ *                 instance state changes</a> in the <i>Amazon EC2 User Guide</i>.</p>
+ *          <p>When you terminate an instance, we attempt to terminate it forcibly after a short
+ *             while. If your instance appears stuck in the shutting-down state after a period of time,
+ *             there might be an issue with the underlying host computer. For more information about
+ *             terminating and troubleshooting terminating your instances, see <a href="https://docs.aws.amazon.com/">Terminate Amazon EC2 instances</a> and
+ *                 <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/TroubleshootingInstancesShuttingDown.html">Troubleshooting terminating your instance</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
@@ -97,6 +104,7 @@ declare const TerminateInstancesCommand_base: {
  *   InstanceIds: [ // InstanceIdStringList // required
  *     "STRING_VALUE",
  *   ],
+ *   SkipOsShutdown: true || false,
  *   DryRun: true || false,
  * };
  * const command = new TerminateInstancesCommand(input);

package/dist-types/models/models_1.d.ts

@@ -410,7 +410,7 @@ export interface CreateCapacityReservationRequest {
      * <p>The instance type for which to reserve capacity.</p>
      *          <note>
      *             <p>You can request future-dated Capacity Reservations for instance types in the C, M,
-     * 				R, I, and T instance families only.</p>
+     * 				R, I, T, and G instance families only.</p>
      *          </note>
      *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html">Instance types</a> in the
      * 				<i>Amazon EC2 User Guide</i>.</p>
@@ -454,9 +454,9 @@ export interface CreateCapacityReservationRequest {
      * <p>The number of instances for which to reserve capacity.</p>
      *          <note>
      *             <p>You can request future-dated Capacity Reservations for an instance count with a
-     * 				minimum of 100 vCPUs. For example, if you request a future-dated Capacity
+     * 				minimum of 64 vCPUs. For example, if you request a future-dated Capacity
      * 				Reservation for <code>m5.xlarge</code> instances, you must request at least 25
-     * 				instances (<i>25 * m5.xlarge = 100 vCPUs</i>).</p>
+     * 				instances (<i>16 * m5.xlarge = 64 vCPUs</i>).</p>
      *          </note>
      *          <p>Valid range: 1 - 1000</p>
      * @public
@@ -7266,8 +7266,11 @@ export interface EbsBlockDevice {
      *             but not both. If neither is specified, Amazon EC2 automatically selects an Availability Zone within
      *             the Region.</p>
      *          <p>This parameter is not supported when using
+     *             <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateFleet.html">CreateFleet</a>,
      *             <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateImage.html">CreateImage</a>,
-     *             <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeImages.html">DescribeImages</a>, and
+     *             <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeImages.html">DescribeImages</a>,
+     *             <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RequestSpotFleet.html">RequestSpotFleet</a>,
+     *             <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RequestSpotInstances.html">RequestSpotInstances</a>, and
      *             <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html">RunInstances</a>.</p>
      * @public
      */
@@ -7348,8 +7351,11 @@ export interface EbsBlockDevice {
      *             but not both. If neither is specified, Amazon EC2 automatically selects an Availability Zone within
      *             the Region.</p>
      *          <p>This parameter is not supported when using
+     *             <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateFleet.html">CreateFleet</a>,
      *             <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateImage.html">CreateImage</a>,
-     *             <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeImages.html">DescribeImages</a>, and
+     *             <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeImages.html">DescribeImages</a>,
+     *             <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RequestSpotFleet.html">RequestSpotFleet</a>,
+     *             <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RequestSpotInstances.html">RequestSpotInstances</a>, and
      *             <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html">RunInstances</a>.</p>
      * @public
      */

package/dist-types/models/models_4.d.ts

@@ -9104,8 +9104,8 @@ export interface DescribeInstanceTypesRequest {
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>free-tier-eligible</code> - Indicates whether the instance type is eligible to use
-     *      in the free tier  (<code>true</code> | <code>false</code>).</p>
+     *                   <code>free-tier-eligible</code> - A Boolean that indicates whether this instance type can
+     *      be used under the Amazon Web Services Free Tier  (<code>true</code> | <code>false</code>).</p>
      *             </li>
      *             <li>
      *                <p>

package/dist-types/models/models_8.d.ts

@@ -2138,8 +2138,8 @@ export interface RunInstancesRequest {
      */
     ImageId?: string | undefined;
     /**
-     * <p>The instance type. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html">Amazon EC2 instance
-     *                 types</a> in the <i>Amazon EC2 User Guide</i>.</p>
+     * <p>The instance type. For more information, see <a href="https://docs.aws.amazon.com/ec2/latest/instancetypes/instance-types.html">Amazon EC2 Instance
+     *                 Types Guide</a>.</p>
      * @public
      */
     InstanceType?: _InstanceType | undefined;
@@ -2175,8 +2175,7 @@ export interface RunInstancesRequest {
      */
     KernelId?: string | undefined;
     /**
-     * <p>The name of the key pair. You can create a key pair using <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateKeyPair.html">CreateKeyPair</a> or
-     *                 <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ImportKeyPair.html">ImportKeyPair</a>.</p>
+     * <p>The name of the key pair. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/create-key-pairs.html">Create a key pair for your EC2 instance</a>.</p>
      *          <important>
      *             <p>If you do not specify a key pair, you can't connect to the instance unless you
      *                 choose an AMI that is configured to allow users another way to log in.</p>
@@ -2227,7 +2226,7 @@ export interface RunInstancesRequest {
      */
     RamdiskId?: string | undefined;
     /**
-     * <p>The IDs of the security groups. You can create a security group using <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateSecurityGroup.html">CreateSecurityGroup</a>.</p>
+     * <p>The IDs of the security groups.</p>
      *          <p>If you specify a network interface, you must specify any security groups as part of
      *             the network interface instead of using this parameter.</p>
      * @public
@@ -2251,7 +2250,7 @@ export interface RunInstancesRequest {
     /**
      * <p>The user data to make available to the instance. User data must be base64-encoded.
      *             Depending on the tool or SDK that you're using, the base64-encoding might be performed for you.
-     *             For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-add-user-data.html">Work with instance user data</a>.</p>
+     *             For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/user-data.html">Run commands at launch using instance user data</a>.</p>
      * @public
      */
     UserData?: string | undefined;
@@ -2348,15 +2347,14 @@ export interface RunInstancesRequest {
      */
     LicenseSpecifications?: LicenseConfigurationRequest[] | undefined;
     /**
-     * <p>The metadata options for the instance. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html">Instance metadata and user data</a>.</p>
+     * <p>The metadata options for the instance. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-options.html">Configure the Instance Metadata Service options</a>.</p>
      * @public
      */
     MetadataOptions?: InstanceMetadataOptionsRequest | undefined;
     /**
      * <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> in the <i>Amazon Web Services Nitro Enclaves User
-     *                 Guide</i>.</p>
+     *             more information, see <a href="https://docs.aws.amazon.com/enclaves/latest/user/">Amazon Web Services Nitro
+     *                 Enclaves User Guide</a>.</p>
      *          <p>You can't enable Amazon Web Services Nitro Enclaves and hibernation on the same
      *             instance.</p>
      * @public
@@ -2376,8 +2374,7 @@ export interface RunInstancesRequest {
     MaintenanceOptions?: InstanceMaintenanceOptionsRequest | undefined;
     /**
      * <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>
+     *             see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-stop-protection.html">Enable stop protection for your EC2 instances</a>.</p>
      * @public
      */
     DisableApiStop?: boolean | undefined;
@@ -2447,8 +2444,7 @@ export interface RunInstancesRequest {
      * <p>Unique, case-sensitive identifier you provide to ensure the idempotency of the
      *             request. If you do not specify a client token, a randomly generated token is used for
      *             the request to ensure idempotency.</p>
-     *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring
-     *                 Idempotency</a>.</p>
+     *          <p>For more information, see <a href="https://docs.aws.amazon.com/ec2/latest/devguide/ec2-api-idempotency.html">Ensuring idempotency in Amazon EC2 API requests</a>.</p>
      *          <p>Constraints: Maximum 64 ASCII characters</p>
      * @public
      */
@@ -3411,12 +3407,26 @@ export interface StopInstancesRequest {
      * <p>Hibernates the instance if the instance was enabled for hibernation at launch. If the
      *             instance cannot hibernate successfully, a normal shutdown occurs. For more information,
      *             see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html">Hibernate
-     *                 your instance</a> in the <i>Amazon EC2 User Guide</i>.</p>
+     *                 your Amazon EC2 instance</a> in the
+     *                 <i>Amazon EC2 User Guide</i>.</p>
      *          <p> Default: <code>false</code>
      *          </p>
      * @public
      */
     Hibernate?: boolean | undefined;
+    /**
+     * <p>Specifies whether to bypass the graceful OS shutdown process when the instance is
+     *             stopped.</p>
+     *          <important>
+     *             <p>Bypassing the graceful OS shutdown might result in data loss or corruption (for
+     *                 example, memory contents not flushed to disk or loss of in-flight IOs) or skipped
+     *                 shutdown scripts.</p>
+     *          </important>
+     *          <p>Default: <code>false</code>
+     *          </p>
+     * @public
+     */
+    SkipOsShutdown?: boolean | undefined;
     /**
      * <p>Checks whether you have the required permissions for the operation, without actually making the
      *   request, and provides an error response. If you have the required permissions, the error response is
@@ -3527,6 +3537,14 @@ export interface TerminateInstancesRequest {
      * @public
      */
     InstanceIds: string[] | undefined;
+    /**
+     * <p>Specifies whether to bypass the graceful OS shutdown process when the instance is
+     *             terminated.</p>
+     *          <p>Default: <code>false</code>
+     *          </p>
+     * @public
+     */
+    SkipOsShutdown?: boolean | undefined;
     /**
      * <p>Checks whether you have the required permissions for the operation, without actually making the
      *   request, and provides an error response. If you have the required permissions, the error response is

package/dist-types/ts3.4/models/models_8.d.ts

@@ -739,6 +739,7 @@ export interface StartVpcEndpointServicePrivateDnsVerificationResult {
 export interface StopInstancesRequest {
   InstanceIds: string[] | undefined;
   Hibernate?: boolean | undefined;
+  SkipOsShutdown?: boolean | undefined;
   DryRun?: boolean | undefined;
   Force?: boolean | undefined;
 }
@@ -763,6 +764,7 @@ export interface TerminateClientVpnConnectionsResult {
 }
 export interface TerminateInstancesRequest {
   InstanceIds: string[] | undefined;
+  SkipOsShutdown?: boolean | undefined;
   DryRun?: boolean | undefined;
 }
 export interface TerminateInstancesResult {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-ec2",
   "description": "AWS SDK for JavaScript Ec2 Client for Node.js, Browser and React Native",
-  "version": "3.850.0",
+  "version": "3.852.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-ec2",