@aws-sdk/client-auto-scaling 3.58.0 → 3.73.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/CHANGELOG.md CHANGED
@@ -3,6 +3,33 @@
3
3
  All notable changes to this project will be documented in this file.
4
4
  See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
5
5
 
6
+ # [3.73.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.72.0...v3.73.0) (2022-04-19)
7
+
8
+
9
+ ### Features
10
+
11
+ * **client-auto-scaling:** EC2 Auto Scaling now adds default instance warm-up times for all scaling activities, health check replacements, and other replacement events in the Auto Scaling instance lifecycle. ([b97e526](https://github.com/aws/aws-sdk-js-v3/commit/b97e526b4aef8e65f99f031497efefd9e071f88b))
12
+
13
+
14
+
15
+
16
+
17
+ # [3.72.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.71.0...v3.72.0) (2022-04-15)
18
+
19
+ **Note:** Version bump only for package @aws-sdk/client-auto-scaling
20
+
21
+
22
+
23
+
24
+
25
+ # [3.67.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.66.0...v3.67.0) (2022-04-08)
26
+
27
+ **Note:** Version bump only for package @aws-sdk/client-auto-scaling
28
+
29
+
30
+
31
+
32
+
6
33
  # [3.58.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.57.0...v3.58.0) (2022-03-28)
7
34
 
8
35
  **Note:** Version bump only for package @aws-sdk/client-auto-scaling
package/README.md CHANGED
@@ -122,7 +122,7 @@ but they are supported by the send operation.
122
122
  ```js
123
123
  // callbacks.
124
124
  client.send(command, (err, data) => {
125
- // proccess err and data.
125
+ // process err and data.
126
126
  });
127
127
  ```
128
128
 
@@ -156,7 +156,7 @@ client
156
156
 
157
157
  // callbacks.
158
158
  client.attachInstances(params, (err, data) => {
159
- // proccess err and data.
159
+ // process err and data.
160
160
  });
161
161
  ```
162
162
 
@@ -3584,6 +3584,9 @@ const serializeAws_queryCreateAutoScalingGroupType = (input, context) => {
3584
3584
  if (input.DesiredCapacityType !== undefined && input.DesiredCapacityType !== null) {
3585
3585
  entries["DesiredCapacityType"] = input.DesiredCapacityType;
3586
3586
  }
3587
+ if (input.DefaultInstanceWarmup !== undefined && input.DefaultInstanceWarmup !== null) {
3588
+ entries["DefaultInstanceWarmup"] = input.DefaultInstanceWarmup;
3589
+ }
3587
3590
  return entries;
3588
3591
  };
3589
3592
  const serializeAws_queryCreateLaunchConfigurationType = (input, context) => {
@@ -5503,6 +5506,9 @@ const serializeAws_queryUpdateAutoScalingGroupType = (input, context) => {
5503
5506
  if (input.DesiredCapacityType !== undefined && input.DesiredCapacityType !== null) {
5504
5507
  entries["DesiredCapacityType"] = input.DesiredCapacityType;
5505
5508
  }
5509
+ if (input.DefaultInstanceWarmup !== undefined && input.DefaultInstanceWarmup !== null) {
5510
+ entries["DefaultInstanceWarmup"] = input.DefaultInstanceWarmup;
5511
+ }
5506
5512
  return entries;
5507
5513
  };
5508
5514
  const serializeAws_queryValues = (input, context) => {
@@ -5773,6 +5779,7 @@ const deserializeAws_queryAutoScalingGroup = (output, context) => {
5773
5779
  WarmPoolSize: undefined,
5774
5780
  Context: undefined,
5775
5781
  DesiredCapacityType: undefined,
5782
+ DefaultInstanceWarmup: undefined,
5776
5783
  };
5777
5784
  if (output["AutoScalingGroupName"] !== undefined) {
5778
5785
  contents.AutoScalingGroupName = (0, smithy_client_1.expectString)(output["AutoScalingGroupName"]);
@@ -5894,6 +5901,9 @@ const deserializeAws_queryAutoScalingGroup = (output, context) => {
5894
5901
  if (output["DesiredCapacityType"] !== undefined) {
5895
5902
  contents.DesiredCapacityType = (0, smithy_client_1.expectString)(output["DesiredCapacityType"]);
5896
5903
  }
5904
+ if (output["DefaultInstanceWarmup"] !== undefined) {
5905
+ contents.DefaultInstanceWarmup = (0, smithy_client_1.strictParseInt32)(output["DefaultInstanceWarmup"]);
5906
+ }
5897
5907
  return contents;
5898
5908
  };
5899
5909
  const deserializeAws_queryAutoScalingGroups = (output, context) => {
@@ -4539,6 +4539,9 @@ var serializeAws_queryCreateAutoScalingGroupType = function (input, context) {
4539
4539
  if (input.DesiredCapacityType !== undefined && input.DesiredCapacityType !== null) {
4540
4540
  entries["DesiredCapacityType"] = input.DesiredCapacityType;
4541
4541
  }
4542
+ if (input.DefaultInstanceWarmup !== undefined && input.DefaultInstanceWarmup !== null) {
4543
+ entries["DefaultInstanceWarmup"] = input.DefaultInstanceWarmup;
4544
+ }
4542
4545
  return entries;
4543
4546
  };
4544
4547
  var serializeAws_queryCreateLaunchConfigurationType = function (input, context) {
@@ -6820,6 +6823,9 @@ var serializeAws_queryUpdateAutoScalingGroupType = function (input, context) {
6820
6823
  if (input.DesiredCapacityType !== undefined && input.DesiredCapacityType !== null) {
6821
6824
  entries["DesiredCapacityType"] = input.DesiredCapacityType;
6822
6825
  }
6826
+ if (input.DefaultInstanceWarmup !== undefined && input.DefaultInstanceWarmup !== null) {
6827
+ entries["DefaultInstanceWarmup"] = input.DefaultInstanceWarmup;
6828
+ }
6823
6829
  return entries;
6824
6830
  };
6825
6831
  var serializeAws_queryValues = function (input, context) {
@@ -7101,6 +7107,7 @@ var deserializeAws_queryAutoScalingGroup = function (output, context) {
7101
7107
  WarmPoolSize: undefined,
7102
7108
  Context: undefined,
7103
7109
  DesiredCapacityType: undefined,
7110
+ DefaultInstanceWarmup: undefined,
7104
7111
  };
7105
7112
  if (output["AutoScalingGroupName"] !== undefined) {
7106
7113
  contents.AutoScalingGroupName = __expectString(output["AutoScalingGroupName"]);
@@ -7222,6 +7229,9 @@ var deserializeAws_queryAutoScalingGroup = function (output, context) {
7222
7229
  if (output["DesiredCapacityType"] !== undefined) {
7223
7230
  contents.DesiredCapacityType = __expectString(output["DesiredCapacityType"]);
7224
7231
  }
7232
+ if (output["DefaultInstanceWarmup"] !== undefined) {
7233
+ contents.DefaultInstanceWarmup = __strictParseInt32(output["DefaultInstanceWarmup"]);
7234
+ }
7225
7235
  return contents;
7226
7236
  };
7227
7237
  var deserializeAws_queryAutoScalingGroups = function (output, context) {
@@ -1307,11 +1307,13 @@ export interface CreateAutoScalingGroupType {
1307
1307
  */
1308
1308
  DesiredCapacity?: number;
1309
1309
  /**
1310
- * <p>The amount of time, in seconds, after a scaling activity completes before another
1311
- * scaling activity can start. The default value is <code>300</code>. This setting applies
1312
- * when using simple scaling policies, but not when using other scaling policies or
1313
- * scheduled scaling. For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/Cooldown.html">Scaling cooldowns for Amazon EC2 Auto Scaling</a>
1314
- * in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
1310
+ * <p>
1311
+ * <i>Only needed if you use simple scaling policies.</i>
1312
+ * </p>
1313
+ * <p>The amount of time, in seconds, between one scaling activity ending and another one
1314
+ * starting due to simple scaling policies. For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/Cooldown.html">Scaling cooldowns
1315
+ * for Amazon EC2 Auto Scaling</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
1316
+ * <p>Default: <code>300</code> seconds</p>
1315
1317
  */
1316
1318
  DefaultCooldown?: number;
1317
1319
  /**
@@ -1344,19 +1346,27 @@ export interface CreateAutoScalingGroupType {
1344
1346
  */
1345
1347
  HealthCheckType?: string;
1346
1348
  /**
1347
- * <p>The amount of time, in seconds, that Amazon EC2 Auto Scaling waits before checking the health status
1349
+ * <p>
1350
+ * <i></i>
1351
+ * </p>
1352
+ * <p>The amount of time, in seconds, that Amazon EC2 Auto Scaling waits before checking the health status
1348
1353
  * of an EC2 instance that has come into service and marking it unhealthy due to a failed
1349
- * health check. The default value is <code>0</code>. For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html#health-check-grace-period">Health
1354
+ * Elastic Load Balancing or custom health check. This is useful if your instances do not immediately pass
1355
+ * these health checks after they enter the <code>InService</code> state. For more
1356
+ * information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html#health-check-grace-period">Health
1350
1357
  * check grace period</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
1351
- * <p>Required if you are adding an <code>ELB</code> health check.</p>
1358
+ * <p>Default: <code>0</code> seconds</p>
1352
1359
  */
1353
1360
  HealthCheckGracePeriod?: number;
1354
1361
  /**
1355
- * <p>The name of an existing placement group into which to launch your instances, if any. A
1356
- * placement group is a logical grouping of instances within a single Availability Zone.
1357
- * You cannot specify multiple Availability Zones and a placement group. For more
1358
- * information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html">Placement Groups</a> in the
1362
+ * <p>The name of an existing placement group into which to launch your instances. For more
1363
+ * information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html">Placement groups</a> in the
1359
1364
  * <i>Amazon EC2 User Guide for Linux Instances</i>.</p>
1365
+ * <note>
1366
+ * <p>A <i>cluster</i> placement group is a logical grouping of instances
1367
+ * within a single Availability Zone. You cannot specify multiple Availability Zones
1368
+ * and a cluster placement group. </p>
1369
+ * </note>
1360
1370
  */
1361
1371
  PlacementGroup?: string;
1362
1372
  /**
@@ -1440,6 +1450,27 @@ export interface CreateAutoScalingGroupType {
1440
1450
  * </p>
1441
1451
  */
1442
1452
  DesiredCapacityType?: string;
1453
+ /**
1454
+ * <p>The amount of time, in seconds, until a newly launched instance can contribute to the
1455
+ * Amazon CloudWatch metrics. This delay lets an instance finish initializing before Amazon EC2 Auto Scaling
1456
+ * aggregates instance metrics, resulting in more reliable usage data. Set this value equal
1457
+ * to the amount of time that it takes for resource consumption to become stable after an
1458
+ * 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
1459
+ * the default instance warmup for an Auto Scaling group</a> in the
1460
+ * <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
1461
+ * <important>
1462
+ * <p>To manage your warm-up settings at the group level, we recommend that you set the
1463
+ * default instance warmup, <i>even if its value is set to 0 seconds</i>.
1464
+ * This also optimizes the performance of scaling policies that scale continuously,
1465
+ * such as target tracking and step scaling policies. </p>
1466
+ * <p>If you need to remove a value that you previously set, include the property but
1467
+ * specify <code>-1</code> for the value. However, we strongly recommend keeping the
1468
+ * default instance warmup enabled by specifying a minimum value of
1469
+ * <code>0</code>.</p>
1470
+ * </important>
1471
+ * <p>Default: None </p>
1472
+ */
1473
+ DefaultInstanceWarmup?: number;
1443
1474
  }
1444
1475
  export declare namespace CreateAutoScalingGroupType {
1445
1476
  /**
@@ -1684,18 +1715,23 @@ export interface CreateLaunchConfigurationType {
1684
1715
  */
1685
1716
  SecurityGroups?: string[];
1686
1717
  /**
1687
- * <p>The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances to. For more
1718
+ * <p>
1719
+ * <i>EC2-Classic retires on August 15, 2022. This parameter is not supported after
1720
+ * that date.</i>
1721
+ * </p>
1722
+ * <p>The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances to. For more
1688
1723
  * information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html">ClassicLink</a> in the
1689
- * <i>Amazon EC2 User Guide for Linux Instances</i> and <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-ClassicLink">Linking EC2-Classic
1690
- * instances to a VPC</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
1691
- * <p>This parameter can only be used if you are launching EC2-Classic instances.</p>
1724
+ * <i>Amazon EC2 User Guide for Linux Instances</i>.</p>
1692
1725
  */
1693
1726
  ClassicLinkVPCId?: string;
1694
1727
  /**
1695
- * <p>The IDs of one or more security groups for the specified ClassicLink-enabled VPC. For
1728
+ * <p>
1729
+ * <i>EC2-Classic retires on August 15, 2022. This parameter is not supported after
1730
+ * that date.</i>
1731
+ * </p>
1732
+ * <p>The IDs of one or more security groups for the specified ClassicLink-enabled VPC. For
1696
1733
  * more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html">ClassicLink</a> in the
1697
- * <i>Amazon EC2 User Guide for Linux Instances</i> and <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-ClassicLink">Linking EC2-Classic
1698
- * instances to a VPC</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
1734
+ * <i>Amazon EC2 User Guide for Linux Instances</i>.</p>
1699
1735
  * <p>If you specify the <code>ClassicLinkVPCId</code> parameter, you must specify this
1700
1736
  * parameter.</p>
1701
1737
  */
@@ -2060,7 +2096,7 @@ export interface Filter {
2060
2096
  * the filter (<a>DescribeAutoScalingGroups</a> or <a>DescribeTags</a>).</p>
2061
2097
  * <p>
2062
2098
  * <b>DescribeAutoScalingGroups</b>
2063
- * </p>
2099
+ * </p>
2064
2100
  * <p>Valid values for <code>Name</code> include the following: </p>
2065
2101
  * <ul>
2066
2102
  * <li>
@@ -2531,9 +2567,7 @@ export interface AutoScalingGroup {
2531
2567
  */
2532
2568
  HealthCheckType: string | undefined;
2533
2569
  /**
2534
- * <p>The amount of time, in seconds, that Amazon EC2 Auto Scaling waits before checking the health status
2535
- * of an EC2 instance that has come into service and marking it unhealthy due to a failed
2536
- * health check.</p>
2570
+ * <p>The duration of the health check grace period, in seconds.</p>
2537
2571
  */
2538
2572
  HealthCheckGracePeriod?: number;
2539
2573
  /**
@@ -2607,15 +2641,13 @@ export interface AutoScalingGroup {
2607
2641
  /**
2608
2642
  * <p>The unit of measurement for the value specified for desired capacity. Amazon EC2 Auto Scaling
2609
2643
  * supports <code>DesiredCapacityType</code> for attribute-based instance type selection
2610
- * only. For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-instance-type-requirements.html">Creating
2611
- * an Auto Scaling group using attribute-based instance type selection</a> in the
2612
- * <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
2613
- * <p>By default, Amazon EC2 Auto Scaling specifies <code>units</code>, which translates into number of
2614
- * instances.</p>
2615
- * <p>Valid values: <code>units</code> | <code>vcpu</code> | <code>memory-mib</code>
2616
- * </p>
2644
+ * only.</p>
2617
2645
  */
2618
2646
  DesiredCapacityType?: string;
2647
+ /**
2648
+ * <p>The duration of the default instance warmup, in seconds.</p>
2649
+ */
2650
+ DefaultInstanceWarmup?: number;
2619
2651
  }
2620
2652
  export declare namespace AutoScalingGroup {
2621
2653
  /**
@@ -2810,20 +2842,26 @@ export declare namespace DesiredConfiguration {
2810
2842
  */
2811
2843
  export interface RefreshPreferences {
2812
2844
  /**
2813
- * <p>The amount of capacity in the Auto Scaling group that must remain healthy during an instance
2814
- * refresh to allow the operation to continue. The value is expressed as a percentage of
2815
- * the desired capacity of the Auto Scaling group (rounded up to the nearest integer). The default
2816
- * is <code>90</code>.</p>
2845
+ * <p>The amount of capacity in the Auto Scaling group that must pass your group's health checks to
2846
+ * allow the operation to continue. The value is expressed as a percentage of the desired
2847
+ * capacity of the Auto Scaling group (rounded up to the nearest integer). The default is
2848
+ * <code>90</code>.</p>
2817
2849
  * <p>Setting the minimum healthy percentage to 100 percent limits the rate of replacement
2818
2850
  * to one instance at a time. In contrast, setting it to 0 percent has the effect of
2819
2851
  * replacing all instances at the same time. </p>
2820
2852
  */
2821
2853
  MinHealthyPercentage?: number;
2822
2854
  /**
2823
- * <p>The number of seconds until a newly launched instance is configured and ready to use.
2824
- * During this time, Amazon EC2 Auto Scaling does not immediately move on to the next replacement. The
2825
- * default is to use the value for the health check grace period defined for the
2826
- * group.</p>
2855
+ * <p>
2856
+ * <i>Not needed if the default instance warmup is defined for the
2857
+ * group.</i>
2858
+ * </p>
2859
+ * <p>The duration of the instance warmup, in seconds.</p>
2860
+ * <note>
2861
+ * <p>The default is to use the value for the default instance warmup defined for the
2862
+ * group. If default instance warmup is null, then <code>InstanceWarmup</code> falls
2863
+ * back to the value of the health check grace period.</p>
2864
+ * </note>
2827
2865
  */
2828
2866
  InstanceWarmup?: number;
2829
2867
  /**
@@ -3127,18 +3165,20 @@ export interface LaunchConfiguration {
3127
3165
  */
3128
3166
  SecurityGroups?: string[];
3129
3167
  /**
3130
- * <p>The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances to. For more
3131
- * information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html">ClassicLink</a> in the
3132
- * <i>Amazon EC2 User Guide for Linux Instances</i> and <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-ClassicLink">Linking EC2-Classic
3133
- * instances to a VPC</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
3168
+ * <p>
3169
+ * <i>EC2-Classic retires on August 15, 2022. This parameter is not supported after
3170
+ * that date.</i>
3171
+ * </p>
3172
+ * <p>The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances to.</p>
3134
3173
  */
3135
3174
  ClassicLinkVPCId?: string;
3136
3175
  /**
3137
- * <p>The IDs of one or more security groups for the VPC specified in
3176
+ * <p>
3177
+ * <i>EC2-Classic retires on August 15, 2022. This parameter is not supported after
3178
+ * that date.</i>
3179
+ * </p>
3180
+ * <p>The IDs of one or more security groups for the VPC specified in
3138
3181
  * <code>ClassicLinkVPCId</code>.</p>
3139
- * <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html">ClassicLink</a> in the
3140
- * <i>Amazon EC2 User Guide for Linux Instances</i> and <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-ClassicLink">Linking EC2-Classic
3141
- * instances to a VPC</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
3142
3182
  */
3143
3183
  ClassicLinkVPCSecurityGroups?: string[];
3144
3184
  /**
@@ -3298,9 +3338,8 @@ export interface LifecycleHook {
3298
3338
  */
3299
3339
  HeartbeatTimeout?: number;
3300
3340
  /**
3301
- * <p>The maximum time, in seconds, that an instance can remain in a
3302
- * <code>Pending:Wait</code> or <code>Terminating:Wait</code> state. The maximum is
3303
- * 172800 seconds (48 hours) or 100 times <code>HeartbeatTimeout</code>, whichever is
3341
+ * <p>The maximum time, in seconds, that an instance can remain in a wait state. The maximum
3342
+ * is 172800 seconds (48 hours) or 100 times <code>HeartbeatTimeout</code>, whichever is
3304
3343
  * smaller.</p>
3305
3344
  */
3306
3345
  GlobalTimeout?: number;
@@ -4466,18 +4505,18 @@ export interface PredefinedMetricSpecification {
4466
4505
  * </li>
4467
4506
  * <li>
4468
4507
  * <p>
4469
- * <code>ASGAverageNetworkIn</code> - Average number of bytes received (per
4470
- * instance per minute) for the Auto Scaling group.</p>
4508
+ * <code>ASGAverageNetworkIn</code> - Average number of bytes received on all
4509
+ * network interfaces by the Auto Scaling group.</p>
4471
4510
  * </li>
4472
4511
  * <li>
4473
4512
  * <p>
4474
- * <code>ASGAverageNetworkOut</code> - Average number of bytes sent out (per
4475
- * instance per minute) for the Auto Scaling group.</p>
4513
+ * <code>ASGAverageNetworkOut</code> - Average number of bytes sent out on all
4514
+ * network interfaces by the Auto Scaling group.</p>
4476
4515
  * </li>
4477
4516
  * <li>
4478
4517
  * <p>
4479
- * <code>ALBRequestCountPerTarget</code> - Average Application Load Balancer request count (per
4480
- * target per minute) for your Auto Scaling group.</p>
4518
+ * <code>ALBRequestCountPerTarget</code> - Average Application Load Balancer request count per target
4519
+ * for your Auto Scaling group.</p>
4481
4520
  * </li>
4482
4521
  * </ul>
4483
4522
  */
@@ -5735,12 +5774,12 @@ export interface PutScalingPolicyType {
5735
5774
  */
5736
5775
  ScalingAdjustment?: number;
5737
5776
  /**
5738
- * <p>The duration of the policy's cooldown period, in seconds. When a cooldown period is
5739
- * specified here, it overrides the default cooldown period defined for the Auto Scaling
5740
- * group.</p>
5777
+ * <p>A cooldown period, in seconds, that applies to a specific simple scaling policy. When
5778
+ * a cooldown period is specified here, it overrides the default cooldown.</p>
5741
5779
  * <p>Valid only if the policy type is <code>SimpleScaling</code>. For more information, see
5742
5780
  * <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/Cooldown.html">Scaling
5743
5781
  * cooldowns for Amazon EC2 Auto Scaling</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
5782
+ * <p>Default: None</p>
5744
5783
  */
5745
5784
  Cooldown?: number;
5746
5785
  /**
@@ -5758,11 +5797,21 @@ export interface PutScalingPolicyType {
5758
5797
  */
5759
5798
  StepAdjustments?: StepAdjustment[];
5760
5799
  /**
5761
- * <p>The estimated time, in seconds, until a newly launched instance can contribute to the
5762
- * CloudWatch metrics. If not provided, the default is to use the value from the default cooldown
5763
- * period for the Auto Scaling group.</p>
5800
+ * <p>
5801
+ * <i>Not needed if the default instance warmup is defined for the
5802
+ * group.</i>
5803
+ * </p>
5804
+ * <p>The estimated time, in seconds, until a newly launched instance can contribute to the
5805
+ * CloudWatch metrics. This warm-up period applies to instances launched due to a specific target
5806
+ * tracking or step scaling policy. When a warm-up period is specified here, it overrides
5807
+ * the default instance warmup.</p>
5764
5808
  * <p>Valid only if the policy type is <code>TargetTrackingScaling</code> or
5765
5809
  * <code>StepScaling</code>.</p>
5810
+ * <note>
5811
+ * <p>The default is to use the value for the default instance warmup defined for the
5812
+ * group. If default instance warmup is null, then <code>EstimatedInstanceWarmup</code>
5813
+ * falls back to the value of default cooldown.</p>
5814
+ * </note>
5766
5815
  */
5767
5816
  EstimatedInstanceWarmup?: number;
5768
5817
  /**
@@ -6259,11 +6308,12 @@ export interface UpdateAutoScalingGroupType {
6259
6308
  */
6260
6309
  DesiredCapacity?: number;
6261
6310
  /**
6262
- * <p>The amount of time, in seconds, after a scaling activity completes before another
6263
- * scaling activity can start. The default value is <code>300</code>. This setting applies
6264
- * when using simple scaling policies, but not when using other scaling policies or
6265
- * scheduled scaling. For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/Cooldown.html">Scaling cooldowns for Amazon EC2 Auto Scaling</a>
6266
- * in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
6311
+ * <p>
6312
+ * <i>Only needed if you use simple scaling policies.</i>
6313
+ * </p>
6314
+ * <p>The amount of time, in seconds, between one scaling activity ending and another one
6315
+ * starting due to simple scaling policies. For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/Cooldown.html">Scaling cooldowns
6316
+ * for Amazon EC2 Auto Scaling</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
6267
6317
  */
6268
6318
  DefaultCooldown?: number;
6269
6319
  /**
@@ -6280,17 +6330,21 @@ export interface UpdateAutoScalingGroupType {
6280
6330
  /**
6281
6331
  * <p>The amount of time, in seconds, that Amazon EC2 Auto Scaling waits before checking the health status
6282
6332
  * of an EC2 instance that has come into service and marking it unhealthy due to a failed
6283
- * health check. The default value is <code>0</code>. For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html#health-check-grace-period">Health
6333
+ * Elastic Load Balancing or custom health check. This is useful if your instances do not immediately pass
6334
+ * these health checks after they enter the <code>InService</code> state. For more
6335
+ * information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html#health-check-grace-period">Health
6284
6336
  * check grace period</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
6285
- * <p>Required if you are adding an <code>ELB</code> health check.</p>
6286
6337
  */
6287
6338
  HealthCheckGracePeriod?: number;
6288
6339
  /**
6289
- * <p>The name of an existing placement group into which to launch your instances, if any. A
6290
- * placement group is a logical grouping of instances within a single Availability Zone.
6291
- * You cannot specify multiple Availability Zones and a placement group. For more
6292
- * information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html">Placement Groups</a> in the
6340
+ * <p>The name of an existing placement group into which to launch your instances. For more
6341
+ * information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html">Placement groups</a> in the
6293
6342
  * <i>Amazon EC2 User Guide for Linux Instances</i>.</p>
6343
+ * <note>
6344
+ * <p>A <i>cluster</i> placement group is a logical grouping of instances
6345
+ * within a single Availability Zone. You cannot specify multiple Availability Zones
6346
+ * and a cluster placement group. </p>
6347
+ * </note>
6294
6348
  */
6295
6349
  PlacementGroup?: string;
6296
6350
  /**
@@ -6349,6 +6403,26 @@ export interface UpdateAutoScalingGroupType {
6349
6403
  * </p>
6350
6404
  */
6351
6405
  DesiredCapacityType?: string;
6406
+ /**
6407
+ * <p>The amount of time, in seconds, until a newly launched instance can contribute to the
6408
+ * Amazon CloudWatch metrics. This delay lets an instance finish initializing before Amazon EC2 Auto Scaling
6409
+ * aggregates instance metrics, resulting in more reliable usage data. Set this value equal
6410
+ * to the amount of time that it takes for resource consumption to become stable after an
6411
+ * 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
6412
+ * the default instance warmup for an Auto Scaling group</a> in the
6413
+ * <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
6414
+ * <important>
6415
+ * <p>To manage your warm-up settings at the group level, we recommend that you set the
6416
+ * default instance warmup, <i>even if its value is set to 0 seconds</i>.
6417
+ * This also optimizes the performance of scaling policies that scale continuously,
6418
+ * such as target tracking and step scaling policies. </p>
6419
+ * <p>If you need to remove a value that you previously set, include the property but
6420
+ * specify <code>-1</code> for the value. However, we strongly recommend keeping the
6421
+ * default instance warmup enabled by specifying a minimum value of
6422
+ * <code>0</code>.</p>
6423
+ * </important>
6424
+ */
6425
+ DefaultInstanceWarmup?: number;
6352
6426
  }
6353
6427
  export declare namespace UpdateAutoScalingGroupType {
6354
6428
  /**
@@ -613,6 +613,8 @@ export interface CreateAutoScalingGroupType {
613
613
  Context?: string;
614
614
 
615
615
  DesiredCapacityType?: string;
616
+
617
+ DefaultInstanceWarmup?: number;
616
618
  }
617
619
  export declare namespace CreateAutoScalingGroupType {
618
620
 
@@ -1074,6 +1076,8 @@ export interface AutoScalingGroup {
1074
1076
  Context?: string;
1075
1077
 
1076
1078
  DesiredCapacityType?: string;
1079
+
1080
+ DefaultInstanceWarmup?: number;
1077
1081
  }
1078
1082
  export declare namespace AutoScalingGroup {
1079
1083
 
@@ -2446,6 +2450,8 @@ export interface UpdateAutoScalingGroupType {
2446
2450
  Context?: string;
2447
2451
 
2448
2452
  DesiredCapacityType?: string;
2453
+
2454
+ DefaultInstanceWarmup?: number;
2449
2455
  }
2450
2456
  export declare namespace UpdateAutoScalingGroupType {
2451
2457
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-auto-scaling",
3
3
  "description": "AWS SDK for JavaScript Auto Scaling Client for Node.js, Browser and React Native",
4
- "version": "3.58.0",
4
+ "version": "3.73.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -18,9 +18,9 @@
18
18
  "dependencies": {
19
19
  "@aws-crypto/sha256-browser": "2.0.0",
20
20
  "@aws-crypto/sha256-js": "2.0.0",
21
- "@aws-sdk/client-sts": "3.58.0",
21
+ "@aws-sdk/client-sts": "3.72.0",
22
22
  "@aws-sdk/config-resolver": "3.58.0",
23
- "@aws-sdk/credential-provider-node": "3.58.0",
23
+ "@aws-sdk/credential-provider-node": "3.72.0",
24
24
  "@aws-sdk/fetch-http-handler": "3.58.0",
25
25
  "@aws-sdk/hash-node": "3.55.0",
26
26
  "@aws-sdk/invalid-dependency": "3.55.0",
@@ -35,15 +35,15 @@
35
35
  "@aws-sdk/node-config-provider": "3.58.0",
36
36
  "@aws-sdk/node-http-handler": "3.58.0",
37
37
  "@aws-sdk/protocol-http": "3.58.0",
38
- "@aws-sdk/smithy-client": "3.55.0",
38
+ "@aws-sdk/smithy-client": "3.72.0",
39
39
  "@aws-sdk/types": "3.55.0",
40
40
  "@aws-sdk/url-parser": "3.55.0",
41
41
  "@aws-sdk/util-base64-browser": "3.58.0",
42
42
  "@aws-sdk/util-base64-node": "3.55.0",
43
43
  "@aws-sdk/util-body-length-browser": "3.55.0",
44
44
  "@aws-sdk/util-body-length-node": "3.55.0",
45
- "@aws-sdk/util-defaults-mode-browser": "3.55.0",
46
- "@aws-sdk/util-defaults-mode-node": "3.58.0",
45
+ "@aws-sdk/util-defaults-mode-browser": "3.72.0",
46
+ "@aws-sdk/util-defaults-mode-node": "3.72.0",
47
47
  "@aws-sdk/util-user-agent-browser": "3.58.0",
48
48
  "@aws-sdk/util-user-agent-node": "3.58.0",
49
49
  "@aws-sdk/util-utf8-browser": "3.55.0",