@aws-sdk/client-auto-scaling 3.267.0 → 3.269.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.
- package/dist-cjs/AutoScaling.js +15 -0
- package/dist-cjs/commands/RollbackInstanceRefreshCommand.js +46 -0
- package/dist-cjs/commands/index.js +1 -0
- package/dist-cjs/endpoint/ruleset.js +3 -3
- package/dist-cjs/models/models_0.js +45 -5
- package/dist-cjs/protocols/Aws_query.js +142 -2
- package/dist-es/AutoScaling.js +15 -0
- package/dist-es/commands/RollbackInstanceRefreshCommand.js +42 -0
- package/dist-es/commands/index.js +1 -0
- package/dist-es/endpoint/ruleset.js +3 -3
- package/dist-es/models/models_0.js +36 -0
- package/dist-es/protocols/Aws_query.js +139 -1
- package/dist-types/AutoScaling.d.ts +56 -45
- package/dist-types/AutoScalingClient.d.ts +3 -2
- package/dist-types/commands/CancelInstanceRefreshCommand.d.ts +5 -3
- package/dist-types/commands/DescribeInstanceRefreshesCommand.d.ts +6 -35
- package/dist-types/commands/RollbackInstanceRefreshCommand.d.ts +59 -0
- package/dist-types/commands/StartInstanceRefreshCommand.d.ts +16 -7
- package/dist-types/commands/index.d.ts +1 -0
- package/dist-types/endpoint/EndpointParameters.d.ts +1 -1
- package/dist-types/models/models_0.d.ts +280 -89
- package/dist-types/protocols/Aws_query.d.ts +3 -0
- package/dist-types/ts3.4/AutoScaling.d.ts +17 -0
- package/dist-types/ts3.4/AutoScalingClient.d.ts +6 -0
- package/dist-types/ts3.4/commands/RollbackInstanceRefreshCommand.d.ts +41 -0
- package/dist-types/ts3.4/commands/index.d.ts +1 -0
- package/dist-types/ts3.4/endpoint/EndpointParameters.d.ts +1 -1
- package/dist-types/ts3.4/models/models_0.d.ts +49 -0
- package/dist-types/ts3.4/protocols/Aws_query.d.ts +12 -0
- package/package.json +1 -1
|
@@ -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
|
|
53
|
-
* not found
|
|
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
|
|
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
|
|
1425
|
-
*
|
|
1426
|
-
*
|
|
1427
|
-
*
|
|
1428
|
-
* instance
|
|
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
|
|
1433
|
-
* default instance warmup, <i>even if
|
|
1434
|
-
*
|
|
1435
|
-
*
|
|
1436
|
-
*
|
|
1437
|
-
*
|
|
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>
|
|
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
|
-
*
|
|
2637
|
-
*
|
|
2638
|
-
*
|
|
2639
|
-
*
|
|
2640
|
-
*
|
|
2641
|
-
*
|
|
2642
|
-
*
|
|
2643
|
-
*
|
|
2644
|
-
*
|
|
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
|
|
2649
|
-
* To replace all instances in the Auto Scaling group, the last number in the array must
|
|
2650
|
-
*
|
|
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
|
|
2658
|
-
* property is optional, but if you specify a value for it, you must also
|
|
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>
|
|
2666
|
-
* Amazon EC2 Auto Scaling skips replacing instances that match the desired configuration. If no
|
|
2667
|
-
* configuration is specified, then it skips replacing instances that have the same
|
|
2668
|
-
*
|
|
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
|
|
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
|
|
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
|
|
2711
|
-
*
|
|
2712
|
-
*
|
|
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>
|
|
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>
|
|
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
|
|
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>
|
|
2872
|
+
* <code>Successful</code> - An instance refresh completed successfully.</p>
|
|
2757
2873
|
* </li>
|
|
2758
2874
|
* <li>
|
|
2759
2875
|
* <p>
|
|
2760
|
-
* <code>
|
|
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>
|
|
2765
|
-
*
|
|
2881
|
+
* <code>Cancelling</code> - An ongoing instance refresh is being
|
|
2882
|
+
* cancelled.</p>
|
|
2766
2883
|
* </li>
|
|
2767
2884
|
* <li>
|
|
2768
2885
|
* <p>
|
|
2769
|
-
* <code>
|
|
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>
|
|
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>
|
|
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
|
|
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
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
|
5597
|
-
*
|
|
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
|
|
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
|
-
*
|
|
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>
|
|
5647
|
-
*
|
|
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
|
|
5814
|
-
*
|
|
5815
|
-
*
|
|
5816
|
-
*
|
|
5817
|
-
* instance
|
|
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
|
|
5822
|
-
* default instance warmup, <i>even if
|
|
5823
|
-
*
|
|
5824
|
-
*
|
|
5825
|
-
*
|
|
5826
|
-
*
|
|
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>;
|