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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. package/dist-cjs/AutoScaling.js +15 -0
  2. package/dist-cjs/commands/RollbackInstanceRefreshCommand.js +46 -0
  3. package/dist-cjs/commands/index.js +1 -0
  4. package/dist-cjs/endpoint/ruleset.js +3 -3
  5. package/dist-cjs/models/models_0.js +45 -5
  6. package/dist-cjs/protocols/Aws_query.js +142 -2
  7. package/dist-es/AutoScaling.js +15 -0
  8. package/dist-es/commands/RollbackInstanceRefreshCommand.js +42 -0
  9. package/dist-es/commands/index.js +1 -0
  10. package/dist-es/endpoint/ruleset.js +3 -3
  11. package/dist-es/models/models_0.js +36 -0
  12. package/dist-es/protocols/Aws_query.js +139 -1
  13. package/dist-types/AutoScaling.d.ts +56 -45
  14. package/dist-types/AutoScalingClient.d.ts +18 -17
  15. package/dist-types/commands/CancelInstanceRefreshCommand.d.ts +5 -3
  16. package/dist-types/commands/DescribeInstanceRefreshesCommand.d.ts +6 -35
  17. package/dist-types/commands/RollbackInstanceRefreshCommand.d.ts +59 -0
  18. package/dist-types/commands/StartInstanceRefreshCommand.d.ts +16 -7
  19. package/dist-types/commands/index.d.ts +1 -0
  20. package/dist-types/endpoint/EndpointParameters.d.ts +1 -1
  21. package/dist-types/models/models_0.d.ts +280 -89
  22. package/dist-types/protocols/Aws_query.d.ts +3 -0
  23. package/dist-types/runtimeConfig.browser.d.ts +1 -1
  24. package/dist-types/runtimeConfig.d.ts +1 -1
  25. package/dist-types/runtimeConfig.native.d.ts +4 -4
  26. package/dist-types/ts3.4/AutoScaling.d.ts +17 -0
  27. package/dist-types/ts3.4/AutoScalingClient.d.ts +10 -4
  28. package/dist-types/ts3.4/commands/RollbackInstanceRefreshCommand.d.ts +41 -0
  29. package/dist-types/ts3.4/commands/index.d.ts +1 -0
  30. package/dist-types/ts3.4/endpoint/EndpointParameters.d.ts +1 -1
  31. package/dist-types/ts3.4/models/models_0.d.ts +49 -0
  32. package/dist-types/ts3.4/protocols/Aws_query.d.ts +12 -0
  33. package/dist-types/ts3.4/runtimeConfig.browser.d.ts +1 -1
  34. package/dist-types/ts3.4/runtimeConfig.d.ts +1 -1
  35. package/dist-types/ts3.4/runtimeConfig.native.d.ts +4 -4
  36. package/package.json +30 -30
@@ -49,8 +49,8 @@ export declare enum AcceleratorType {
49
49
  INFERENCE = "inference"
50
50
  }
51
51
  /**
52
- * <p>The request failed because an active instance refresh for the specified Auto Scaling group was
53
- * not found. </p>
52
+ * <p>The request failed because an active instance refresh or rollback for the specified
53
+ * Auto Scaling group was not found.</p>
54
54
  */
55
55
  export declare class ActiveInstanceRefreshNotFoundFault extends __BaseException {
56
56
  readonly name: "ActiveInstanceRefreshNotFoundFault";
@@ -392,7 +392,8 @@ export declare class LimitExceededFault extends __BaseException {
392
392
  }
393
393
  export interface CancelInstanceRefreshAnswer {
394
394
  /**
395
- * <p>The instance refresh ID.</p>
395
+ * <p>The instance refresh ID associated with the request. This is the unique ID assigned to
396
+ * the instance refresh when it was started.</p>
396
397
  */
397
398
  InstanceRefreshId?: string;
398
399
  }
@@ -1421,22 +1422,23 @@ export interface CreateAutoScalingGroupType {
1421
1422
  */
1422
1423
  DesiredCapacityType?: string;
1423
1424
  /**
1424
- * <p>The amount of time, in seconds, until a newly launched instance can contribute to the
1425
- * Amazon CloudWatch metrics. This delay lets an instance finish initializing before Amazon EC2 Auto Scaling
1426
- * aggregates instance metrics, resulting in more reliable usage data. Set this value equal
1427
- * to the amount of time that it takes for resource consumption to become stable after an
1428
- * instance reaches the <code>InService</code> state. For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-default-instance-warmup.html">Set
1425
+ * <p>The amount of time, in seconds, until a new instance is considered to have finished
1426
+ * initializing and resource consumption to become stable after it enters the
1427
+ * <code>InService</code> state. </p>
1428
+ * <p>During an instance refresh, Amazon EC2 Auto Scaling waits for the warm-up period after it replaces an
1429
+ * instance before it moves on to replacing the next instance. Amazon EC2 Auto Scaling also waits for the
1430
+ * warm-up period before aggregating the metrics for new instances with existing instances
1431
+ * in the Amazon CloudWatch metrics that are used for scaling, resulting in more reliable usage
1432
+ * data. For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-default-instance-warmup.html">Set
1429
1433
  * the default instance warmup for an Auto Scaling group</a> in the
1430
1434
  * <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
1431
1435
  * <important>
1432
- * <p>To manage your warm-up settings at the group level, we recommend that you set the
1433
- * default instance warmup, <i>even if its value is set to 0 seconds</i>.
1434
- * This also optimizes the performance of scaling policies that scale continuously,
1435
- * such as target tracking and step scaling policies. </p>
1436
- * <p>If you need to remove a value that you previously set, include the property but
1437
- * specify <code>-1</code> for the value. However, we strongly recommend keeping the
1438
- * default instance warmup enabled by specifying a minimum value of
1439
- * <code>0</code>.</p>
1436
+ * <p>To manage various warm-up settings at the group level, we recommend that you set
1437
+ * the default instance warmup, <i>even if it is set to 0 seconds</i>. To
1438
+ * remove a value that you previously set, include the property but specify
1439
+ * <code>-1</code> for the value. However, we strongly recommend keeping the
1440
+ * default instance warmup enabled by specifying a value of <code>0</code> or other
1441
+ * nominal value.</p>
1440
1442
  * </important>
1441
1443
  * <p>Default: None </p>
1442
1444
  */
@@ -2466,7 +2468,11 @@ export interface AutoScalingGroup {
2466
2468
  */
2467
2469
  DefaultInstanceWarmup?: number;
2468
2470
  /**
2469
- * <p>The unique identifiers of the traffic sources.</p>
2471
+ * <p>
2472
+ * <b>Reserved for use with Amazon VPC Lattice, which is in preview release and is subject to
2473
+ * change. Do not use this parameter for production workloads. It is also subject to change.</b>
2474
+ * </p>
2475
+ * <p>The unique identifiers of the traffic sources.</p>
2470
2476
  */
2471
2477
  TrafficSources?: TrafficSourceIdentifier[];
2472
2478
  }
@@ -2617,6 +2623,16 @@ export interface DesiredConfiguration {
2617
2623
  */
2618
2624
  MixedInstancesPolicy?: MixedInstancesPolicy;
2619
2625
  }
2626
+ export declare enum ScaleInProtectedInstances {
2627
+ Ignore = "Ignore",
2628
+ Refresh = "Refresh",
2629
+ Wait = "Wait"
2630
+ }
2631
+ export declare enum StandbyInstances {
2632
+ Ignore = "Ignore",
2633
+ Terminate = "Terminate",
2634
+ Wait = "Wait"
2635
+ }
2620
2636
  /**
2621
2637
  * <p>Describes the preferences for an instance refresh.</p>
2622
2638
  */
@@ -2632,47 +2648,113 @@ export interface RefreshPreferences {
2632
2648
  */
2633
2649
  MinHealthyPercentage?: number;
2634
2650
  /**
2635
- * <p>
2636
- * <i>Not needed if the default instance warmup is defined for the
2637
- * group.</i>
2638
- * </p>
2639
- * <p>The duration of the instance warmup, in seconds.</p>
2640
- * <note>
2641
- * <p>The default is to use the value for the default instance warmup defined for the
2642
- * group. If default instance warmup is null, then <code>InstanceWarmup</code> falls
2643
- * back to the value of the health check grace period.</p>
2644
- * </note>
2651
+ * <p>A time period, in seconds, during which an instance refresh waits before moving on to
2652
+ * replacing the next instance after a new instance enters the <code>InService</code>
2653
+ * state.</p>
2654
+ * <p>This property is not required for normal usage. Instead, use the
2655
+ * <code>DefaultInstanceWarmup</code> property of the Auto Scaling group. The
2656
+ * <code>InstanceWarmup</code> and <code>DefaultInstanceWarmup</code> properties work
2657
+ * the same way. Only specify this property if you must override the
2658
+ * <code>DefaultInstanceWarmup</code> property. </p>
2659
+ * <p> If you do not specify this property, the instance warmup by default is the value of
2660
+ * the <code>DefaultInstanceWarmup</code> property, if defined (which is recommended in all
2661
+ * cases), or the <code>HealthCheckGracePeriod</code> property otherwise.</p>
2645
2662
  */
2646
2663
  InstanceWarmup?: number;
2647
2664
  /**
2648
- * <p>Threshold values for each checkpoint in ascending order. Each number must be unique.
2649
- * To replace all instances in the Auto Scaling group, the last number in the array must be
2650
- * <code>100</code>.</p>
2665
+ * <p>(Optional) Threshold values for each checkpoint in ascending order. Each number must
2666
+ * be unique. To replace all instances in the Auto Scaling group, the last number in the array must
2667
+ * be <code>100</code>.</p>
2651
2668
  * <p>For usage examples, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-adding-checkpoints-instance-refresh.html">Adding
2652
2669
  * checkpoints to an instance refresh</a> in the
2653
2670
  * <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
2654
2671
  */
2655
2672
  CheckpointPercentages?: number[];
2656
2673
  /**
2657
- * <p>The amount of time, in seconds, to wait after a checkpoint before continuing. This
2658
- * property is optional, but if you specify a value for it, you must also specify a value
2659
- * for <code>CheckpointPercentages</code>. If you specify a value for
2674
+ * <p>(Optional) The amount of time, in seconds, to wait after a checkpoint before
2675
+ * continuing. This property is optional, but if you specify a value for it, you must also
2676
+ * specify a value for <code>CheckpointPercentages</code>. If you specify a value for
2660
2677
  * <code>CheckpointPercentages</code> and not for <code>CheckpointDelay</code>, the
2661
2678
  * <code>CheckpointDelay</code> defaults to <code>3600</code> (1 hour). </p>
2662
2679
  */
2663
2680
  CheckpointDelay?: number;
2664
2681
  /**
2665
- * <p>A boolean value that indicates whether skip matching is enabled. If true, then
2666
- * Amazon EC2 Auto Scaling skips replacing instances that match the desired configuration. If no desired
2667
- * configuration is specified, then it skips replacing instances that have the same
2668
- * configuration that is already set on the group. The default is
2669
- * <code>false</code>.</p>
2682
+ * <p>(Optional) Indicates whether skip matching is enabled. If enabled (<code>true</code>),
2683
+ * then Amazon EC2 Auto Scaling skips replacing instances that match the desired configuration. If no
2684
+ * desired configuration is specified, then it skips replacing instances that have the same
2685
+ * launch template and instance types that the Auto Scaling group was using before the start of the
2686
+ * instance refresh. The default is <code>false</code>.</p>
2687
+ * <p>For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-refresh-skip-matching.html">Use an
2688
+ * instance refresh with skip matching</a> in the
2689
+ * <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
2670
2690
  */
2671
2691
  SkipMatching?: boolean;
2692
+ /**
2693
+ * <p>(Optional) Indicates whether to roll back the Auto Scaling group to its previous configuration
2694
+ * if the instance refresh fails. The default is <code>false</code>.</p>
2695
+ * <p>A rollback is not supported in the following situations: </p>
2696
+ * <ul>
2697
+ * <li>
2698
+ * <p>There is no desired configuration specified for the instance refresh.</p>
2699
+ * </li>
2700
+ * <li>
2701
+ * <p>The Auto Scaling group has a launch template that uses an Amazon Web Services Systems Manager
2702
+ * parameter instead of an AMI ID for the <code>ImageId</code> property.</p>
2703
+ * </li>
2704
+ * <li>
2705
+ * <p>The Auto Scaling group uses the launch template's <code>$Latest</code> or
2706
+ * <code>$Default</code> version.</p>
2707
+ * </li>
2708
+ * </ul>
2709
+ */
2710
+ AutoRollback?: boolean;
2711
+ /**
2712
+ * <p>Choose the behavior that you want Amazon EC2 Auto Scaling to use if instances protected from scale in
2713
+ * are found. </p>
2714
+ * <p>The following lists the valid values:</p>
2715
+ * <dl>
2716
+ * <dt>Refresh</dt>
2717
+ * <dd>
2718
+ * <p>Amazon EC2 Auto Scaling replaces instances that are protected from scale in.</p>
2719
+ * </dd>
2720
+ * <dt>Ignore</dt>
2721
+ * <dd>
2722
+ * <p>Amazon EC2 Auto Scaling ignores instances that are protected from scale in and continues
2723
+ * to replace instances that are not protected.</p>
2724
+ * </dd>
2725
+ * <dt>Wait (default)</dt>
2726
+ * <dd>
2727
+ * <p>Amazon EC2 Auto Scaling waits one hour for you to remove scale-in protection. Otherwise,
2728
+ * the instance refresh will fail.</p>
2729
+ * </dd>
2730
+ * </dl>
2731
+ */
2732
+ ScaleInProtectedInstances?: ScaleInProtectedInstances | string;
2733
+ /**
2734
+ * <p>Choose the behavior that you want Amazon EC2 Auto Scaling to use if instances in <code>Standby</code>
2735
+ * state are found.</p>
2736
+ * <p>The following lists the valid values:</p>
2737
+ * <dl>
2738
+ * <dt>Terminate</dt>
2739
+ * <dd>
2740
+ * <p>Amazon EC2 Auto Scaling terminates instances that are in <code>Standby</code>.</p>
2741
+ * </dd>
2742
+ * <dt>Ignore</dt>
2743
+ * <dd>
2744
+ * <p>Amazon EC2 Auto Scaling ignores instances that are in <code>Standby</code> and continues
2745
+ * to replace instances that are in the <code>InService</code> state.</p>
2746
+ * </dd>
2747
+ * <dt>Wait (default)</dt>
2748
+ * <dd>
2749
+ * <p>Amazon EC2 Auto Scaling waits one hour for you to return the instances to service.
2750
+ * Otherwise, the instance refresh will fail.</p>
2751
+ * </dd>
2752
+ * </dl>
2753
+ */
2754
+ StandbyInstances?: StandbyInstances | string;
2672
2755
  }
2673
2756
  /**
2674
- * <p>Reports the progress of an instance refresh on instances that are in the Auto Scaling
2675
- * group.</p>
2757
+ * <p>Reports progress on replacing instances that are in the Auto Scaling group.</p>
2676
2758
  */
2677
2759
  export interface InstanceRefreshLivePoolProgress {
2678
2760
  /**
@@ -2689,8 +2771,7 @@ export interface InstanceRefreshLivePoolProgress {
2689
2771
  InstancesToUpdate?: number;
2690
2772
  }
2691
2773
  /**
2692
- * <p>Reports the progress of an instance refresh on instances that are in the warm
2693
- * pool.</p>
2774
+ * <p>Reports progress on replacing instances that are in the warm pool.</p>
2694
2775
  */
2695
2776
  export interface InstanceRefreshWarmPoolProgress {
2696
2777
  /**
@@ -2707,28 +2788,59 @@ export interface InstanceRefreshWarmPoolProgress {
2707
2788
  InstancesToUpdate?: number;
2708
2789
  }
2709
2790
  /**
2710
- * <p>Reports the progress of an instance refresh on an Auto Scaling group that has a warm pool.
2711
- * This includes separate details for instances in the warm pool and instances in the Auto Scaling
2712
- * group (the live pool).</p>
2791
+ * <p>Reports progress on replacing instances in an Auto Scaling group that has a warm pool. This
2792
+ * includes separate details for instances in the warm pool and instances in the Auto Scaling group
2793
+ * (the live pool).</p>
2713
2794
  */
2714
2795
  export interface InstanceRefreshProgressDetails {
2715
2796
  /**
2716
- * <p>Indicates the progress of an instance refresh on instances that are in the Auto Scaling
2717
- * group.</p>
2797
+ * <p>Reports progress on replacing instances that are in the Auto Scaling group.</p>
2718
2798
  */
2719
2799
  LivePoolProgress?: InstanceRefreshLivePoolProgress;
2720
2800
  /**
2721
- * <p>Indicates the progress of an instance refresh on instances that are in the warm
2722
- * pool.</p>
2801
+ * <p>Reports progress on replacing instances that are in the warm pool.</p>
2723
2802
  */
2724
2803
  WarmPoolProgress?: InstanceRefreshWarmPoolProgress;
2725
2804
  }
2805
+ /**
2806
+ * <p>Details about an instance refresh rollback.</p>
2807
+ */
2808
+ export interface RollbackDetails {
2809
+ /**
2810
+ * <p>The reason for this instance refresh rollback (for example, whether a manual or
2811
+ * automatic rollback was initiated).</p>
2812
+ */
2813
+ RollbackReason?: string;
2814
+ /**
2815
+ * <p>The date and time at which the rollback began.</p>
2816
+ */
2817
+ RollbackStartTime?: Date;
2818
+ /**
2819
+ * <p>Indicates the value of <code>PercentageComplete</code> at the time the rollback
2820
+ * started.</p>
2821
+ */
2822
+ PercentageCompleteOnRollback?: number;
2823
+ /**
2824
+ * <p>Indicates the value of <code>InstancesToUpdate</code> at the time the rollback
2825
+ * started.</p>
2826
+ */
2827
+ InstancesToUpdateOnRollback?: number;
2828
+ /**
2829
+ * <p>Reports progress on replacing instances in an Auto Scaling group that has a warm pool. This
2830
+ * includes separate details for instances in the warm pool and instances in the Auto Scaling group
2831
+ * (the live pool).</p>
2832
+ */
2833
+ ProgressDetailsOnRollback?: InstanceRefreshProgressDetails;
2834
+ }
2726
2835
  export declare enum InstanceRefreshStatus {
2727
2836
  Cancelled = "Cancelled",
2728
2837
  Cancelling = "Cancelling",
2729
2838
  Failed = "Failed",
2730
2839
  InProgress = "InProgress",
2731
2840
  Pending = "Pending",
2841
+ RollbackFailed = "RollbackFailed",
2842
+ RollbackInProgress = "RollbackInProgress",
2843
+ RollbackSuccessful = "RollbackSuccessful",
2732
2844
  Successful = "Successful"
2733
2845
  }
2734
2846
  /**
@@ -2748,37 +2860,50 @@ export interface InstanceRefresh {
2748
2860
  * <ul>
2749
2861
  * <li>
2750
2862
  * <p>
2751
- * <code>Pending</code> - The request was created, but the operation has not
2752
- * started.</p>
2863
+ * <code>Pending</code> - The request was created, but the instance refresh has
2864
+ * not started.</p>
2865
+ * </li>
2866
+ * <li>
2867
+ * <p>
2868
+ * <code>InProgress</code> - An instance refresh is in progress.</p>
2753
2869
  * </li>
2754
2870
  * <li>
2755
2871
  * <p>
2756
- * <code>InProgress</code> - The operation is in progress.</p>
2872
+ * <code>Successful</code> - An instance refresh completed successfully.</p>
2757
2873
  * </li>
2758
2874
  * <li>
2759
2875
  * <p>
2760
- * <code>Successful</code> - The operation completed successfully.</p>
2876
+ * <code>Failed</code> - An instance refresh failed to complete. You can
2877
+ * troubleshoot using the status reason and the scaling activities. </p>
2761
2878
  * </li>
2762
2879
  * <li>
2763
2880
  * <p>
2764
- * <code>Failed</code> - The operation failed to complete. You can troubleshoot
2765
- * using the status reason and the scaling activities. </p>
2881
+ * <code>Cancelling</code> - An ongoing instance refresh is being
2882
+ * cancelled.</p>
2766
2883
  * </li>
2767
2884
  * <li>
2768
2885
  * <p>
2769
- * <code>Cancelling</code> - An ongoing operation is being cancelled.
2770
- * Cancellation does not roll back any replacements that have already been
2771
- * completed, but it prevents new replacements from being started. </p>
2886
+ * <code>Cancelled</code> - The instance refresh is cancelled. </p>
2772
2887
  * </li>
2773
2888
  * <li>
2774
2889
  * <p>
2775
- * <code>Cancelled</code> - The operation is cancelled. </p>
2890
+ * <code>RollbackInProgress</code> - An instance refresh is being rolled
2891
+ * back.</p>
2892
+ * </li>
2893
+ * <li>
2894
+ * <p>
2895
+ * <code>RollbackFailed</code> - The rollback failed to complete. You can
2896
+ * troubleshoot using the status reason and the scaling activities.</p>
2897
+ * </li>
2898
+ * <li>
2899
+ * <p>
2900
+ * <code>RollbackSuccessful</code> - The rollback completed successfully.</p>
2776
2901
  * </li>
2777
2902
  * </ul>
2778
2903
  */
2779
2904
  Status?: InstanceRefreshStatus | string;
2780
2905
  /**
2781
- * <p>Provides more details about the current status of the instance refresh. </p>
2906
+ * <p>The explanation for the specific status assigned to this operation.</p>
2782
2907
  */
2783
2908
  StatusReason?: string;
2784
2909
  /**
@@ -2794,11 +2919,22 @@ export interface InstanceRefresh {
2794
2919
  * replacement, Amazon EC2 Auto Scaling tracks the instance's health status and warm-up time. When the
2795
2920
  * instance's health status changes to healthy and the specified warm-up time passes, the
2796
2921
  * instance is considered updated and is added to the percentage complete.</p>
2922
+ * <note>
2923
+ * <p>
2924
+ * <code>PercentageComplete</code> does not include instances that are replaced
2925
+ * during a rollback. This value gradually goes back down to zero during a
2926
+ * rollback.</p>
2927
+ * </note>
2797
2928
  */
2798
2929
  PercentageComplete?: number;
2799
2930
  /**
2800
2931
  * <p>The number of instances remaining to update before the instance refresh is
2801
2932
  * complete.</p>
2933
+ * <note>
2934
+ * <p>If you roll back the instance refresh, <code>InstancesToUpdate</code> shows you
2935
+ * the number of instances that were not yet updated by the instance refresh.
2936
+ * Therefore, these instances don't need to be replaced as part of the rollback.</p>
2937
+ * </note>
2802
2938
  */
2803
2939
  InstancesToUpdate?: number;
2804
2940
  /**
@@ -2810,13 +2946,18 @@ export interface InstanceRefresh {
2810
2946
  */
2811
2947
  Preferences?: RefreshPreferences;
2812
2948
  /**
2813
- * <p>Describes the specific update you want to deploy.</p>
2949
+ * <p>Describes the desired configuration for the instance refresh.</p>
2814
2950
  */
2815
2951
  DesiredConfiguration?: DesiredConfiguration;
2952
+ /**
2953
+ * <p>The rollback details.</p>
2954
+ */
2955
+ RollbackDetails?: RollbackDetails;
2816
2956
  }
2817
2957
  export interface DescribeInstanceRefreshesAnswer {
2818
2958
  /**
2819
- * <p>The instance refreshes for the specified group, sorted by creation timestamp in descending order.</p>
2959
+ * <p>The instance refreshes for the specified group, sorted by creation timestamp in
2960
+ * descending order.</p>
2820
2961
  */
2821
2962
  InstanceRefreshes?: InstanceRefresh[];
2822
2963
  /**
@@ -3951,7 +4092,7 @@ export interface StepAdjustment {
3951
4092
  * <p>This structure defines the CloudWatch metric to return, along with the statistic, period,
3952
4093
  * and unit.</p>
3953
4094
  * <p>For more information about the CloudWatch terminology below, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html">Amazon CloudWatch
3954
- * concepts</a> in the <i>Amazon CloudWatch User Guide</i>.</p>
4095
+ * concepts</a> in the <i>Amazon CloudWatch User Guide</i>.</p>
3955
4096
  */
3956
4097
  export interface TargetTrackingMetricStat {
3957
4098
  /**
@@ -4012,11 +4153,11 @@ export interface TargetTrackingMetricDataQuery {
4012
4153
  * <p>Indicates whether to return the timestamps and raw data values of this metric. </p>
4013
4154
  * <p>If you use any math expressions, specify <code>true</code> for this value for only the
4014
4155
  * final math expression that the metric specification is based on. You must specify
4015
- * <code>false</code> for <code>ReturnData</code> for all the other metrics and
4156
+ * <code>false</code> for <code>ReturnData</code> for all the other metrics and
4016
4157
  * expressions used in the metric specification.</p>
4017
4158
  * <p>If you are only retrieving metrics and not performing any math expressions, do not
4018
4159
  * specify anything for <code>ReturnData</code>. This sets it to its default
4019
- * (<code>true</code>).</p>
4160
+ * (<code>true</code>).</p>
4020
4161
  */
4021
4162
  ReturnData?: boolean;
4022
4163
  }
@@ -5536,6 +5677,33 @@ export interface ScalingProcessQuery {
5536
5677
  */
5537
5678
  ScalingProcesses?: string[];
5538
5679
  }
5680
+ /**
5681
+ * <p>The request failed because a desired configuration was not found or an incompatible
5682
+ * launch template (uses a Systems Manager parameter instead of an AMI ID) or launch
5683
+ * template version (<code>$Latest</code> or <code>$Default</code>) is present on the Auto Scaling
5684
+ * group.</p>
5685
+ */
5686
+ export declare class IrreversibleInstanceRefreshFault extends __BaseException {
5687
+ readonly name: "IrreversibleInstanceRefreshFault";
5688
+ readonly $fault: "client";
5689
+ /**
5690
+ * @internal
5691
+ */
5692
+ constructor(opts: __ExceptionOptionType<IrreversibleInstanceRefreshFault, __BaseException>);
5693
+ }
5694
+ export interface RollbackInstanceRefreshAnswer {
5695
+ /**
5696
+ * <p>The instance refresh ID associated with the request. This is the unique ID assigned to
5697
+ * the instance refresh when it was started.</p>
5698
+ */
5699
+ InstanceRefreshId?: string;
5700
+ }
5701
+ export interface RollbackInstanceRefreshType {
5702
+ /**
5703
+ * <p>The name of the Auto Scaling group.</p>
5704
+ */
5705
+ AutoScalingGroupName?: string;
5706
+ }
5539
5707
  export interface SetDesiredCapacityType {
5540
5708
  /**
5541
5709
  * <p>The name of the Auto Scaling group.</p>
@@ -5593,8 +5761,8 @@ export interface SetInstanceProtectionQuery {
5593
5761
  ProtectedFromScaleIn: boolean | undefined;
5594
5762
  }
5595
5763
  /**
5596
- * <p>The request failed because an active instance refresh operation already exists for the
5597
- * specified Auto Scaling group.</p>
5764
+ * <p>The request failed because an active instance refresh already exists for the specified
5765
+ * Auto Scaling group.</p>
5598
5766
  */
5599
5767
  export declare class InstanceRefreshInProgressFault extends __BaseException {
5600
5768
  readonly name: "InstanceRefreshInProgressFault";
@@ -5606,7 +5774,7 @@ export declare class InstanceRefreshInProgressFault extends __BaseException {
5606
5774
  }
5607
5775
  export interface StartInstanceRefreshAnswer {
5608
5776
  /**
5609
- * <p>A unique ID for tracking the progress of the request.</p>
5777
+ * <p>A unique ID for tracking the progress of the instance refresh.</p>
5610
5778
  */
5611
5779
  InstanceRefreshId?: string;
5612
5780
  }
@@ -5621,10 +5789,6 @@ export interface StartInstanceRefreshType {
5621
5789
  /**
5622
5790
  * <p>The strategy to use for the instance refresh. The only valid value is
5623
5791
  * <code>Rolling</code>.</p>
5624
- * <p>A rolling update helps you update your instances gradually. A rolling update can fail
5625
- * due to failed health checks or if instances are on standby or are protected from scale
5626
- * in. If the rolling update process fails, any instances that are replaced are not rolled
5627
- * back to their previous configuration. </p>
5628
5792
  */
5629
5793
  Strategy?: RefreshStrategy | string;
5630
5794
  /**
@@ -5637,14 +5801,28 @@ export interface StartInstanceRefreshType {
5637
5801
  * template for your desired configuration, consider enabling the
5638
5802
  * <code>SkipMatching</code> property in preferences. If it's enabled, Amazon EC2 Auto Scaling
5639
5803
  * skips replacing instances that already use the specified launch template and
5640
- * version. This can help you reduce the number of replacements that are required to
5641
- * apply updates. </p>
5804
+ * instance types. This can help you reduce the number of replacements that are
5805
+ * required to apply updates. </p>
5642
5806
  * </note>
5643
5807
  */
5644
5808
  DesiredConfiguration?: DesiredConfiguration;
5645
5809
  /**
5646
- * <p>Set of preferences associated with the instance refresh request. If not provided, the
5647
- * default values are used.</p>
5810
+ * <p>Sets your preferences for the instance refresh so that it performs as expected when
5811
+ * you start it. Includes the instance warmup time, the minimum healthy percentage, and the
5812
+ * behaviors that you want Amazon EC2 Auto Scaling to use if instances that are in <code>Standby</code>
5813
+ * state or protected from scale in are found. You can also choose to enable additional
5814
+ * features, such as the following:</p>
5815
+ * <ul>
5816
+ * <li>
5817
+ * <p>Auto rollback</p>
5818
+ * </li>
5819
+ * <li>
5820
+ * <p>Checkpoints</p>
5821
+ * </li>
5822
+ * <li>
5823
+ * <p>Skip matching</p>
5824
+ * </li>
5825
+ * </ul>
5648
5826
  */
5649
5827
  Preferences?: RefreshPreferences;
5650
5828
  }
@@ -5810,22 +5988,23 @@ export interface UpdateAutoScalingGroupType {
5810
5988
  */
5811
5989
  DesiredCapacityType?: string;
5812
5990
  /**
5813
- * <p>The amount of time, in seconds, until a newly launched instance can contribute to the
5814
- * Amazon CloudWatch metrics. This delay lets an instance finish initializing before Amazon EC2 Auto Scaling
5815
- * aggregates instance metrics, resulting in more reliable usage data. Set this value equal
5816
- * to the amount of time that it takes for resource consumption to become stable after an
5817
- * instance reaches the <code>InService</code> state. For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-default-instance-warmup.html">Set
5991
+ * <p>The amount of time, in seconds, until a new instance is considered to have finished
5992
+ * initializing and resource consumption to become stable after it enters the
5993
+ * <code>InService</code> state. </p>
5994
+ * <p>During an instance refresh, Amazon EC2 Auto Scaling waits for the warm-up period after it replaces an
5995
+ * instance before it moves on to replacing the next instance. Amazon EC2 Auto Scaling also waits for the
5996
+ * warm-up period before aggregating the metrics for new instances with existing instances
5997
+ * in the Amazon CloudWatch metrics that are used for scaling, resulting in more reliable usage
5998
+ * data. For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-default-instance-warmup.html">Set
5818
5999
  * the default instance warmup for an Auto Scaling group</a> in the
5819
6000
  * <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
5820
6001
  * <important>
5821
- * <p>To manage your warm-up settings at the group level, we recommend that you set the
5822
- * default instance warmup, <i>even if its value is set to 0 seconds</i>.
5823
- * This also optimizes the performance of scaling policies that scale continuously,
5824
- * such as target tracking and step scaling policies. </p>
5825
- * <p>If you need to remove a value that you previously set, include the property but
5826
- * specify <code>-1</code> for the value. However, we strongly recommend keeping the
5827
- * default instance warmup enabled by specifying a minimum value of
5828
- * <code>0</code>.</p>
6002
+ * <p>To manage various warm-up settings at the group level, we recommend that you set
6003
+ * the default instance warmup, <i>even if it is set to 0 seconds</i>. To
6004
+ * remove a value that you previously set, include the property but specify
6005
+ * <code>-1</code> for the value. However, we strongly recommend keeping the
6006
+ * default instance warmup enabled by specifying a value of <code>0</code> or other
6007
+ * nominal value.</p>
5829
6008
  * </important>
5830
6009
  */
5831
6010
  DefaultInstanceWarmup?: number;
@@ -6142,6 +6321,10 @@ export declare const InstanceRefreshWarmPoolProgressFilterSensitiveLog: (obj: In
6142
6321
  * @internal
6143
6322
  */
6144
6323
  export declare const InstanceRefreshProgressDetailsFilterSensitiveLog: (obj: InstanceRefreshProgressDetails) => any;
6324
+ /**
6325
+ * @internal
6326
+ */
6327
+ export declare const RollbackDetailsFilterSensitiveLog: (obj: RollbackDetails) => any;
6145
6328
  /**
6146
6329
  * @internal
6147
6330
  */
@@ -6490,6 +6673,14 @@ export declare const RecordLifecycleActionHeartbeatTypeFilterSensitiveLog: (obj:
6490
6673
  * @internal
6491
6674
  */
6492
6675
  export declare const ScalingProcessQueryFilterSensitiveLog: (obj: ScalingProcessQuery) => any;
6676
+ /**
6677
+ * @internal
6678
+ */
6679
+ export declare const RollbackInstanceRefreshAnswerFilterSensitiveLog: (obj: RollbackInstanceRefreshAnswer) => any;
6680
+ /**
6681
+ * @internal
6682
+ */
6683
+ export declare const RollbackInstanceRefreshTypeFilterSensitiveLog: (obj: RollbackInstanceRefreshType) => any;
6493
6684
  /**
6494
6685
  * @internal
6495
6686
  */
@@ -57,6 +57,7 @@ import { PutScheduledUpdateGroupActionCommandInput, PutScheduledUpdateGroupActio
57
57
  import { PutWarmPoolCommandInput, PutWarmPoolCommandOutput } from "../commands/PutWarmPoolCommand";
58
58
  import { RecordLifecycleActionHeartbeatCommandInput, RecordLifecycleActionHeartbeatCommandOutput } from "../commands/RecordLifecycleActionHeartbeatCommand";
59
59
  import { ResumeProcessesCommandInput, ResumeProcessesCommandOutput } from "../commands/ResumeProcessesCommand";
60
+ import { RollbackInstanceRefreshCommandInput, RollbackInstanceRefreshCommandOutput } from "../commands/RollbackInstanceRefreshCommand";
60
61
  import { SetDesiredCapacityCommandInput, SetDesiredCapacityCommandOutput } from "../commands/SetDesiredCapacityCommand";
61
62
  import { SetInstanceHealthCommandInput, SetInstanceHealthCommandOutput } from "../commands/SetInstanceHealthCommand";
62
63
  import { SetInstanceProtectionCommandInput, SetInstanceProtectionCommandOutput } from "../commands/SetInstanceProtectionCommand";
@@ -121,6 +122,7 @@ export declare const serializeAws_queryPutScheduledUpdateGroupActionCommand: (in
121
122
  export declare const serializeAws_queryPutWarmPoolCommand: (input: PutWarmPoolCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
122
123
  export declare const serializeAws_queryRecordLifecycleActionHeartbeatCommand: (input: RecordLifecycleActionHeartbeatCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
123
124
  export declare const serializeAws_queryResumeProcessesCommand: (input: ResumeProcessesCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
125
+ export declare const serializeAws_queryRollbackInstanceRefreshCommand: (input: RollbackInstanceRefreshCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
124
126
  export declare const serializeAws_querySetDesiredCapacityCommand: (input: SetDesiredCapacityCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
125
127
  export declare const serializeAws_querySetInstanceHealthCommand: (input: SetInstanceHealthCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
126
128
  export declare const serializeAws_querySetInstanceProtectionCommand: (input: SetInstanceProtectionCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
@@ -185,6 +187,7 @@ export declare const deserializeAws_queryPutScheduledUpdateGroupActionCommand: (
185
187
  export declare const deserializeAws_queryPutWarmPoolCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<PutWarmPoolCommandOutput>;
186
188
  export declare const deserializeAws_queryRecordLifecycleActionHeartbeatCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<RecordLifecycleActionHeartbeatCommandOutput>;
187
189
  export declare const deserializeAws_queryResumeProcessesCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<ResumeProcessesCommandOutput>;
190
+ export declare const deserializeAws_queryRollbackInstanceRefreshCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<RollbackInstanceRefreshCommandOutput>;
188
191
  export declare const deserializeAws_querySetDesiredCapacityCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<SetDesiredCapacityCommandOutput>;
189
192
  export declare const deserializeAws_querySetInstanceHealthCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<SetInstanceHealthCommandOutput>;
190
193
  export declare const deserializeAws_querySetInstanceProtectionCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<SetInstanceProtectionCommandOutput>;
@@ -24,8 +24,8 @@ export declare const getRuntimeConfig: (config: AutoScalingClientConfig) => {
24
24
  utf8Decoder: import("@aws-sdk/types").Decoder;
25
25
  utf8Encoder: import("@aws-sdk/types").Encoder;
26
26
  disableHostPrefix: boolean;
27
- logger: import("@aws-sdk/types").Logger;
28
27
  serviceId: string;
28
+ logger: import("@aws-sdk/types").Logger;
29
29
  endpoint?: ((string | import("@aws-sdk/types").Endpoint | import("@aws-sdk/types").Provider<import("@aws-sdk/types").Endpoint> | import("@aws-sdk/types").EndpointV2 | import("@aws-sdk/types").Provider<import("@aws-sdk/types").EndpointV2>) & (string | import("@aws-sdk/types").Provider<string> | import("@aws-sdk/types").Endpoint | import("@aws-sdk/types").Provider<import("@aws-sdk/types").Endpoint> | import("@aws-sdk/types").EndpointV2 | import("@aws-sdk/types").Provider<import("@aws-sdk/types").EndpointV2>)) | undefined;
30
30
  endpointProvider: (endpointParams: import("./endpoint/EndpointParameters").EndpointParameters, context?: {
31
31
  logger?: import("@aws-sdk/types").Logger | undefined;