@aws-sdk/client-auto-scaling 3.267.0 → 3.271.0

package/dist-es/models/models_0.js

@@ -213,6 +213,18 @@ export class InvalidNextToken extends __BaseException {
         Object.setPrototypeOf(this, InvalidNextToken.prototype);
     }
 }
+export var ScaleInProtectedInstances;
+(function (ScaleInProtectedInstances) {
+    ScaleInProtectedInstances["Ignore"] = "Ignore";
+    ScaleInProtectedInstances["Refresh"] = "Refresh";
+    ScaleInProtectedInstances["Wait"] = "Wait";
+})(ScaleInProtectedInstances || (ScaleInProtectedInstances = {}));
+export var StandbyInstances;
+(function (StandbyInstances) {
+    StandbyInstances["Ignore"] = "Ignore";
+    StandbyInstances["Terminate"] = "Terminate";
+    StandbyInstances["Wait"] = "Wait";
+})(StandbyInstances || (StandbyInstances = {}));
 export var InstanceRefreshStatus;
 (function (InstanceRefreshStatus) {
     InstanceRefreshStatus["Cancelled"] = "Cancelled";
@@ -220,6 +232,9 @@ export var InstanceRefreshStatus;
     InstanceRefreshStatus["Failed"] = "Failed";
     InstanceRefreshStatus["InProgress"] = "InProgress";
     InstanceRefreshStatus["Pending"] = "Pending";
+    InstanceRefreshStatus["RollbackFailed"] = "RollbackFailed";
+    InstanceRefreshStatus["RollbackInProgress"] = "RollbackInProgress";
+    InstanceRefreshStatus["RollbackSuccessful"] = "RollbackSuccessful";
     InstanceRefreshStatus["Successful"] = "Successful";
 })(InstanceRefreshStatus || (InstanceRefreshStatus = {}));
 export var PredictiveScalingMaxCapacityBreachBehavior;
@@ -268,6 +283,18 @@ export var MetricType;
     MetricType["ASGAverageNetworkIn"] = "ASGAverageNetworkIn";
     MetricType["ASGAverageNetworkOut"] = "ASGAverageNetworkOut";
 })(MetricType || (MetricType = {}));
+export class IrreversibleInstanceRefreshFault extends __BaseException {
+    constructor(opts) {
+        super({
+            name: "IrreversibleInstanceRefreshFault",
+            $fault: "client",
+            ...opts,
+        });
+        this.name = "IrreversibleInstanceRefreshFault";
+        this.$fault = "client";
+        Object.setPrototypeOf(this, IrreversibleInstanceRefreshFault.prototype);
+    }
+}
 export class InstanceRefreshInProgressFault extends __BaseException {
     constructor(opts) {
         super({
@@ -518,6 +545,9 @@ export const InstanceRefreshWarmPoolProgressFilterSensitiveLog = (obj) => ({
 export const InstanceRefreshProgressDetailsFilterSensitiveLog = (obj) => ({
     ...obj,
 });
+export const RollbackDetailsFilterSensitiveLog = (obj) => ({
+    ...obj,
+});
 export const InstanceRefreshFilterSensitiveLog = (obj) => ({
     ...obj,
 });
@@ -779,6 +809,12 @@ export const RecordLifecycleActionHeartbeatTypeFilterSensitiveLog = (obj) => ({
 export const ScalingProcessQueryFilterSensitiveLog = (obj) => ({
     ...obj,
 });
+export const RollbackInstanceRefreshAnswerFilterSensitiveLog = (obj) => ({
+    ...obj,
+});
+export const RollbackInstanceRefreshTypeFilterSensitiveLog = (obj) => ({
+    ...obj,
+});
 export const SetDesiredCapacityTypeFilterSensitiveLog = (obj) => ({
     ...obj,
 });

package/dist-es/protocols/Aws_query.js

@@ -2,7 +2,7 @@ import { HttpRequest as __HttpRequest } from "@aws-sdk/protocol-http";
 import { decorateServiceException as __decorateServiceException, expectNonNull as __expectNonNull, expectString as __expectString, extendedEncodeURIComponent as __extendedEncodeURIComponent, getArrayIfSingleItem as __getArrayIfSingleItem, getValueFromTextNode as __getValueFromTextNode, parseBoolean as __parseBoolean, parseRfc3339DateTimeWithOffset as __parseRfc3339DateTimeWithOffset, serializeFloat as __serializeFloat, strictParseFloat as __strictParseFloat, strictParseInt32 as __strictParseInt32, throwDefaultError, } from "@aws-sdk/smithy-client";
 import { XMLParser } from "fast-xml-parser";
 import { AutoScalingServiceException as __BaseException } from "../models/AutoScalingServiceException";
-import { ActiveInstanceRefreshNotFoundFault, AlreadyExistsFault, InstanceRefreshInProgressFault, InvalidNextToken, LimitExceededFault, ResourceContentionFault, ResourceInUseFault, ScalingActivityInProgressFault, ServiceLinkedRoleFailure, } from "../models/models_0";
+import { ActiveInstanceRefreshNotFoundFault, AlreadyExistsFault, InstanceRefreshInProgressFault, InvalidNextToken, IrreversibleInstanceRefreshFault, LimitExceededFault, ResourceContentionFault, ResourceInUseFault, ScalingActivityInProgressFault, ServiceLinkedRoleFailure, } from "../models/models_0";
 export const serializeAws_queryAttachInstancesCommand = async (input, context) => {
     const headers = {
         "content-type": "application/x-www-form-urlencoded",
@@ -673,6 +673,18 @@ export const serializeAws_queryResumeProcessesCommand = async (input, context) =
     });
     return buildHttpRpcRequest(context, headers, "/", undefined, body);
 };
+export const serializeAws_queryRollbackInstanceRefreshCommand = async (input, context) => {
+    const headers = {
+        "content-type": "application/x-www-form-urlencoded",
+    };
+    let body;
+    body = buildFormUrlencodedString({
+        ...serializeAws_queryRollbackInstanceRefreshType(input, context),
+        Action: "RollbackInstanceRefresh",
+        Version: "2011-01-01",
+    });
+    return buildHttpRpcRequest(context, headers, "/", undefined, body);
+};
 export const serializeAws_querySetDesiredCapacityCommand = async (input, context) => {
     const headers = {
         "content-type": "application/x-www-form-urlencoded",
@@ -2737,6 +2749,48 @@ const deserializeAws_queryResumeProcessesCommandError = async (output, context)
             });
     }
 };
+export const deserializeAws_queryRollbackInstanceRefreshCommand = async (output, context) => {
+    if (output.statusCode >= 300) {
+        return deserializeAws_queryRollbackInstanceRefreshCommandError(output, context);
+    }
+    const data = await parseBody(output.body, context);
+    let contents = {};
+    contents = deserializeAws_queryRollbackInstanceRefreshAnswer(data.RollbackInstanceRefreshResult, context);
+    const response = {
+        $metadata: deserializeMetadata(output),
+        ...contents,
+    };
+    return Promise.resolve(response);
+};
+const deserializeAws_queryRollbackInstanceRefreshCommandError = async (output, context) => {
+    const parsedOutput = {
+        ...output,
+        body: await parseErrorBody(output.body, context),
+    };
+    const errorCode = loadQueryErrorCode(output, parsedOutput.body);
+    switch (errorCode) {
+        case "ActiveInstanceRefreshNotFound":
+        case "com.amazonaws.autoscaling#ActiveInstanceRefreshNotFoundFault":
+            throw await deserializeAws_queryActiveInstanceRefreshNotFoundFaultResponse(parsedOutput, context);
+        case "IrreversibleInstanceRefresh":
+        case "com.amazonaws.autoscaling#IrreversibleInstanceRefreshFault":
+            throw await deserializeAws_queryIrreversibleInstanceRefreshFaultResponse(parsedOutput, context);
+        case "LimitExceeded":
+        case "com.amazonaws.autoscaling#LimitExceededFault":
+            throw await deserializeAws_queryLimitExceededFaultResponse(parsedOutput, context);
+        case "ResourceContention":
+        case "com.amazonaws.autoscaling#ResourceContentionFault":
+            throw await deserializeAws_queryResourceContentionFaultResponse(parsedOutput, context);
+        default:
+            const parsedBody = parsedOutput.body;
+            throwDefaultError({
+                output,
+                parsedBody: parsedBody.Error,
+                exceptionCtor: __BaseException,
+                errorCode,
+            });
+    }
+};
 export const deserializeAws_querySetDesiredCapacityCommand = async (output, context) => {
     if (output.statusCode >= 300) {
         return deserializeAws_querySetDesiredCapacityCommandError(output, context);
@@ -3016,6 +3070,15 @@ const deserializeAws_queryInvalidNextTokenResponse = async (parsedOutput, contex
     });
     return __decorateServiceException(exception, body);
 };
+const deserializeAws_queryIrreversibleInstanceRefreshFaultResponse = async (parsedOutput, context) => {
+    const body = parsedOutput.body;
+    const deserialized = deserializeAws_queryIrreversibleInstanceRefreshFault(body.Error, context);
+    const exception = new IrreversibleInstanceRefreshFault({
+        $metadata: deserializeMetadata(parsedOutput),
+        ...deserialized,
+    });
+    return __decorateServiceException(exception, body);
+};
 const deserializeAws_queryLimitExceededFaultResponse = async (parsedOutput, context) => {
     const body = parsedOutput.body;
     const deserialized = deserializeAws_queryLimitExceededFault(body.Error, context);
@@ -5304,6 +5367,22 @@ const serializeAws_queryRefreshPreferences = (input, context) => {
     if (input.SkipMatching != null) {
         entries["SkipMatching"] = input.SkipMatching;
     }
+    if (input.AutoRollback != null) {
+        entries["AutoRollback"] = input.AutoRollback;
+    }
+    if (input.ScaleInProtectedInstances != null) {
+        entries["ScaleInProtectedInstances"] = input.ScaleInProtectedInstances;
+    }
+    if (input.StandbyInstances != null) {
+        entries["StandbyInstances"] = input.StandbyInstances;
+    }
+    return entries;
+};
+const serializeAws_queryRollbackInstanceRefreshType = (input, context) => {
+    const entries = {};
+    if (input.AutoScalingGroupName != null) {
+        entries["AutoScalingGroupName"] = input.AutoScalingGroupName;
+    }
     return entries;
 };
 const serializeAws_queryScalingProcessQuery = (input, context) => {
@@ -6875,6 +6954,7 @@ const deserializeAws_queryInstanceRefresh = (output, context) => {
         ProgressDetails: undefined,
         Preferences: undefined,
         DesiredConfiguration: undefined,
+        RollbackDetails: undefined,
     };
     if (output["InstanceRefreshId"] !== undefined) {
         contents.InstanceRefreshId = __expectString(output["InstanceRefreshId"]);
@@ -6909,6 +6989,9 @@ const deserializeAws_queryInstanceRefresh = (output, context) => {
     if (output["DesiredConfiguration"] !== undefined) {
         contents.DesiredConfiguration = deserializeAws_queryDesiredConfiguration(output["DesiredConfiguration"], context);
     }
+    if (output["RollbackDetails"] !== undefined) {
+        contents.RollbackDetails = deserializeAws_queryRollbackDetails(output["RollbackDetails"], context);
+    }
     return contents;
 };
 const deserializeAws_queryInstanceRefreshes = (output, context) => {
@@ -7142,6 +7225,15 @@ const deserializeAws_queryInvalidNextToken = (output, context) => {
     }
     return contents;
 };
+const deserializeAws_queryIrreversibleInstanceRefreshFault = (output, context) => {
+    const contents = {
+        message: undefined,
+    };
+    if (output["message"] !== undefined) {
+        contents.message = __expectString(output["message"]);
+    }
+    return contents;
+};
 const deserializeAws_queryLaunchConfiguration = (output, context) => {
     const contents = {
         LaunchConfigurationName: undefined,
@@ -7921,6 +8013,9 @@ const deserializeAws_queryRefreshPreferences = (output, context) => {
         CheckpointPercentages: undefined,
         CheckpointDelay: undefined,
         SkipMatching: undefined,
+        AutoRollback: undefined,
+        ScaleInProtectedInstances: undefined,
+        StandbyInstances: undefined,
     };
     if (output["MinHealthyPercentage"] !== undefined) {
         contents.MinHealthyPercentage = __strictParseInt32(output["MinHealthyPercentage"]);
@@ -7940,6 +8035,15 @@ const deserializeAws_queryRefreshPreferences = (output, context) => {
     if (output["SkipMatching"] !== undefined) {
         contents.SkipMatching = __parseBoolean(output["SkipMatching"]);
     }
+    if (output["AutoRollback"] !== undefined) {
+        contents.AutoRollback = __parseBoolean(output["AutoRollback"]);
+    }
+    if (output["ScaleInProtectedInstances"] !== undefined) {
+        contents.ScaleInProtectedInstances = __expectString(output["ScaleInProtectedInstances"]);
+    }
+    if (output["StandbyInstances"] !== undefined) {
+        contents.StandbyInstances = __expectString(output["StandbyInstances"]);
+    }
     return contents;
 };
 const deserializeAws_queryResourceContentionFault = (output, context) => {
@@ -7960,6 +8064,40 @@ const deserializeAws_queryResourceInUseFault = (output, context) => {
     }
     return contents;
 };
+const deserializeAws_queryRollbackDetails = (output, context) => {
+    const contents = {
+        RollbackReason: undefined,
+        RollbackStartTime: undefined,
+        PercentageCompleteOnRollback: undefined,
+        InstancesToUpdateOnRollback: undefined,
+        ProgressDetailsOnRollback: undefined,
+    };
+    if (output["RollbackReason"] !== undefined) {
+        contents.RollbackReason = __expectString(output["RollbackReason"]);
+    }
+    if (output["RollbackStartTime"] !== undefined) {
+        contents.RollbackStartTime = __expectNonNull(__parseRfc3339DateTimeWithOffset(output["RollbackStartTime"]));
+    }
+    if (output["PercentageCompleteOnRollback"] !== undefined) {
+        contents.PercentageCompleteOnRollback = __strictParseInt32(output["PercentageCompleteOnRollback"]);
+    }
+    if (output["InstancesToUpdateOnRollback"] !== undefined) {
+        contents.InstancesToUpdateOnRollback = __strictParseInt32(output["InstancesToUpdateOnRollback"]);
+    }
+    if (output["ProgressDetailsOnRollback"] !== undefined) {
+        contents.ProgressDetailsOnRollback = deserializeAws_queryInstanceRefreshProgressDetails(output["ProgressDetailsOnRollback"], context);
+    }
+    return contents;
+};
+const deserializeAws_queryRollbackInstanceRefreshAnswer = (output, context) => {
+    const contents = {
+        InstanceRefreshId: undefined,
+    };
+    if (output["InstanceRefreshId"] !== undefined) {
+        contents.InstanceRefreshId = __expectString(output["InstanceRefreshId"]);
+    }
+    return contents;
+};
 const deserializeAws_queryScalingActivityInProgressFault = (output, context) => {
     const contents = {
         message: undefined,

package/dist-types/AutoScaling.d.ts

@@ -57,6 +57,7 @@ import { PutScheduledUpdateGroupActionCommandInput, PutScheduledUpdateGroupActio
 import { PutWarmPoolCommandInput, PutWarmPoolCommandOutput } from "./commands/PutWarmPoolCommand";
 import { RecordLifecycleActionHeartbeatCommandInput, RecordLifecycleActionHeartbeatCommandOutput } from "./commands/RecordLifecycleActionHeartbeatCommand";
 import { ResumeProcessesCommandInput, ResumeProcessesCommandOutput } from "./commands/ResumeProcessesCommand";
+import { RollbackInstanceRefreshCommandInput, RollbackInstanceRefreshCommandOutput } from "./commands/RollbackInstanceRefreshCommand";
 import { SetDesiredCapacityCommandInput, SetDesiredCapacityCommandOutput } from "./commands/SetDesiredCapacityCommand";
 import { SetInstanceHealthCommandInput, SetInstanceHealthCommandOutput } from "./commands/SetInstanceHealthCommand";
 import { SetInstanceProtectionCommandInput, SetInstanceProtectionCommandOutput } from "./commands/SetInstanceProtectionCommand";
@@ -157,12 +158,14 @@ export declare class AutoScaling extends AutoScalingClient {
     batchPutScheduledUpdateGroupAction(args: BatchPutScheduledUpdateGroupActionCommandInput, cb: (err: any, data?: BatchPutScheduledUpdateGroupActionCommandOutput) => void): void;
     batchPutScheduledUpdateGroupAction(args: BatchPutScheduledUpdateGroupActionCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: BatchPutScheduledUpdateGroupActionCommandOutput) => void): void;
     /**
-     * <p>Cancels an instance refresh operation in progress. Cancellation does not roll back any
-     *             replacements that have already been completed, but it prevents new replacements from
-     *             being started. </p>
+     * <p>Cancels an instance refresh or rollback that is in progress. If an instance refresh or
+     *             rollback is not in progress, an <code>ActiveInstanceRefreshNotFound</code> error
+     *             occurs.</p>
      *          <p>This operation is part of the <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-refresh.html">instance refresh
      *                 feature</a> in Amazon EC2 Auto Scaling, which helps you update instances in your Auto Scaling group
      *             after you make configuration changes.</p>
+     *          <p>When you cancel an instance refresh, this does not roll back any changes that it made.
+     *             Use the <a>RollbackInstanceRefresh</a> API to roll back instead.</p>
      */
     cancelInstanceRefresh(args: CancelInstanceRefreshCommandInput, options?: __HttpHandlerOptions): Promise<CancelInstanceRefreshCommandOutput>;
     cancelInstanceRefresh(args: CancelInstanceRefreshCommandInput, cb: (err: any, data?: CancelInstanceRefreshCommandOutput) => void): void;
@@ -399,41 +402,12 @@ export declare class AutoScaling extends AutoScalingClient {
      *          <p>This operation is part of the <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-refresh.html">instance refresh
      *                 feature</a> in Amazon EC2 Auto Scaling, which helps you update instances in your Auto Scaling group
      *             after you make configuration changes.</p>
-     *          <p>To help you determine the status of an instance refresh, this operation returns
-     *             information about the instance refreshes you previously initiated, including their
-     *             status, end time, the percentage of the instance refresh that is complete, and the
-     *             number of instances remaining to update before the instance refresh is complete.</p>
-     *          <p>The following are the possible statuses: </p>
-     *          <ul>
-     *             <li>
-     *                <p>
-     *                   <code>Pending</code> - The request was created, but the operation has not
-     *                     started.</p>
-     *             </li>
-     *             <li>
-     *                <p>
-     *                   <code>InProgress</code> - The operation is in progress.</p>
-     *             </li>
-     *             <li>
-     *                <p>
-     *                   <code>Successful</code> - The operation completed successfully.</p>
-     *             </li>
-     *             <li>
-     *                <p>
-     *                   <code>Failed</code> - The operation failed to complete. You can troubleshoot
-     *                     using the status reason and the scaling activities. </p>
-     *             </li>
-     *             <li>
-     *                <p>
-     *                   <code>Cancelling</code> - An ongoing operation is being cancelled.
-     *                     Cancellation does not roll back any replacements that have already been
-     *                     completed, but it prevents new replacements from being started. </p>
-     *             </li>
-     *             <li>
-     *                <p>
-     *                   <code>Cancelled</code> - The operation is cancelled. </p>
-     *             </li>
-     *          </ul>
+     *          <p>To help you determine the status of an instance refresh, Amazon EC2 Auto Scaling returns information
+     *             about the instance refreshes you previously initiated, including their status, start
+     *             time, end time, the percentage of the instance refresh that is complete, and the number
+     *             of instances remaining to update before the instance refresh is complete. If a rollback
+     *             is initiated while an instance refresh is in progress, Amazon EC2 Auto Scaling also returns information
+     *             about the rollback of the instance refresh.</p>
      */
     describeInstanceRefreshes(args: DescribeInstanceRefreshesCommandInput, options?: __HttpHandlerOptions): Promise<DescribeInstanceRefreshesCommandOutput>;
     describeInstanceRefreshes(args: DescribeInstanceRefreshesCommandInput, cb: (err: any, data?: DescribeInstanceRefreshesCommandOutput) => void): void;
@@ -887,6 +861,34 @@ export declare class AutoScaling extends AutoScalingClient {
     resumeProcesses(args: ResumeProcessesCommandInput, options?: __HttpHandlerOptions): Promise<ResumeProcessesCommandOutput>;
     resumeProcesses(args: ResumeProcessesCommandInput, cb: (err: any, data?: ResumeProcessesCommandOutput) => void): void;
     resumeProcesses(args: ResumeProcessesCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ResumeProcessesCommandOutput) => void): void;
+    /**
+     * <p>Cancels an instance refresh that is in progress and rolls back any changes that it
+     *             made. Amazon EC2 Auto Scaling replaces any instances that were replaced during the instance refresh.
+     *             This restores your Auto Scaling group to the configuration that it was using before the start of
+     *             the instance refresh. </p>
+     *          <p>This operation is part of the <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-refresh.html">instance refresh
+     *                 feature</a> in Amazon EC2 Auto Scaling, which helps you update instances in your Auto Scaling group
+     *             after you make configuration changes.</p>
+     *          <p>A rollback is not supported in the following situations: </p>
+     *          <ul>
+     *             <li>
+     *                <p>There is no desired configuration specified for the instance refresh.</p>
+     *             </li>
+     *             <li>
+     *                <p>The Auto Scaling group has a launch template that uses an Amazon Web Services Systems Manager
+     *                     parameter instead of an AMI ID for the <code>ImageId</code> property.</p>
+     *             </li>
+     *             <li>
+     *                <p>The Auto Scaling group uses the launch template's <code>$Latest</code> or
+     *                         <code>$Default</code> version.</p>
+     *             </li>
+     *          </ul>
+     *          <p>When you receive a successful response from this operation, Amazon EC2 Auto Scaling immediately
+     *             begins replacing instances. You can check the status of this operation through the <a>DescribeInstanceRefreshes</a> API operation. </p>
+     */
+    rollbackInstanceRefresh(args: RollbackInstanceRefreshCommandInput, options?: __HttpHandlerOptions): Promise<RollbackInstanceRefreshCommandOutput>;
+    rollbackInstanceRefresh(args: RollbackInstanceRefreshCommandInput, cb: (err: any, data?: RollbackInstanceRefreshCommandOutput) => void): void;
+    rollbackInstanceRefresh(args: RollbackInstanceRefreshCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: RollbackInstanceRefreshCommandOutput) => void): void;
     /**
      * <p>Sets the size of the specified Auto Scaling group.</p>
      *          <p>If a scale-in activity occurs as a result of a new <code>DesiredCapacity</code> value
@@ -920,21 +922,30 @@ export declare class AutoScaling extends AutoScalingClient {
     setInstanceProtection(args: SetInstanceProtectionCommandInput, cb: (err: any, data?: SetInstanceProtectionCommandOutput) => void): void;
     setInstanceProtection(args: SetInstanceProtectionCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: SetInstanceProtectionCommandOutput) => void): void;
     /**
-     * <p>Starts a new instance refresh operation. An instance refresh performs a rolling
-     *             replacement of all or some instances in an Auto Scaling group. Each instance is terminated first
-     *             and then replaced, which temporarily reduces the capacity available within your Auto Scaling
-     *             group.</p>
+     * <p>Starts an instance refresh. During an instance refresh, Amazon EC2 Auto Scaling performs a rolling
+     *             update of instances in an Auto Scaling group. Instances are terminated first and then replaced,
+     *             which temporarily reduces the capacity available within your Auto Scaling group.</p>
      *          <p>This operation is part of the <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-refresh.html">instance refresh
      *                 feature</a> in Amazon EC2 Auto Scaling, which helps you update instances in your Auto Scaling group.
      *             This feature is helpful, for example, when you have a new AMI or a new user data script.
      *             You just need to create a new launch template that specifies the new AMI or user data
      *             script. Then start an instance refresh to immediately begin the process of updating
      *             instances in the group. </p>
-     *          <p>If the call succeeds, it creates a new instance refresh request with a unique ID that
-     *             you can use to track its progress. To query its status, call the <a>DescribeInstanceRefreshes</a> API. To describe the instance refreshes that
+     *          <p>If successful, the request's response contains a unique ID that you can use to track
+     *             the progress of the instance refresh. To query its status, call the <a>DescribeInstanceRefreshes</a> API. To describe the instance refreshes that
      *             have already run, call the <a>DescribeInstanceRefreshes</a> API. To cancel an
-     *             instance refresh operation in progress, use the <a>CancelInstanceRefresh</a>
+     *             instance refresh that is in progress, use the <a>CancelInstanceRefresh</a>
      *             API. </p>
+     *          <p>An instance refresh might fail for several reasons, such as EC2 launch failures,
+     *             misconfigured health checks, or not ignoring or allowing the termination of instances
+     *             that are in <code>Standby</code> state or protected from scale in. You can monitor for
+     *             failed EC2 launches using the scaling activities. To find the scaling activities, call
+     *             the <a>DescribeScalingActivities</a> API.</p>
+     *          <p>If you enable auto rollback, your Auto Scaling group will be rolled back automatically when
+     *             the instance refresh fails. You can enable this feature before starting an instance
+     *             refresh by specifying the <code>AutoRollback</code> property in the instance refresh
+     *             preferences. Otherwise, to roll back an instance refresh before it finishes, use the
+     *                 <a>RollbackInstanceRefresh</a> API. </p>
      */
     startInstanceRefresh(args: StartInstanceRefreshCommandInput, options?: __HttpHandlerOptions): Promise<StartInstanceRefreshCommandOutput>;
     startInstanceRefresh(args: StartInstanceRefreshCommandInput, cb: (err: any, data?: StartInstanceRefreshCommandOutput) => void): void;

package/dist-types/AutoScalingClient.d.ts

@@ -64,6 +64,7 @@ import { PutScheduledUpdateGroupActionCommandInput, PutScheduledUpdateGroupActio
 import { PutWarmPoolCommandInput, PutWarmPoolCommandOutput } from "./commands/PutWarmPoolCommand";
 import { RecordLifecycleActionHeartbeatCommandInput, RecordLifecycleActionHeartbeatCommandOutput } from "./commands/RecordLifecycleActionHeartbeatCommand";
 import { ResumeProcessesCommandInput, ResumeProcessesCommandOutput } from "./commands/ResumeProcessesCommand";
+import { RollbackInstanceRefreshCommandInput, RollbackInstanceRefreshCommandOutput } from "./commands/RollbackInstanceRefreshCommand";
 import { SetDesiredCapacityCommandInput, SetDesiredCapacityCommandOutput } from "./commands/SetDesiredCapacityCommand";
 import { SetInstanceHealthCommandInput, SetInstanceHealthCommandOutput } from "./commands/SetInstanceHealthCommand";
 import { SetInstanceProtectionCommandInput, SetInstanceProtectionCommandOutput } from "./commands/SetInstanceProtectionCommand";
@@ -72,8 +73,8 @@ import { SuspendProcessesCommandInput, SuspendProcessesCommandOutput } from "./c
 import { TerminateInstanceInAutoScalingGroupCommandInput, TerminateInstanceInAutoScalingGroupCommandOutput } from "./commands/TerminateInstanceInAutoScalingGroupCommand";
 import { UpdateAutoScalingGroupCommandInput, UpdateAutoScalingGroupCommandOutput } from "./commands/UpdateAutoScalingGroupCommand";
 import { ClientInputEndpointParameters, ClientResolvedEndpointParameters, EndpointParameters } from "./endpoint/EndpointParameters";
-export declare type ServiceInputTypes = AttachInstancesCommandInput | AttachLoadBalancerTargetGroupsCommandInput | AttachLoadBalancersCommandInput | AttachTrafficSourcesCommandInput | BatchDeleteScheduledActionCommandInput | BatchPutScheduledUpdateGroupActionCommandInput | CancelInstanceRefreshCommandInput | CompleteLifecycleActionCommandInput | CreateAutoScalingGroupCommandInput | CreateLaunchConfigurationCommandInput | CreateOrUpdateTagsCommandInput | DeleteAutoScalingGroupCommandInput | DeleteLaunchConfigurationCommandInput | DeleteLifecycleHookCommandInput | DeleteNotificationConfigurationCommandInput | DeletePolicyCommandInput | DeleteScheduledActionCommandInput | DeleteTagsCommandInput | DeleteWarmPoolCommandInput | DescribeAccountLimitsCommandInput | DescribeAdjustmentTypesCommandInput | DescribeAutoScalingGroupsCommandInput | DescribeAutoScalingInstancesCommandInput | DescribeAutoScalingNotificationTypesCommandInput | DescribeInstanceRefreshesCommandInput | DescribeLaunchConfigurationsCommandInput | DescribeLifecycleHookTypesCommandInput | DescribeLifecycleHooksCommandInput | DescribeLoadBalancerTargetGroupsCommandInput | DescribeLoadBalancersCommandInput | DescribeMetricCollectionTypesCommandInput | DescribeNotificationConfigurationsCommandInput | DescribePoliciesCommandInput | DescribeScalingActivitiesCommandInput | DescribeScalingProcessTypesCommandInput | DescribeScheduledActionsCommandInput | DescribeTagsCommandInput | DescribeTerminationPolicyTypesCommandInput | DescribeTrafficSourcesCommandInput | DescribeWarmPoolCommandInput | DetachInstancesCommandInput | DetachLoadBalancerTargetGroupsCommandInput | DetachLoadBalancersCommandInput | DetachTrafficSourcesCommandInput | DisableMetricsCollectionCommandInput | EnableMetricsCollectionCommandInput | EnterStandbyCommandInput | ExecutePolicyCommandInput | ExitStandbyCommandInput | GetPredictiveScalingForecastCommandInput | PutLifecycleHookCommandInput | PutNotificationConfigurationCommandInput | PutScalingPolicyCommandInput | PutScheduledUpdateGroupActionCommandInput | PutWarmPoolCommandInput | RecordLifecycleActionHeartbeatCommandInput | ResumeProcessesCommandInput | SetDesiredCapacityCommandInput | SetInstanceHealthCommandInput | SetInstanceProtectionCommandInput | StartInstanceRefreshCommandInput | SuspendProcessesCommandInput | TerminateInstanceInAutoScalingGroupCommandInput | UpdateAutoScalingGroupCommandInput;
-export declare type ServiceOutputTypes = AttachInstancesCommandOutput | AttachLoadBalancerTargetGroupsCommandOutput | AttachLoadBalancersCommandOutput | AttachTrafficSourcesCommandOutput | BatchDeleteScheduledActionCommandOutput | BatchPutScheduledUpdateGroupActionCommandOutput | CancelInstanceRefreshCommandOutput | CompleteLifecycleActionCommandOutput | CreateAutoScalingGroupCommandOutput | CreateLaunchConfigurationCommandOutput | CreateOrUpdateTagsCommandOutput | DeleteAutoScalingGroupCommandOutput | DeleteLaunchConfigurationCommandOutput | DeleteLifecycleHookCommandOutput | DeleteNotificationConfigurationCommandOutput | DeletePolicyCommandOutput | DeleteScheduledActionCommandOutput | DeleteTagsCommandOutput | DeleteWarmPoolCommandOutput | DescribeAccountLimitsCommandOutput | DescribeAdjustmentTypesCommandOutput | DescribeAutoScalingGroupsCommandOutput | DescribeAutoScalingInstancesCommandOutput | DescribeAutoScalingNotificationTypesCommandOutput | DescribeInstanceRefreshesCommandOutput | DescribeLaunchConfigurationsCommandOutput | DescribeLifecycleHookTypesCommandOutput | DescribeLifecycleHooksCommandOutput | DescribeLoadBalancerTargetGroupsCommandOutput | DescribeLoadBalancersCommandOutput | DescribeMetricCollectionTypesCommandOutput | DescribeNotificationConfigurationsCommandOutput | DescribePoliciesCommandOutput | DescribeScalingActivitiesCommandOutput | DescribeScalingProcessTypesCommandOutput | DescribeScheduledActionsCommandOutput | DescribeTagsCommandOutput | DescribeTerminationPolicyTypesCommandOutput | DescribeTrafficSourcesCommandOutput | DescribeWarmPoolCommandOutput | DetachInstancesCommandOutput | DetachLoadBalancerTargetGroupsCommandOutput | DetachLoadBalancersCommandOutput | DetachTrafficSourcesCommandOutput | DisableMetricsCollectionCommandOutput | EnableMetricsCollectionCommandOutput | EnterStandbyCommandOutput | ExecutePolicyCommandOutput | ExitStandbyCommandOutput | GetPredictiveScalingForecastCommandOutput | PutLifecycleHookCommandOutput | PutNotificationConfigurationCommandOutput | PutScalingPolicyCommandOutput | PutScheduledUpdateGroupActionCommandOutput | PutWarmPoolCommandOutput | RecordLifecycleActionHeartbeatCommandOutput | ResumeProcessesCommandOutput | SetDesiredCapacityCommandOutput | SetInstanceHealthCommandOutput | SetInstanceProtectionCommandOutput | StartInstanceRefreshCommandOutput | SuspendProcessesCommandOutput | TerminateInstanceInAutoScalingGroupCommandOutput | UpdateAutoScalingGroupCommandOutput;
+export declare type ServiceInputTypes = AttachInstancesCommandInput | AttachLoadBalancerTargetGroupsCommandInput | AttachLoadBalancersCommandInput | AttachTrafficSourcesCommandInput | BatchDeleteScheduledActionCommandInput | BatchPutScheduledUpdateGroupActionCommandInput | CancelInstanceRefreshCommandInput | CompleteLifecycleActionCommandInput | CreateAutoScalingGroupCommandInput | CreateLaunchConfigurationCommandInput | CreateOrUpdateTagsCommandInput | DeleteAutoScalingGroupCommandInput | DeleteLaunchConfigurationCommandInput | DeleteLifecycleHookCommandInput | DeleteNotificationConfigurationCommandInput | DeletePolicyCommandInput | DeleteScheduledActionCommandInput | DeleteTagsCommandInput | DeleteWarmPoolCommandInput | DescribeAccountLimitsCommandInput | DescribeAdjustmentTypesCommandInput | DescribeAutoScalingGroupsCommandInput | DescribeAutoScalingInstancesCommandInput | DescribeAutoScalingNotificationTypesCommandInput | DescribeInstanceRefreshesCommandInput | DescribeLaunchConfigurationsCommandInput | DescribeLifecycleHookTypesCommandInput | DescribeLifecycleHooksCommandInput | DescribeLoadBalancerTargetGroupsCommandInput | DescribeLoadBalancersCommandInput | DescribeMetricCollectionTypesCommandInput | DescribeNotificationConfigurationsCommandInput | DescribePoliciesCommandInput | DescribeScalingActivitiesCommandInput | DescribeScalingProcessTypesCommandInput | DescribeScheduledActionsCommandInput | DescribeTagsCommandInput | DescribeTerminationPolicyTypesCommandInput | DescribeTrafficSourcesCommandInput | DescribeWarmPoolCommandInput | DetachInstancesCommandInput | DetachLoadBalancerTargetGroupsCommandInput | DetachLoadBalancersCommandInput | DetachTrafficSourcesCommandInput | DisableMetricsCollectionCommandInput | EnableMetricsCollectionCommandInput | EnterStandbyCommandInput | ExecutePolicyCommandInput | ExitStandbyCommandInput | GetPredictiveScalingForecastCommandInput | PutLifecycleHookCommandInput | PutNotificationConfigurationCommandInput | PutScalingPolicyCommandInput | PutScheduledUpdateGroupActionCommandInput | PutWarmPoolCommandInput | RecordLifecycleActionHeartbeatCommandInput | ResumeProcessesCommandInput | RollbackInstanceRefreshCommandInput | SetDesiredCapacityCommandInput | SetInstanceHealthCommandInput | SetInstanceProtectionCommandInput | StartInstanceRefreshCommandInput | SuspendProcessesCommandInput | TerminateInstanceInAutoScalingGroupCommandInput | UpdateAutoScalingGroupCommandInput;
+export declare type ServiceOutputTypes = AttachInstancesCommandOutput | AttachLoadBalancerTargetGroupsCommandOutput | AttachLoadBalancersCommandOutput | AttachTrafficSourcesCommandOutput | BatchDeleteScheduledActionCommandOutput | BatchPutScheduledUpdateGroupActionCommandOutput | CancelInstanceRefreshCommandOutput | CompleteLifecycleActionCommandOutput | CreateAutoScalingGroupCommandOutput | CreateLaunchConfigurationCommandOutput | CreateOrUpdateTagsCommandOutput | DeleteAutoScalingGroupCommandOutput | DeleteLaunchConfigurationCommandOutput | DeleteLifecycleHookCommandOutput | DeleteNotificationConfigurationCommandOutput | DeletePolicyCommandOutput | DeleteScheduledActionCommandOutput | DeleteTagsCommandOutput | DeleteWarmPoolCommandOutput | DescribeAccountLimitsCommandOutput | DescribeAdjustmentTypesCommandOutput | DescribeAutoScalingGroupsCommandOutput | DescribeAutoScalingInstancesCommandOutput | DescribeAutoScalingNotificationTypesCommandOutput | DescribeInstanceRefreshesCommandOutput | DescribeLaunchConfigurationsCommandOutput | DescribeLifecycleHookTypesCommandOutput | DescribeLifecycleHooksCommandOutput | DescribeLoadBalancerTargetGroupsCommandOutput | DescribeLoadBalancersCommandOutput | DescribeMetricCollectionTypesCommandOutput | DescribeNotificationConfigurationsCommandOutput | DescribePoliciesCommandOutput | DescribeScalingActivitiesCommandOutput | DescribeScalingProcessTypesCommandOutput | DescribeScheduledActionsCommandOutput | DescribeTagsCommandOutput | DescribeTerminationPolicyTypesCommandOutput | DescribeTrafficSourcesCommandOutput | DescribeWarmPoolCommandOutput | DetachInstancesCommandOutput | DetachLoadBalancerTargetGroupsCommandOutput | DetachLoadBalancersCommandOutput | DetachTrafficSourcesCommandOutput | DisableMetricsCollectionCommandOutput | EnableMetricsCollectionCommandOutput | EnterStandbyCommandOutput | ExecutePolicyCommandOutput | ExitStandbyCommandOutput | GetPredictiveScalingForecastCommandOutput | PutLifecycleHookCommandOutput | PutNotificationConfigurationCommandOutput | PutScalingPolicyCommandOutput | PutScheduledUpdateGroupActionCommandOutput | PutWarmPoolCommandOutput | RecordLifecycleActionHeartbeatCommandOutput | ResumeProcessesCommandOutput | RollbackInstanceRefreshCommandOutput | SetDesiredCapacityCommandOutput | SetInstanceHealthCommandOutput | SetInstanceProtectionCommandOutput | StartInstanceRefreshCommandOutput | SuspendProcessesCommandOutput | TerminateInstanceInAutoScalingGroupCommandOutput | UpdateAutoScalingGroupCommandOutput;
 export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__HttpHandlerOptions>> {
     /**
      * The HTTP handler to use. Fetch in browser and Https in Nodejs.
@@ -131,17 +132,10 @@ export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__
      */
     disableHostPrefix?: boolean;
     /**
-     * Value for how many times a request will be made at most in case of retry.
-     */
-    maxAttempts?: number | __Provider<number>;
-    /**
-     * Specifies which retry algorithm to use.
-     */
-    retryMode?: string | __Provider<string>;
-    /**
-     * Optional logger for logging debug/info/warn/error.
+     * Unique service identifier.
+     * @internal
      */
-    logger?: __Logger;
+    serviceId?: string;
     /**
      * Enables IPv6/IPv4 dualstack endpoint.
      */
@@ -150,11 +144,6 @@ export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__
      * Enables FIPS compatible endpoints.
      */
     useFipsEndpoint?: boolean | __Provider<boolean>;
-    /**
-     * Unique service identifier.
-     * @internal
-     */
-    serviceId?: string;
     /**
      * The AWS region to which this client will send requests
      */
@@ -169,6 +158,18 @@ export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__
      * @internal
      */
     defaultUserAgentProvider?: Provider<__UserAgent>;
+    /**
+     * Value for how many times a request will be made at most in case of retry.
+     */
+    maxAttempts?: number | __Provider<number>;
+    /**
+     * Specifies which retry algorithm to use.
+     */
+    retryMode?: string | __Provider<string>;
+    /**
+     * Optional logger for logging debug/info/warn/error.
+     */
+    logger?: __Logger;
     /**
      * The {@link __DefaultsMode} that will be used to determine how certain default configuration options are resolved in the SDK.
      */

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

@@ -8,12 +8,14 @@ export interface CancelInstanceRefreshCommandInput extends CancelInstanceRefresh
 export interface CancelInstanceRefreshCommandOutput extends CancelInstanceRefreshAnswer, __MetadataBearer {
 }
 /**
- * <p>Cancels an instance refresh operation in progress. Cancellation does not roll back any
- *             replacements that have already been completed, but it prevents new replacements from
- *             being started. </p>
+ * <p>Cancels an instance refresh or rollback that is in progress. If an instance refresh or
+ *             rollback is not in progress, an <code>ActiveInstanceRefreshNotFound</code> error
+ *             occurs.</p>
  *          <p>This operation is part of the <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-refresh.html">instance refresh
  *                 feature</a> in Amazon EC2 Auto Scaling, which helps you update instances in your Auto Scaling group
  *             after you make configuration changes.</p>
+ *          <p>When you cancel an instance refresh, this does not roll back any changes that it made.
+ *             Use the <a>RollbackInstanceRefresh</a> API to roll back instead.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -12,41 +12,12 @@ export interface DescribeInstanceRefreshesCommandOutput extends DescribeInstance
  *          <p>This operation is part of the <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-refresh.html">instance refresh
  *                 feature</a> in Amazon EC2 Auto Scaling, which helps you update instances in your Auto Scaling group
  *             after you make configuration changes.</p>
- *          <p>To help you determine the status of an instance refresh, this operation returns
- *             information about the instance refreshes you previously initiated, including their
- *             status, end time, the percentage of the instance refresh that is complete, and the
- *             number of instances remaining to update before the instance refresh is complete.</p>
- *          <p>The following are the possible statuses: </p>
- *          <ul>
- *             <li>
- *                <p>
- *                   <code>Pending</code> - The request was created, but the operation has not
- *                     started.</p>
- *             </li>
- *             <li>
- *                <p>
- *                   <code>InProgress</code> - The operation is in progress.</p>
- *             </li>
- *             <li>
- *                <p>
- *                   <code>Successful</code> - The operation completed successfully.</p>
- *             </li>
- *             <li>
- *                <p>
- *                   <code>Failed</code> - The operation failed to complete. You can troubleshoot
- *                     using the status reason and the scaling activities. </p>
- *             </li>
- *             <li>
- *                <p>
- *                   <code>Cancelling</code> - An ongoing operation is being cancelled.
- *                     Cancellation does not roll back any replacements that have already been
- *                     completed, but it prevents new replacements from being started. </p>
- *             </li>
- *             <li>
- *                <p>
- *                   <code>Cancelled</code> - The operation is cancelled. </p>
- *             </li>
- *          </ul>
+ *          <p>To help you determine the status of an instance refresh, Amazon EC2 Auto Scaling returns information
+ *             about the instance refreshes you previously initiated, including their status, start
+ *             time, end time, the percentage of the instance refresh that is complete, and the number
+ *             of instances remaining to update before the instance refresh is complete. If a rollback
+ *             is initiated while an instance refresh is in progress, Amazon EC2 Auto Scaling also returns information
+ *             about the rollback of the instance refresh.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript