@aws-sdk/client-ec2 3.197.0 → 3.198.0

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [3.198.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.197.0...v3.198.0) (2022-10-27)
+
+
+### Features
+
+* **client-ec2:** Feature supports the replacement of instance root volume using an updated AMI without requiring customers to stop their instance. ([c980e67](https://github.com/aws/aws-sdk-js-v3/commit/c980e67bfad3191dab93e0cf1aa9eaec6addf08b))
+
+
+
+
+
 # [3.197.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.196.0...v3.197.0) (2022-10-26)
 
 

package/dist-cjs/protocols/Aws_ec2.js

@@ -24961,6 +24961,12 @@ const serializeAws_ec2CreateReplaceRootVolumeTaskRequest = (input, context) => {
             entries[loc] = value;
         });
     }
+    if (input.ImageId != null) {
+        entries["ImageId"] = input.ImageId;
+    }
+    if (input.DeleteReplacedRootVolume != null) {
+        entries["DeleteReplacedRootVolume"] = input.DeleteReplacedRootVolume;
+    }
     return entries;
 };
 const serializeAws_ec2CreateReservedInstancesListingRequest = (input, context) => {
@@ -57509,6 +57515,9 @@ const deserializeAws_ec2ReplaceRootVolumeTask = (output, context) => {
         StartTime: undefined,
         CompleteTime: undefined,
         Tags: undefined,
+        ImageId: undefined,
+        SnapshotId: undefined,
+        DeleteReplacedRootVolume: undefined,
     };
     if (output["replaceRootVolumeTaskId"] !== undefined) {
         contents.ReplaceRootVolumeTaskId = (0, smithy_client_1.expectString)(output["replaceRootVolumeTaskId"]);
@@ -57531,6 +57540,15 @@ const deserializeAws_ec2ReplaceRootVolumeTask = (output, context) => {
     else if (output["tagSet"] !== undefined && output["tagSet"]["item"] !== undefined) {
         contents.Tags = deserializeAws_ec2TagList((0, smithy_client_1.getArrayIfSingleItem)(output["tagSet"]["item"]), context);
     }
+    if (output["imageId"] !== undefined) {
+        contents.ImageId = (0, smithy_client_1.expectString)(output["imageId"]);
+    }
+    if (output["snapshotId"] !== undefined) {
+        contents.SnapshotId = (0, smithy_client_1.expectString)(output["snapshotId"]);
+    }
+    if (output["deleteReplacedRootVolume"] !== undefined) {
+        contents.DeleteReplacedRootVolume = (0, smithy_client_1.parseBoolean)(output["deleteReplacedRootVolume"]);
+    }
     return contents;
 };
 const deserializeAws_ec2ReplaceRootVolumeTasks = (output, context) => {

package/dist-es/protocols/Aws_ec2.js

@@ -23853,6 +23853,12 @@ const serializeAws_ec2CreateReplaceRootVolumeTaskRequest = (input, context) => {
             entries[loc] = value;
         });
     }
+    if (input.ImageId != null) {
+        entries["ImageId"] = input.ImageId;
+    }
+    if (input.DeleteReplacedRootVolume != null) {
+        entries["DeleteReplacedRootVolume"] = input.DeleteReplacedRootVolume;
+    }
     return entries;
 };
 const serializeAws_ec2CreateReservedInstancesListingRequest = (input, context) => {
@@ -56401,6 +56407,9 @@ const deserializeAws_ec2ReplaceRootVolumeTask = (output, context) => {
         StartTime: undefined,
         CompleteTime: undefined,
         Tags: undefined,
+        ImageId: undefined,
+        SnapshotId: undefined,
+        DeleteReplacedRootVolume: undefined,
     };
     if (output["replaceRootVolumeTaskId"] !== undefined) {
         contents.ReplaceRootVolumeTaskId = __expectString(output["replaceRootVolumeTaskId"]);
@@ -56423,6 +56432,15 @@ const deserializeAws_ec2ReplaceRootVolumeTask = (output, context) => {
     else if (output["tagSet"] !== undefined && output["tagSet"]["item"] !== undefined) {
         contents.Tags = deserializeAws_ec2TagList(__getArrayIfSingleItem(output["tagSet"]["item"]), context);
     }
+    if (output["imageId"] !== undefined) {
+        contents.ImageId = __expectString(output["imageId"]);
+    }
+    if (output["snapshotId"] !== undefined) {
+        contents.SnapshotId = __expectString(output["snapshotId"]);
+    }
+    if (output["deleteReplacedRootVolume"] !== undefined) {
+        contents.DeleteReplacedRootVolume = __parseBoolean(output["deleteReplacedRootVolume"]);
+    }
     return contents;
 };
 const deserializeAws_ec2ReplaceRootVolumeTasks = (output, context) => {

package/dist-types/EC2.d.ts

@@ -1652,9 +1652,10 @@ export declare class EC2 extends EC2Client {
     createPublicIpv4Pool(args: CreatePublicIpv4PoolCommandInput, cb: (err: any, data?: CreatePublicIpv4PoolCommandOutput) => void): void;
     createPublicIpv4Pool(args: CreatePublicIpv4PoolCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreatePublicIpv4PoolCommandOutput) => void): void;
     /**
-     * <p>Creates a root volume replacement task for an Amazon EC2 instance. The root volume
-     *       can either be restored to its initial launch state, or it can be restored using a
-     *       specific snapshot.</p>
+     * <p>Replaces the EBS-backed root volume for a <code>running</code> instance with a new
+     *       volume that is restored to the original root volume's launch state, that is restored to a
+     *       specific snapshot taken from the original root volume, or that is restored from an AMI
+     *       that has the same key characteristics as that of the instance.</p>
      *
      *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-restoring-volume.html#replace-root">Replace a root volume</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>
      */

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

@@ -8,9 +8,10 @@ export interface CreateReplaceRootVolumeTaskCommandInput extends CreateReplaceRo
 export interface CreateReplaceRootVolumeTaskCommandOutput extends CreateReplaceRootVolumeTaskResult, __MetadataBearer {
 }
 /**
- * <p>Creates a root volume replacement task for an Amazon EC2 instance. The root volume
- *       can either be restored to its initial launch state, or it can be restored using a
- *       specific snapshot.</p>
+ * <p>Replaces the EBS-backed root volume for a <code>running</code> instance with a new
+ *       volume that is restored to the original root volume's launch state, that is restored to a
+ *       specific snapshot taken from the original root volume, or that is restored from an AMI
+ *       that has the same key characteristics as that of the instance.</p>
  *
  *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-restoring-volume.html#replace-root">Replace a root volume</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>
  * @example

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

@@ -6196,8 +6196,12 @@ export interface CreateReplaceRootVolumeTaskRequest {
      */
     InstanceId: string | undefined;
     /**
-     * <p>The ID of the snapshot from which to restore the replacement root volume. If you want to
-     *       restore the volume to the initial launch state, omit this parameter.</p>
+     * <p>The ID of the snapshot from which to restore the replacement root volume. The
+     *       specified snapshot must be a snapshot that you previously created from the original
+     *       root volume.</p>
+     *          <p>If you want to restore the replacement root volume to the initial launch state,
+     *       or if you want to restore the replacement root volume from an AMI, omit this
+     *       parameter.</p>
      */
     SnapshotId?: string;
     /**
@@ -6216,6 +6220,21 @@ export interface CreateReplaceRootVolumeTaskRequest {
      * <p>The tags to apply to the root volume replacement task.</p>
      */
     TagSpecifications?: TagSpecification[];
+    /**
+     * <p>The ID of the AMI to use to restore the root volume. The specified AMI must have the
+     *       same product code, billing information, architecture type, and virtualization type as
+     *       that of the instance.</p>
+     *          <p>If you want to restore the replacement volume from a specific snapshot, or if you want
+     *       to restore it to its launch state, omit this parameter.</p>
+     */
+    ImageId?: string;
+    /**
+     * <p>Indicates whether to automatically delete the original root volume after the root volume
+     *       replacement task completes. To delete the original root volume, specify <code>true</code>.
+     *       If you choose to keep the original root volume after the replacement task completes, you must
+     *       manually delete it when you no longer need it.</p>
+     */
+    DeleteReplacedRootVolume?: boolean;
 }
 export declare enum ReplaceRootVolumeTaskState {
     failed = "failed",
@@ -6288,6 +6307,19 @@ export interface ReplaceRootVolumeTask {
      * <p>The tags assigned to the task.</p>
      */
     Tags?: Tag[];
+    /**
+     * <p>The ID of the AMI used to create the replacement root volume.</p>
+     */
+    ImageId?: string;
+    /**
+     * <p>The ID of the snapshot used to create the replacement root volume.</p>
+     */
+    SnapshotId?: string;
+    /**
+     * <p>Indicates whether the original root volume is to be deleted after the root volume
+     *       replacement task completes.</p>
+     */
+    DeleteReplacedRootVolume?: boolean;
 }
 export interface CreateReplaceRootVolumeTaskResult {
     /**

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

@@ -1626,6 +1626,8 @@ export interface CreateReplaceRootVolumeTaskRequest {
   ClientToken?: string;
   DryRun?: boolean;
   TagSpecifications?: TagSpecification[];
+  ImageId?: string;
+  DeleteReplacedRootVolume?: boolean;
 }
 export declare enum ReplaceRootVolumeTaskState {
   failed = "failed",
@@ -1642,6 +1644,9 @@ export interface ReplaceRootVolumeTask {
   StartTime?: string;
   CompleteTime?: string;
   Tags?: Tag[];
+  ImageId?: string;
+  SnapshotId?: string;
+  DeleteReplacedRootVolume?: boolean;
 }
 export interface CreateReplaceRootVolumeTaskResult {
   ReplaceRootVolumeTask?: ReplaceRootVolumeTask;

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.197.0",
+  "version": "3.198.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -19,41 +19,41 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "2.0.0",
     "@aws-crypto/sha256-js": "2.0.0",
-    "@aws-sdk/client-sts": "3.197.0",
-    "@aws-sdk/config-resolver": "3.197.0",
-    "@aws-sdk/credential-provider-node": "3.197.0",
-    "@aws-sdk/fetch-http-handler": "3.197.0",
-    "@aws-sdk/hash-node": "3.197.0",
-    "@aws-sdk/invalid-dependency": "3.197.0",
-    "@aws-sdk/middleware-content-length": "3.197.0",
-    "@aws-sdk/middleware-endpoint": "3.197.0",
-    "@aws-sdk/middleware-host-header": "3.197.0",
-    "@aws-sdk/middleware-logger": "3.197.0",
-    "@aws-sdk/middleware-recursion-detection": "3.197.0",
-    "@aws-sdk/middleware-retry": "3.197.0",
-    "@aws-sdk/middleware-sdk-ec2": "3.197.0",
-    "@aws-sdk/middleware-serde": "3.197.0",
-    "@aws-sdk/middleware-signing": "3.197.0",
-    "@aws-sdk/middleware-stack": "3.197.0",
-    "@aws-sdk/middleware-user-agent": "3.197.0",
-    "@aws-sdk/node-config-provider": "3.197.0",
-    "@aws-sdk/node-http-handler": "3.197.0",
-    "@aws-sdk/protocol-http": "3.197.0",
-    "@aws-sdk/smithy-client": "3.197.0",
-    "@aws-sdk/types": "3.197.0",
-    "@aws-sdk/url-parser": "3.197.0",
+    "@aws-sdk/client-sts": "3.198.0",
+    "@aws-sdk/config-resolver": "3.198.0",
+    "@aws-sdk/credential-provider-node": "3.198.0",
+    "@aws-sdk/fetch-http-handler": "3.198.0",
+    "@aws-sdk/hash-node": "3.198.0",
+    "@aws-sdk/invalid-dependency": "3.198.0",
+    "@aws-sdk/middleware-content-length": "3.198.0",
+    "@aws-sdk/middleware-endpoint": "3.198.0",
+    "@aws-sdk/middleware-host-header": "3.198.0",
+    "@aws-sdk/middleware-logger": "3.198.0",
+    "@aws-sdk/middleware-recursion-detection": "3.198.0",
+    "@aws-sdk/middleware-retry": "3.198.0",
+    "@aws-sdk/middleware-sdk-ec2": "3.198.0",
+    "@aws-sdk/middleware-serde": "3.198.0",
+    "@aws-sdk/middleware-signing": "3.198.0",
+    "@aws-sdk/middleware-stack": "3.198.0",
+    "@aws-sdk/middleware-user-agent": "3.198.0",
+    "@aws-sdk/node-config-provider": "3.198.0",
+    "@aws-sdk/node-http-handler": "3.198.0",
+    "@aws-sdk/protocol-http": "3.198.0",
+    "@aws-sdk/smithy-client": "3.198.0",
+    "@aws-sdk/types": "3.198.0",
+    "@aws-sdk/url-parser": "3.198.0",
     "@aws-sdk/util-base64-browser": "3.188.0",
     "@aws-sdk/util-base64-node": "3.188.0",
     "@aws-sdk/util-body-length-browser": "3.188.0",
     "@aws-sdk/util-body-length-node": "3.188.0",
-    "@aws-sdk/util-defaults-mode-browser": "3.197.0",
-    "@aws-sdk/util-defaults-mode-node": "3.197.0",
-    "@aws-sdk/util-endpoints": "3.197.0",
-    "@aws-sdk/util-user-agent-browser": "3.197.0",
-    "@aws-sdk/util-user-agent-node": "3.197.0",
+    "@aws-sdk/util-defaults-mode-browser": "3.198.0",
+    "@aws-sdk/util-defaults-mode-node": "3.198.0",
+    "@aws-sdk/util-endpoints": "3.198.0",
+    "@aws-sdk/util-user-agent-browser": "3.198.0",
+    "@aws-sdk/util-user-agent-node": "3.198.0",
     "@aws-sdk/util-utf8-browser": "3.188.0",
     "@aws-sdk/util-utf8-node": "3.188.0",
-    "@aws-sdk/util-waiter": "3.197.0",
+    "@aws-sdk/util-waiter": "3.198.0",
     "fast-xml-parser": "4.0.11",
     "tslib": "^2.3.1",
     "uuid": "^8.3.2"