@aws-sdk/client-auto-scaling 3.131.0 → 3.136.1

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.
@@ -518,8 +518,8 @@ export interface CompleteLifecycleActionType {
518
518
  */
519
519
  LifecycleActionToken?: string;
520
520
  /**
521
- * <p>The action for the group to take. This parameter can be either <code>CONTINUE</code>
522
- * or <code>ABANDON</code>.</p>
521
+ * <p>The action for the group to take. You can specify either <code>CONTINUE</code> or
522
+ * <code>ABANDON</code>.</p>
523
523
  */
524
524
  LifecycleActionResult: string | undefined;
525
525
  /**
@@ -584,14 +584,16 @@ export interface LifecycleHookSpecification {
584
584
  */
585
585
  LifecycleHookName: string | undefined;
586
586
  /**
587
- * <p>The state of the EC2 instance to which you want to attach the lifecycle hook. The
588
- * valid values are:</p>
587
+ * <p>The lifecycle transition. For Auto Scaling groups, there are two major lifecycle
588
+ * transitions.</p>
589
589
  * <ul>
590
590
  * <li>
591
- * <p>autoscaling:EC2_INSTANCE_LAUNCHING</p>
591
+ * <p>To create a lifecycle hook for scale-out events, specify
592
+ * <code>autoscaling:EC2_INSTANCE_LAUNCHING</code>.</p>
592
593
  * </li>
593
594
  * <li>
594
- * <p>autoscaling:EC2_INSTANCE_TERMINATING</p>
595
+ * <p>To create a lifecycle hook for scale-in events, specify
596
+ * <code>autoscaling:EC2_INSTANCE_TERMINATING</code>.</p>
595
597
  * </li>
596
598
  * </ul>
597
599
  */
@@ -602,30 +604,29 @@ export interface LifecycleHookSpecification {
602
604
  */
603
605
  NotificationMetadata?: string;
604
606
  /**
605
- * <p>The maximum time, in seconds, that can elapse before the lifecycle hook times
606
- * out.</p>
607
- * <p>If the lifecycle hook times out, Amazon EC2 Auto Scaling performs the action that you specified in
608
- * the <code>DefaultResult</code> parameter. You can prevent the lifecycle hook from timing
609
- * out by calling <a>RecordLifecycleActionHeartbeat</a>.</p>
607
+ * <p>The maximum time, in seconds, that can elapse before the lifecycle hook times out. The
608
+ * range is from <code>30</code> to <code>7200</code> seconds. The default value is
609
+ * <code>3600</code> seconds (1 hour).</p>
610
610
  */
611
611
  HeartbeatTimeout?: number;
612
612
  /**
613
- * <p>Defines the action the Auto Scaling group should take when the lifecycle hook timeout elapses
614
- * or if an unexpected failure occurs. The valid values are <code>CONTINUE</code> and
615
- * <code>ABANDON</code>. The default value is <code>ABANDON</code>.</p>
613
+ * <p>The action the Auto Scaling group takes when the lifecycle hook timeout elapses or if an
614
+ * unexpected failure occurs. The default value is <code>ABANDON</code>.</p>
615
+ * <p>Valid values: <code>CONTINUE</code> | <code>ABANDON</code>
616
+ * </p>
616
617
  */
617
618
  DefaultResult?: string;
618
619
  /**
619
- * <p>The ARN of the target that Amazon EC2 Auto Scaling sends notifications to when an instance is in the
620
- * transition state for the lifecycle hook. The notification target can be either an SQS
621
- * queue or an SNS topic.</p>
620
+ * <p>The Amazon Resource Name (ARN) of the notification target that Amazon EC2 Auto Scaling sends
621
+ * notifications to when an instance is in a wait state for the lifecycle hook. You can
622
+ * specify an Amazon SNS topic or an Amazon SQS queue.</p>
622
623
  */
623
624
  NotificationTargetARN?: string;
624
625
  /**
625
626
  * <p>The ARN of the IAM role that allows the Auto Scaling group to publish to the specified
626
- * notification target.</p>
627
- * <p>Valid only if the notification target is an Amazon SNS topic or an Amazon SQS queue. Required
628
- * for new lifecycle hooks, but optional when updating existing hooks.</p>
627
+ * notification target. For information about creating this role, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/prepare-for-lifecycle-notifications.html#lifecycle-hook-notification-target">Configure a notification target for a lifecycle hook</a> in the
628
+ * <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
629
+ * <p>Valid only if the notification target is an Amazon SNS topic or an Amazon SQS queue.</p>
629
630
  */
630
631
  RoleARN?: string;
631
632
  }
@@ -650,6 +651,8 @@ export interface InstancesDistribution {
650
651
  * on.</p>
651
652
  * <p>Default: <code>lowest-price</code> for Auto Scaling groups that specify <a>InstanceRequirements</a> in the overrides and <code>prioritized</code> for
652
653
  * Auto Scaling groups that don't.</p>
654
+ * <p>Valid values: <code>lowest-price</code> | <code>prioritized</code>
655
+ * </p>
653
656
  */
654
657
  OnDemandAllocationStrategy?: string;
655
658
  /**
@@ -685,6 +688,9 @@ export interface InstancesDistribution {
685
688
  * but optimizes for capacity first. </p>
686
689
  * <p>Default: <code>lowest-price</code>
687
690
  * </p>
691
+ * <p>Valid values: <code>lowest-price</code> | <code>capacity-optimized</code> |
692
+ * <code>capacity-optimized-prioritized</code>
693
+ * </p>
688
694
  */
689
695
  SpotAllocationStrategy?: string;
690
696
  /**
@@ -701,6 +707,11 @@ export interface InstancesDistribution {
701
707
  * you keep the value at its default (unspecified), Amazon EC2 Auto Scaling uses the On-Demand price as
702
708
  * the maximum Spot price. To remove a value that you previously set, include the property
703
709
  * but specify an empty string ("") for the value.</p>
710
+ * <important>
711
+ * <p>If your maximum price is lower than the Spot price for the instance types that you
712
+ * selected, your Spot Instances are not launched.</p>
713
+ * </important>
714
+ * <p>Valid Range: Minimum value of 0.001</p>
704
715
  */
705
716
  SpotMaxPrice?: string;
706
717
  }
@@ -936,11 +947,12 @@ export interface InstanceRequirements {
936
947
  InstanceGenerations?: (InstanceGeneration | string)[];
937
948
  /**
938
949
  * <p>The price protection threshold for Spot Instances. This is the maximum you’ll pay for
939
- * a Spot Instance, expressed as a percentage higher than the cheapest M, C, or R instance
940
- * type with your specified attributes. When Amazon EC2 Auto Scaling selects instance types with your
941
- * attributes, we will exclude instance types whose price is higher than your threshold.
942
- * The parameter accepts an integer, which Amazon EC2 Auto Scaling interprets as a percentage. To turn off
943
- * price protection, specify a high value, such as <code>999999</code>. </p>
950
+ * a Spot Instance, expressed as a percentage higher than the least expensive current
951
+ * generation M, C, or R instance type with your specified attributes. When Amazon EC2 Auto Scaling
952
+ * selects instance types with your attributes, we will exclude instance types whose price
953
+ * is higher than your threshold. The parameter accepts an integer, which Amazon EC2 Auto Scaling
954
+ * interprets as a percentage. To turn off price protection, specify a high value, such as
955
+ * <code>999999</code>. </p>
944
956
  * <p>If you set <code>DesiredCapacityType</code> to <code>vcpu</code> or
945
957
  * <code>memory-mib</code>, the price protection threshold is applied based on the per
946
958
  * vCPU or per memory price instead of the per instance price. </p>
@@ -950,11 +962,12 @@ export interface InstanceRequirements {
950
962
  SpotMaxPricePercentageOverLowestPrice?: number;
951
963
  /**
952
964
  * <p>The price protection threshold for On-Demand Instances. This is the maximum you’ll pay
953
- * for an On-Demand Instance, expressed as a percentage higher than the cheapest M, C, or R
954
- * instance type with your specified attributes. When Amazon EC2 Auto Scaling selects instance types with
955
- * your attributes, we will exclude instance types whose price is higher than your
956
- * threshold. The parameter accepts an integer, which Amazon EC2 Auto Scaling interprets as a percentage.
957
- * To turn off price protection, specify a high value, such as <code>999999</code>. </p>
965
+ * for an On-Demand Instance, expressed as a percentage higher than the least expensive
966
+ * current generation M, C, or R instance type with your specified attributes. When
967
+ * Amazon EC2 Auto Scaling selects instance types with your attributes, we will exclude instance types
968
+ * whose price is higher than your threshold. The parameter accepts an integer, which
969
+ * Amazon EC2 Auto Scaling interprets as a percentage. To turn off price protection, specify a high value,
970
+ * such as <code>999999</code>. </p>
958
971
  * <p>If you set <code>DesiredCapacityType</code> to <code>vcpu</code> or
959
972
  * <code>memory-mib</code>, the price protection threshold is applied based on the per
960
973
  * vCPU or per memory price instead of the per instance price. </p>
@@ -1007,7 +1020,7 @@ export interface InstanceRequirements {
1007
1020
  * </li>
1008
1021
  * <li>
1009
1022
  * <p>For instance types with solid state drive (SSD) storage, specify
1010
- * <code>sdd</code>.</p>
1023
+ * <code>ssd</code>.</p>
1011
1024
  * </li>
1012
1025
  * </ul>
1013
1026
  * <p>Default: Any local storage type</p>
@@ -1192,13 +1205,12 @@ export declare namespace LaunchTemplate {
1192
1205
  */
1193
1206
  export interface MixedInstancesPolicy {
1194
1207
  /**
1195
- * <p>Specifies the launch template to use and the instance types (overrides) that are used
1196
- * to launch EC2 instances to fulfill On-Demand and Spot capacities. Required when creating
1197
- * a mixed instances policy.</p>
1208
+ * <p>One or more launch templates and the instance types (overrides) that are used to
1209
+ * launch EC2 instances to fulfill On-Demand and Spot capacities.</p>
1198
1210
  */
1199
1211
  LaunchTemplate?: LaunchTemplate;
1200
1212
  /**
1201
- * <p>Specifies the instances distribution.</p>
1213
+ * <p>The instances distribution.</p>
1202
1214
  */
1203
1215
  InstancesDistribution?: InstancesDistribution;
1204
1216
  }
@@ -1254,7 +1266,8 @@ export interface CreateAutoScalingGroupType {
1254
1266
  */
1255
1267
  LaunchConfigurationName?: string;
1256
1268
  /**
1257
- * <p>Parameters used to specify the launch template and version to use to launch instances. </p>
1269
+ * <p>Information used to specify the launch template and version to use to launch
1270
+ * instances. </p>
1258
1271
  * <p>Conditional: You must specify either a launch template (<code>LaunchTemplate</code> or
1259
1272
  * <code>MixedInstancesPolicy</code>) or a launch configuration
1260
1273
  * (<code>LaunchConfigurationName</code> or <code>InstanceId</code>).</p>
@@ -1317,24 +1330,24 @@ export interface CreateAutoScalingGroupType {
1317
1330
  */
1318
1331
  DefaultCooldown?: number;
1319
1332
  /**
1320
- * <p>A list of Availability Zones where instances in the Auto Scaling group can be created. This
1321
- * parameter is optional if you specify one or more subnets for
1322
- * <code>VPCZoneIdentifier</code>.</p>
1323
- * <p>Conditional: If your account supports EC2-Classic and VPC, this parameter is required
1324
- * to launch instances into EC2-Classic.</p>
1333
+ * <p>A list of Availability Zones where instances in the Auto Scaling group can be created. Used
1334
+ * for launching into the default VPC subnet in each Availability Zone when not using the
1335
+ * <code>VPCZoneIdentifier</code> property, or for attaching a network interface when
1336
+ * an existing network interface ID is specified in a launch template.</p>
1325
1337
  */
1326
1338
  AvailabilityZones?: string[];
1327
1339
  /**
1328
- * <p>A list of Classic Load Balancers associated with this Auto Scaling group. For
1329
- * Application Load Balancers, Network Load Balancers, and Gateway Load Balancers, specify
1330
- * the <code>TargetGroupARNs</code> property instead.</p>
1340
+ * <p>A list of Classic Load Balancers associated with this Auto Scaling group. For Application Load Balancers, Network Load Balancers, and Gateway Load Balancer,
1341
+ * specify the <code>TargetGroupARNs</code> property instead.</p>
1331
1342
  */
1332
1343
  LoadBalancerNames?: string[];
1333
1344
  /**
1334
1345
  * <p>The Amazon Resource Names (ARN) of the target groups to associate with the Auto Scaling group.
1335
- * Instances are registered as targets in a target group, and traffic is routed to the
1336
- * target group. For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html">Elastic Load Balancing and
1337
- * Amazon EC2 Auto Scaling</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
1346
+ * Instances are registered as targets with the target groups. The target groups receive
1347
+ * incoming traffic and route requests to one or more registered targets. For more
1348
+ * information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html">Use Elastic Load Balancing to
1349
+ * distribute traffic across the instances in your Auto Scaling group</a> in the
1350
+ * <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
1338
1351
  */
1339
1352
  TargetGroupARNs?: string[];
1340
1353
  /**
@@ -1346,10 +1359,7 @@ export interface CreateAutoScalingGroupType {
1346
1359
  */
1347
1360
  HealthCheckType?: string;
1348
1361
  /**
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
1362
+ * <p>The amount of time, in seconds, that Amazon EC2 Auto Scaling waits before checking the health status
1353
1363
  * of an EC2 instance that has come into service and marking it unhealthy due to a failed
1354
1364
  * Elastic Load Balancing or custom health check. This is useful if your instances do not immediately pass
1355
1365
  * these health checks after they enter the <code>InService</code> state. For more
@@ -1359,7 +1369,7 @@ export interface CreateAutoScalingGroupType {
1359
1369
  */
1360
1370
  HealthCheckGracePeriod?: number;
1361
1371
  /**
1362
- * <p>The name of an existing placement group into which to launch your instances. For more
1372
+ * <p>The name of the placement group into which to launch your instances. For more
1363
1373
  * information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html">Placement groups</a> in the
1364
1374
  * <i>Amazon EC2 User Guide for Linux Instances</i>.</p>
1365
1375
  * <note>
@@ -1372,18 +1382,22 @@ export interface CreateAutoScalingGroupType {
1372
1382
  /**
1373
1383
  * <p>A comma-separated list of subnet IDs for a virtual private cloud (VPC) where instances
1374
1384
  * in the Auto Scaling group can be created. If you specify <code>VPCZoneIdentifier</code> with
1375
- * <code>AvailabilityZones</code>, the subnets that you specify for this parameter must
1376
- * reside in those Availability Zones.</p>
1377
- * <p>Conditional: If your account supports EC2-Classic and VPC, this parameter is required
1378
- * to launch instances into a VPC.</p>
1385
+ * <code>AvailabilityZones</code>, the subnets that you specify must reside in those
1386
+ * Availability Zones.</p>
1379
1387
  */
1380
1388
  VPCZoneIdentifier?: string;
1381
1389
  /**
1382
1390
  * <p>A policy or a list of policies that are used to select the instance to terminate.
1383
1391
  * These policies are executed in the order that you list them. For more information, see
1384
- * <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html">Controlling which Auto Scaling
1385
- * instances terminate during scale in</a> in the
1386
- * <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
1392
+ * <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-termination-policies.html">Work with
1393
+ * Amazon EC2 Auto Scaling termination policies</a> in the
1394
+ * <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
1395
+ * <p>Valid values: <code>Default</code> | <code>AllocationStrategy</code> |
1396
+ * <code>ClosestToNextInstanceHour</code> | <code>NewestInstance</code> |
1397
+ * <code>OldestInstance</code> | <code>OldestLaunchConfiguration</code> |
1398
+ * <code>OldestLaunchTemplate</code> |
1399
+ * <code>arn:aws:lambda:region:account-id:function:my-function:my-alias</code>
1400
+ * </p>
1387
1401
  */
1388
1402
  TerminationPolicies?: string[];
1389
1403
  /**
@@ -1399,13 +1413,13 @@ export interface CreateAutoScalingGroupType {
1399
1413
  * disabled. When you turn on Capacity Rebalancing, Amazon EC2 Auto Scaling attempts to launch a Spot
1400
1414
  * Instance whenever Amazon EC2 notifies that a Spot Instance is at an elevated risk of
1401
1415
  * interruption. After launching a new instance, it then terminates an old instance. For
1402
- * more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-capacity-rebalancing.html">Amazon EC2 Auto Scaling
1403
- * Capacity Rebalancing</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
1416
+ * more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-capacity-rebalancing.html">Use Capacity
1417
+ * Rebalancing to handle Amazon EC2 Spot Interruptions</a> in the in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
1404
1418
  */
1405
1419
  CapacityRebalance?: boolean;
1406
1420
  /**
1407
- * <p>One or more lifecycle hooks for the group, which specify actions to perform when
1408
- * Amazon EC2 Auto Scaling launches or terminates instances.</p>
1421
+ * <p>One or more lifecycle hooks to add to the Auto Scaling group before instances are
1422
+ * launched.</p>
1409
1423
  */
1410
1424
  LifecycleHookSpecificationList?: LifecycleHookSpecification[];
1411
1425
  /**
@@ -1414,13 +1428,13 @@ export interface CreateAutoScalingGroupType {
1414
1428
  * volumes, specify the tags in a launch template but use caution. If the launch template
1415
1429
  * specifies an instance tag with a key that is also specified for the Auto Scaling group, Amazon EC2 Auto Scaling
1416
1430
  * overrides the value of that instance tag with the value specified by the Auto Scaling group. For
1417
- * more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html">Tagging Auto Scaling groups and
1431
+ * more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-tagging.html">Tag Auto Scaling groups and
1418
1432
  * instances</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
1419
1433
  */
1420
1434
  Tags?: Tag[];
1421
1435
  /**
1422
1436
  * <p>The Amazon Resource Name (ARN) of the service-linked role that the Auto Scaling group uses to
1423
- * call other Amazon Web Services on your behalf. By default, Amazon EC2 Auto Scaling uses a service-linked role
1437
+ * call other Amazon Web Services service on your behalf. By default, Amazon EC2 Auto Scaling uses a service-linked role
1424
1438
  * named <code>AWSServiceRoleForAutoScaling</code>, which it creates if it does not exist.
1425
1439
  * For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-service-linked-role.html">Service-linked
1426
1440
  * roles</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
@@ -1517,7 +1531,7 @@ export interface Ebs {
1517
1531
  /**
1518
1532
  * <p>The volume type. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html">Amazon EBS volume types</a> in the
1519
1533
  * <i>Amazon EC2 User Guide for Linux Instances</i>.</p>
1520
- * <p>Valid Values: <code>standard</code> | <code>io1</code> | <code>gp2</code> |
1534
+ * <p>Valid values: <code>standard</code> | <code>io1</code> | <code>gp2</code> |
1521
1535
  * <code>st1</code> | <code>sc1</code> | <code>gp3</code>
1522
1536
  * </p>
1523
1537
  */
@@ -1544,7 +1558,6 @@ export interface Ebs {
1544
1558
  * <code>io1</code>: 100-64,000 IOPS</p>
1545
1559
  * </li>
1546
1560
  * </ul>
1547
- *
1548
1561
  * <p>For <code>io1</code> volumes, we guarantee 64,000 IOPS only for <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#ec2-nitro-instances">Instances
1549
1562
  * built on the Nitro System</a>. Other instance families guarantee performance up
1550
1563
  * to 32,000 IOPS. </p>
@@ -1566,7 +1579,7 @@ export interface Ebs {
1566
1579
  * <p>If you enable encryption by default, the EBS volumes that you create are always
1567
1580
  * encrypted, either using the Amazon Web Services managed KMS key or a customer-managed KMS key,
1568
1581
  * regardless of whether the snapshot was encrypted. </p>
1569
- * <p>For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-data-protection.html#encryption">Using Amazon Web Services KMS keys to encrypt Amazon EBS volumes</a> in the
1582
+ * <p>For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-data-protection.html#encryption">Use Amazon Web Services KMS keys to encrypt Amazon EBS volumes</a> in the
1570
1583
  * <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
1571
1584
  * </note>
1572
1585
  */
@@ -1587,30 +1600,33 @@ export declare namespace Ebs {
1587
1600
  */
1588
1601
  export interface BlockDeviceMapping {
1589
1602
  /**
1590
- * <p>The name of the virtual device (for example, <code>ephemeral0</code>).</p>
1591
- * <p>You can specify either <code>VirtualName</code> or <code>Ebs</code>, but not
1592
- * both.</p>
1603
+ * <p>The name of the instance store volume (virtual device) to attach to an instance at
1604
+ * launch. The name must be in the form ephemeral<i>X</i> where
1605
+ * <i>X</i> is a number starting from zero (0), for example,
1606
+ * <code>ephemeral0</code>.</p>
1593
1607
  */
1594
1608
  VirtualName?: string;
1595
1609
  /**
1596
- * <p>The device name exposed to the EC2 instance (for example, <code>/dev/sdh</code> or
1597
- * <code>xvdh</code>). For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/device_naming.html">Device Naming on Linux
1598
- * Instances</a> in the <i>Amazon EC2 User Guide for Linux Instances</i>.</p>
1610
+ * <p>The device name assigned to the volume (for example, <code>/dev/sdh</code> or
1611
+ * <code>xvdh</code>). For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/device_naming.html">Device naming on Linux
1612
+ * instances</a> in the <i>Amazon EC2 User Guide for Linux Instances</i>.</p>
1613
+ * <note>
1614
+ * <p>To define a block device mapping, set the device name and exactly one of the
1615
+ * following properties: <code>Ebs</code>, <code>NoDevice</code>, or
1616
+ * <code>VirtualName</code>.</p>
1617
+ * </note>
1599
1618
  */
1600
1619
  DeviceName: string | undefined;
1601
1620
  /**
1602
- * <p>Parameters used to automatically set up EBS volumes when an instance is
1603
- * launched.</p>
1604
- * <p>You can specify either <code>VirtualName</code> or <code>Ebs</code>, but not
1605
- * both.</p>
1621
+ * <p>Information to attach an EBS volume to an instance at launch.</p>
1606
1622
  */
1607
1623
  Ebs?: Ebs;
1608
1624
  /**
1609
- * <p>Setting this value to <code>true</code> suppresses the specified device included in
1610
- * the block device mapping of the AMI.</p>
1625
+ * <p>Setting this value to <code>true</code> prevents a volume that is included in the
1626
+ * block device mapping of the AMI from being mapped to the specified device name at
1627
+ * launch.</p>
1611
1628
  * <p>If <code>NoDevice</code> is <code>true</code> for the root device, instances might
1612
1629
  * fail the EC2 health check. In that case, Amazon EC2 Auto Scaling launches replacement instances.</p>
1613
- * <p>If you specify <code>NoDevice</code>, you cannot specify <code>Ebs</code>.</p>
1614
1630
  */
1615
1631
  NoDevice?: boolean;
1616
1632
  }
@@ -1693,30 +1709,27 @@ export interface CreateLaunchConfigurationType {
1693
1709
  LaunchConfigurationName: string | undefined;
1694
1710
  /**
1695
1711
  * <p>The ID of the Amazon Machine Image (AMI) that was assigned during registration. For
1696
- * more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html">Finding an AMI</a> in the
1712
+ * more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html">Finding a Linux AMI</a> in the
1697
1713
  * <i>Amazon EC2 User Guide for Linux Instances</i>.</p>
1698
- * <p>If you do not specify <code>InstanceId</code>, you must specify
1699
- * <code>ImageId</code>.</p>
1714
+ * <p>If you specify <code>InstanceId</code>, an <code>ImageId</code> is not
1715
+ * required.</p>
1700
1716
  */
1701
1717
  ImageId?: string;
1702
1718
  /**
1703
- * <p>The name of the key pair. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html">Amazon EC2 Key Pairs</a> in the
1704
- * <i>Amazon EC2 User Guide for Linux Instances</i>.</p>
1719
+ * <p>The name of the key pair. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html">Amazon EC2 key pairs and Linux
1720
+ * instances</a> in the <i>Amazon EC2 User Guide for Linux Instances</i>.</p>
1705
1721
  */
1706
1722
  KeyName?: string;
1707
1723
  /**
1708
- * <p>A list that contains the security groups to assign to the instances in the Auto Scaling
1709
- * group.</p>
1710
- * <p>[EC2-VPC] Specify the security group IDs. For more information, see <a href="https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_SecurityGroups.html">Security Groups for Your VPC</a> in the <i>Amazon Virtual Private Cloud
1711
- * User Guide</i>.</p>
1712
- * <p>[EC2-Classic] Specify either the security group names or the security group IDs. For
1713
- * more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-network-security.html">Amazon EC2 Security
1714
- * Groups</a> in the <i>Amazon EC2 User Guide for Linux Instances</i>.</p>
1724
+ * <p>A list that contains the security group IDs to assign to the instances in the Auto Scaling
1725
+ * group. For more information, see <a href="https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_SecurityGroups.html">Control traffic to
1726
+ * resources using security groups</a> in the <i>Amazon Virtual Private
1727
+ * Cloud User Guide</i>.</p>
1715
1728
  */
1716
1729
  SecurityGroups?: string[];
1717
1730
  /**
1718
1731
  * <p>
1719
- * <i>EC2-Classic retires on August 15, 2022. This parameter is not supported after
1732
+ * <i>EC2-Classic retires on August 15, 2022. This property is not supported after
1720
1733
  * that date.</i>
1721
1734
  * </p>
1722
1735
  * <p>The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances to. For more
@@ -1726,14 +1739,13 @@ export interface CreateLaunchConfigurationType {
1726
1739
  ClassicLinkVPCId?: string;
1727
1740
  /**
1728
1741
  * <p>
1729
- * <i>EC2-Classic retires on August 15, 2022. This parameter is not supported after
1742
+ * <i>EC2-Classic retires on August 15, 2022. This property is not supported after
1730
1743
  * that date.</i>
1731
1744
  * </p>
1732
- * <p>The IDs of one or more security groups for the specified ClassicLink-enabled VPC. For
1733
- * more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html">ClassicLink</a> in the
1734
- * <i>Amazon EC2 User Guide for Linux Instances</i>.</p>
1735
- * <p>If you specify the <code>ClassicLinkVPCId</code> parameter, you must specify this
1736
- * parameter.</p>
1745
+ * <p>The IDs of one or more security groups for the specified ClassicLink-enabled
1746
+ * VPC.</p>
1747
+ * <p>If you specify the <code>ClassicLinkVPCId</code> property, you must specify
1748
+ * <code>ClassicLinkVPCSecurityGroups</code>.</p>
1737
1749
  */
1738
1750
  ClassicLinkVPCSecurityGroups?: string[];
1739
1751
  /**
@@ -1753,30 +1765,41 @@ export interface CreateLaunchConfigurationType {
1753
1765
  * <p>For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-lc-with-instanceID.html">Creating a launch
1754
1766
  * configuration using an EC2 instance</a> in the
1755
1767
  * <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
1756
- * <p>If you do not specify <code>InstanceId</code>, you must specify both
1757
- * <code>ImageId</code> and <code>InstanceType</code>.</p>
1758
1768
  */
1759
1769
  InstanceId?: string;
1760
1770
  /**
1761
- * <p>Specifies the instance type of the EC2 instance.</p>
1762
- * <p>For information about available instance types, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#AvailableInstanceTypes">Available
1763
- * Instance Types</a> in the <i>Amazon EC2 User Guide for Linux Instances</i>.</p>
1764
- * <p>If you do not specify <code>InstanceId</code>, you must specify
1765
- * <code>InstanceType</code>.</p>
1771
+ * <p>Specifies the instance type of the EC2 instance. For information about available
1772
+ * instance types, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#AvailableInstanceTypes">Available
1773
+ * instance types</a> in the <i>Amazon EC2 User Guide for Linux Instances</i>.</p>
1774
+ * <p>If you specify <code>InstanceId</code>, an <code>InstanceType</code> is not
1775
+ * required.</p>
1766
1776
  */
1767
1777
  InstanceType?: string;
1768
1778
  /**
1769
1779
  * <p>The ID of the kernel associated with the AMI.</p>
1780
+ * <note>
1781
+ * <p>We recommend that you use PV-GRUB instead of kernels and RAM disks. For more
1782
+ * information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedKernels.html">User provided
1783
+ * kernels</a> in the <i>Amazon EC2 User Guide for Linux
1784
+ * Instances</i>.</p>
1785
+ * </note>
1770
1786
  */
1771
1787
  KernelId?: string;
1772
1788
  /**
1773
1789
  * <p>The ID of the RAM disk to select.</p>
1790
+ * <note>
1791
+ * <p>We recommend that you use PV-GRUB instead of kernels and RAM disks. For more
1792
+ * information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedKernels.html">User provided
1793
+ * kernels</a> in the <i>Amazon EC2 User Guide for Linux
1794
+ * Instances</i>.</p>
1795
+ * </note>
1774
1796
  */
1775
1797
  RamdiskId?: string;
1776
1798
  /**
1777
- * <p>A block device mapping, which specifies the block devices for the instance. You can
1778
- * specify virtual devices and EBS volumes. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-device-mapping-concepts.html">Block Device
1779
- * Mapping</a> in the <i>Amazon EC2 User Guide for Linux Instances</i>.</p>
1799
+ * <p>The block device mapping entries that define the block devices to attach to the
1800
+ * instances at launch. By default, the block devices specified in the block device mapping
1801
+ * for the AMI are used. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-device-mapping-concepts.html">Block device
1802
+ * mappings</a> in the <i>Amazon EC2 User Guide for Linux Instances</i>.</p>
1780
1803
  */
1781
1804
  BlockDeviceMappings?: BlockDeviceMapping[];
1782
1805
  /**
@@ -1795,8 +1818,10 @@ export interface CreateLaunchConfigurationType {
1795
1818
  /**
1796
1819
  * <p>The maximum hourly price to be paid for any Spot Instance launched to fulfill the
1797
1820
  * request. Spot Instances are launched when the price you specify exceeds the current Spot
1798
- * price. For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-launch-spot-instances.html">Requesting Spot
1799
- * Instances</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
1821
+ * price. For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/launch-template-spot-instances.html">Request Spot
1822
+ * Instances for fault-tolerant and flexible applications</a> in the
1823
+ * <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
1824
+ * <p>Valid Range: Minimum value of 0.001</p>
1800
1825
  * <note>
1801
1826
  * <p>When you change your maximum price by creating a new launch configuration, running
1802
1827
  * instances will continue to run as long as the maximum price for those running
@@ -1806,8 +1831,8 @@ export interface CreateLaunchConfigurationType {
1806
1831
  SpotPrice?: string;
1807
1832
  /**
1808
1833
  * <p>The name or the Amazon Resource Name (ARN) of the instance profile associated with the
1809
- * IAM role for the instance. The instance profile contains the IAM role.</p>
1810
- * <p>For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/us-iam-role.html">IAM role for applications that run
1834
+ * IAM role for the instance. The instance profile contains the IAM role. For more
1835
+ * information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/us-iam-role.html">IAM role for applications that run
1811
1836
  * on Amazon EC2 instances</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
1812
1837
  */
1813
1838
  IamInstanceProfile?: string;
@@ -1823,34 +1848,31 @@ export interface CreateLaunchConfigurationType {
1823
1848
  */
1824
1849
  EbsOptimized?: boolean;
1825
1850
  /**
1826
- * <p>For Auto Scaling groups that are running in a virtual private cloud (VPC), specifies whether
1827
- * to assign a public IP address to the group's instances. If you specify
1828
- * <code>true</code>, each instance in the Auto Scaling group receives a unique public IP address.
1829
- * For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html">Launching Auto Scaling instances in a
1851
+ * <p>Specifies whether to assign a public IPv4 address to the group's instances. If the
1852
+ * instance is launched into a default subnet, the default is to assign a public IPv4
1853
+ * address, unless you disabled the option to assign a public IPv4 address on the subnet.
1854
+ * If the instance is launched into a nondefault subnet, the default is not to assign a
1855
+ * public IPv4 address, unless you enabled the option to assign a public IPv4 address on
1856
+ * the subnet.</p>
1857
+ * <p>If you specify <code>true</code>, each instance in the Auto Scaling group receives a unique
1858
+ * public IPv4 address. For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html">Launching Auto Scaling instances in a
1830
1859
  * VPC</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
1831
- * <p>If you specify this parameter, you must specify at least one subnet for
1860
+ * <p>If you specify this property, you must specify at least one subnet for
1832
1861
  * <code>VPCZoneIdentifier</code> when you create your group.</p>
1833
- * <note>
1834
- * <p>If the instance is launched into a default subnet, the default is to assign a
1835
- * public IP address, unless you disabled the option to assign a public IP address on
1836
- * the subnet. If the instance is launched into a nondefault subnet, the default is not
1837
- * to assign a public IP address, unless you enabled the option to assign a public IP
1838
- * address on the subnet.</p>
1839
- * </note>
1840
1862
  */
1841
1863
  AssociatePublicIpAddress?: boolean;
1842
1864
  /**
1843
- * <p>The tenancy of the instance. An instance with <code>dedicated</code> tenancy runs on
1844
- * isolated, single-tenant hardware and can only be launched into a VPC.</p>
1845
- * <p>To launch dedicated instances into a shared tenancy VPC (a VPC with the instance
1846
- * placement tenancy attribute set to <code>default</code>), you must set the value of this
1847
- * parameter to <code>dedicated</code>.</p>
1848
- * <p>If you specify <code>PlacementTenancy</code>, you must specify at least one subnet for
1849
- * <code>VPCZoneIdentifier</code> when you create your group.</p>
1850
- * <p>For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-dedicated-instances.html">Configuring
1865
+ * <p>The tenancy of the instance, either <code>default</code> or <code>dedicated</code>. An
1866
+ * instance with <code>dedicated</code> tenancy runs on isolated, single-tenant hardware
1867
+ * and can only be launched into a VPC. To launch dedicated instances into a shared tenancy
1868
+ * VPC (a VPC with the instance placement tenancy attribute set to <code>default</code>),
1869
+ * you must set the value of this property to <code>dedicated</code>. For more information,
1870
+ * see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-dedicated-instances.html">Configuring
1851
1871
  * instance tenancy with Amazon EC2 Auto Scaling</a> in the
1852
1872
  * <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
1853
- * <p>Valid Values: <code>default</code> | <code>dedicated</code>
1873
+ * <p>If you specify <code>PlacementTenancy</code>, you must specify at least one subnet for
1874
+ * <code>VPCZoneIdentifier</code> when you create your group.</p>
1875
+ * <p>Valid values: <code>default</code> | <code>dedicated</code>
1854
1876
  * </p>
1855
1877
  */
1856
1878
  PlacementTenancy?: string;
@@ -1896,8 +1918,8 @@ export interface DeleteAutoScalingGroupType {
1896
1918
  AutoScalingGroupName: string | undefined;
1897
1919
  /**
1898
1920
  * <p>Specifies that the group is to be deleted along with all instances associated with the
1899
- * group, without waiting for all instances to be terminated. This parameter also deletes
1900
- * any outstanding lifecycle actions associated with the group.</p>
1921
+ * group, without waiting for all instances to be terminated. This action also deletes any
1922
+ * outstanding lifecycle actions associated with the group.</p>
1901
1923
  */
1902
1924
  ForceDelete?: boolean;
1903
1925
  }
@@ -2086,7 +2108,7 @@ export declare namespace DescribeAdjustmentTypesAnswer {
2086
2108
  * <p>If you specify multiple filters, the filters are automatically logically joined with
2087
2109
  * an <code>AND</code>, and the request returns only the results that match all of the
2088
2110
  * specified filters. </p>
2089
- * <p>For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html">Tagging Auto Scaling groups and
2111
+ * <p>For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-tagging.html">Tag Auto Scaling groups and
2090
2112
  * instances</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
2091
2113
  */
2092
2114
  export interface Filter {
@@ -2166,8 +2188,8 @@ export declare namespace Filter {
2166
2188
  export interface AutoScalingGroupNamesType {
2167
2189
  /**
2168
2190
  * <p>The names of the Auto Scaling groups. By default, you can only specify up to 50 names. You can
2169
- * optionally increase this limit using the <code>MaxRecords</code> parameter.</p>
2170
- * <p>If you omit this parameter, all Auto Scaling groups are described.</p>
2191
+ * optionally increase this limit using the <code>MaxRecords</code> property.</p>
2192
+ * <p>If you omit this property, all Auto Scaling groups are described.</p>
2171
2193
  */
2172
2194
  AutoScalingGroupNames?: string[];
2173
2195
  /**
@@ -2193,7 +2215,7 @@ export declare namespace AutoScalingGroupNamesType {
2193
2215
  const filterSensitiveLog: (obj: AutoScalingGroupNamesType) => any;
2194
2216
  }
2195
2217
  /**
2196
- * <p>Describes an enabled metric.</p>
2218
+ * <p>Describes an enabled Auto Scaling group metric.</p>
2197
2219
  */
2198
2220
  export interface EnabledMetric {
2199
2221
  /**
@@ -2300,6 +2322,7 @@ export interface EnabledMetric {
2300
2322
  * </p>
2301
2323
  * </li>
2302
2324
  * </ul>
2325
+ * <p>For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-cloudwatch-monitoring.html#as-group-metrics">Auto Scaling group metrics</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
2303
2326
  */
2304
2327
  Metric?: string;
2305
2328
  /**
@@ -2709,7 +2732,7 @@ export interface AutoScalingInstanceDetails {
2709
2732
  * <p>The lifecycle state for the instance. The <code>Quarantined</code> state is not used.
2710
2733
  * For information about lifecycle states, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/AutoScalingGroupLifecycle.html">Instance
2711
2734
  * lifecycle</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>. </p>
2712
- * <p>Valid Values: <code>Pending</code> | <code>Pending:Wait</code> |
2735
+ * <p>Valid values: <code>Pending</code> | <code>Pending:Wait</code> |
2713
2736
  * <code>Pending:Proceed</code> | <code>Quarantined</code> | <code>InService</code> |
2714
2737
  * <code>Terminating</code> | <code>Terminating:Wait</code> |
2715
2738
  * <code>Terminating:Proceed</code> | <code>Terminated</code> | <code>Detaching</code>
@@ -2776,8 +2799,8 @@ export declare namespace AutoScalingInstancesType {
2776
2799
  }
2777
2800
  export interface DescribeAutoScalingInstancesType {
2778
2801
  /**
2779
- * <p>The IDs of the instances. If you omit this parameter, all Auto Scaling instances are
2780
- * described. If you specify an ID that does not exist, it is ignored with no error.</p>
2802
+ * <p>The IDs of the instances. If you omit this property, all Auto Scaling instances are described.
2803
+ * If you specify an ID that does not exist, it is ignored with no error.</p>
2781
2804
  * <p>Array Members: Maximum number of 50 items.</p>
2782
2805
  */
2783
2806
  InstanceIds?: string[];
@@ -3066,7 +3089,7 @@ export declare namespace InstanceRefresh {
3066
3089
  }
3067
3090
  export interface DescribeInstanceRefreshesAnswer {
3068
3091
  /**
3069
- * <p>The instance refreshes for the specified group.</p>
3092
+ * <p>The instance refreshes for the specified group, sorted by creation timestamp in descending order.</p>
3070
3093
  */
3071
3094
  InstanceRefreshes?: InstanceRefresh[];
3072
3095
  /**
@@ -3111,7 +3134,7 @@ export declare namespace DescribeInstanceRefreshesType {
3111
3134
  }
3112
3135
  export interface LaunchConfigurationNamesType {
3113
3136
  /**
3114
- * <p>The launch configuration names. If you omit this parameter, all launch configurations
3137
+ * <p>The launch configuration names. If you omit this property, all launch configurations
3115
3138
  * are described.</p>
3116
3139
  * <p>Array Members: Maximum number of 50 items.</p>
3117
3140
  */
@@ -3147,7 +3170,7 @@ export interface LaunchConfiguration {
3147
3170
  LaunchConfigurationARN?: string;
3148
3171
  /**
3149
3172
  * <p>The ID of the Amazon Machine Image (AMI) to use to launch your EC2 instances. For more
3150
- * information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html">Finding an AMI</a> in the
3173
+ * information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html">Find a Linux AMI</a> in the
3151
3174
  * <i>Amazon EC2 User Guide for Linux Instances</i>.</p>
3152
3175
  */
3153
3176
  ImageId: string | undefined;
@@ -3166,7 +3189,7 @@ export interface LaunchConfiguration {
3166
3189
  SecurityGroups?: string[];
3167
3190
  /**
3168
3191
  * <p>
3169
- * <i>EC2-Classic retires on August 15, 2022. This parameter is not supported after
3192
+ * <i>EC2-Classic retires on August 15, 2022. This property is not supported after
3170
3193
  * that date.</i>
3171
3194
  * </p>
3172
3195
  * <p>The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances to.</p>
@@ -3174,7 +3197,7 @@ export interface LaunchConfiguration {
3174
3197
  ClassicLinkVPCId?: string;
3175
3198
  /**
3176
3199
  * <p>
3177
- * <i>EC2-Classic retires on August 15, 2022. This parameter is not supported after
3200
+ * <i>EC2-Classic retires on August 15, 2022. This property is not supported after
3178
3201
  * that date.</i>
3179
3202
  * </p>
3180
3203
  * <p>The IDs of one or more security groups for the VPC specified in
@@ -3190,9 +3213,9 @@ export interface LaunchConfiguration {
3190
3213
  */
3191
3214
  UserData?: string;
3192
3215
  /**
3193
- * <p>The instance type for the instances.</p>
3194
- * <p>For information about available instance types, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#AvailableInstanceTypes">Available
3195
- * Instance Types</a> in the <i>Amazon EC2 User Guide for Linux Instances</i>.</p>
3216
+ * <p>The instance type for the instances. For information about available instance types,
3217
+ * see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#AvailableInstanceTypes">Available
3218
+ * instance types</a> in the <i>Amazon EC2 User Guide for Linux Instances</i>.</p>
3196
3219
  */
3197
3220
  InstanceType: string | undefined;
3198
3221
  /**
@@ -3204,8 +3227,9 @@ export interface LaunchConfiguration {
3204
3227
  */
3205
3228
  RamdiskId?: string;
3206
3229
  /**
3207
- * <p>A block device mapping, which specifies the block devices for the instance. For more
3208
- * information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-device-mapping-concepts.html">Block Device
3230
+ * <p>The block device mapping entries that define the block devices to attach to the
3231
+ * instances at launch. By default, the block devices specified in the block device mapping
3232
+ * for the AMI are used. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-device-mapping-concepts.html">Block Device
3209
3233
  * Mapping</a> in the <i>Amazon EC2 User Guide for Linux Instances</i>.</p>
3210
3234
  */
3211
3235
  BlockDeviceMappings?: BlockDeviceMapping[];
@@ -3242,8 +3266,12 @@ export interface LaunchConfiguration {
3242
3266
  */
3243
3267
  EbsOptimized?: boolean;
3244
3268
  /**
3245
- * <p>For Auto Scaling groups that are running in a VPC, specifies whether to assign a public IP
3246
- * address to the group's instances. For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html">Launching Auto Scaling instances in a
3269
+ * <p>Specifies whether to assign a public IPv4 address to the group's instances. If the
3270
+ * instance is launched into a default subnet, the default is to assign a public IPv4
3271
+ * address, unless you disabled the option to assign a public IPv4 address on the subnet.
3272
+ * If the instance is launched into a nondefault subnet, the default is not to assign a
3273
+ * public IPv4 address, unless you enabled the option to assign a public IPv4 address on
3274
+ * the subnet. For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html">Launching Auto Scaling instances in a
3247
3275
  * VPC</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
3248
3276
  */
3249
3277
  AssociatePublicIpAddress?: boolean;
@@ -3303,22 +3331,15 @@ export interface LifecycleHook {
3303
3331
  */
3304
3332
  AutoScalingGroupName?: string;
3305
3333
  /**
3306
- * <p>The state of the EC2 instance to which to attach the lifecycle hook. The following are
3307
- * possible values:</p>
3308
- * <ul>
3309
- * <li>
3310
- * <p>autoscaling:EC2_INSTANCE_LAUNCHING</p>
3311
- * </li>
3312
- * <li>
3313
- * <p>autoscaling:EC2_INSTANCE_TERMINATING</p>
3314
- * </li>
3315
- * </ul>
3334
+ * <p>The lifecycle transition.</p>
3335
+ * <p>Valid values: <code>autoscaling:EC2_INSTANCE_LAUNCHING</code> |
3336
+ * <code>autoscaling:EC2_INSTANCE_TERMINATING</code>
3337
+ * </p>
3316
3338
  */
3317
3339
  LifecycleTransition?: string;
3318
3340
  /**
3319
- * <p>The ARN of the target that Amazon EC2 Auto Scaling sends notifications to when an instance is in the
3320
- * transition state for the lifecycle hook. The notification target can be either an SQS
3321
- * queue or an SNS topic.</p>
3341
+ * <p>The ARN of the target that Amazon EC2 Auto Scaling sends notifications to when an instance is in a
3342
+ * wait state for the lifecycle hook.</p>
3322
3343
  */
3323
3344
  NotificationTargetARN?: string;
3324
3345
  /**
@@ -3334,7 +3355,7 @@ export interface LifecycleHook {
3334
3355
  /**
3335
3356
  * <p>The maximum time, in seconds, that can elapse before the lifecycle hook times out. If
3336
3357
  * the lifecycle hook times out, Amazon EC2 Auto Scaling performs the action that you specified in the
3337
- * <code>DefaultResult</code> parameter.</p>
3358
+ * <code>DefaultResult</code> property.</p>
3338
3359
  */
3339
3360
  HeartbeatTimeout?: number;
3340
3361
  /**
@@ -3344,9 +3365,10 @@ export interface LifecycleHook {
3344
3365
  */
3345
3366
  GlobalTimeout?: number;
3346
3367
  /**
3347
- * <p>Defines the action the Auto Scaling group should take when the lifecycle hook timeout elapses
3348
- * or if an unexpected failure occurs. The possible values are <code>CONTINUE</code> and
3349
- * <code>ABANDON</code>.</p>
3368
+ * <p>The action the Auto Scaling group takes when the lifecycle hook timeout elapses or if an
3369
+ * unexpected failure occurs.</p>
3370
+ * <p>Valid values: <code>CONTINUE</code> | <code>ABANDON</code>
3371
+ * </p>
3350
3372
  */
3351
3373
  DefaultResult?: string;
3352
3374
  }
@@ -3374,7 +3396,7 @@ export interface DescribeLifecycleHooksType {
3374
3396
  */
3375
3397
  AutoScalingGroupName: string | undefined;
3376
3398
  /**
3377
- * <p>The names of one or more lifecycle hooks. If you omit this parameter, all lifecycle
3399
+ * <p>The names of one or more lifecycle hooks. If you omit this property, all lifecycle
3378
3400
  * hooks are described.</p>
3379
3401
  */
3380
3402
  LifecycleHookNames?: string[];
@@ -3707,7 +3729,7 @@ export declare namespace MetricCollectionType {
3707
3729
  }
3708
3730
  export interface DescribeMetricCollectionTypesAnswer {
3709
3731
  /**
3710
- * <p>One or more metrics.</p>
3732
+ * <p>The metrics.</p>
3711
3733
  */
3712
3734
  Metrics?: MetricCollectionType[];
3713
3735
  /**
@@ -3818,7 +3840,7 @@ export interface DescribePoliciesType {
3818
3840
  */
3819
3841
  AutoScalingGroupName?: string;
3820
3842
  /**
3821
- * <p>The names of one or more policies. If you omit this parameter, all policies are
3843
+ * <p>The names of one or more policies. If you omit this property, all policies are
3822
3844
  * described. If a group name is provided, the results are limited to that group. If you
3823
3845
  * specify an unknown policy name, it is ignored with no error.</p>
3824
3846
  * <p>Array Members: Maximum number of 50 items.</p>
@@ -4407,6 +4429,10 @@ export interface StepAdjustment {
4407
4429
  * <p>The amount by which to scale, based on the specified adjustment type. A positive value
4408
4430
  * adds to the current capacity while a negative number removes from the current
4409
4431
  * capacity.</p>
4432
+ * <p>The amount by which to scale. The adjustment is based on the value that you specified
4433
+ * in the <code>AdjustmentType</code> property (either an absolute number or a percentage).
4434
+ * A positive value adds to the current capacity and a negative number subtracts from the
4435
+ * current capacity. </p>
4410
4436
  */
4411
4437
  ScalingAdjustment: number | undefined;
4412
4438
  }
@@ -4429,7 +4455,7 @@ export declare enum MetricStatistic {
4429
4455
  * <p>To create your customized metric specification:</p>
4430
4456
  * <ul>
4431
4457
  * <li>
4432
- * <p>Add values for each required parameter from CloudWatch. You can use an existing
4458
+ * <p>Add values for each required property from CloudWatch. You can use an existing
4433
4459
  * metric, or a new metric that you create. To use your own metric, you must first
4434
4460
  * publish the metric to CloudWatch. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/publishingMetrics.html">Publish
4435
4461
  * custom metrics</a> in the <i>Amazon CloudWatch User
@@ -4723,7 +4749,7 @@ export declare namespace PoliciesType {
4723
4749
  }
4724
4750
  export interface DescribeScalingActivitiesType {
4725
4751
  /**
4726
- * <p>The activity IDs of the desired scaling activities. If you omit this parameter, all
4752
+ * <p>The activity IDs of the desired scaling activities. If you omit this property, all
4727
4753
  * activities for the past six weeks are described. If unknown activities are requested,
4728
4754
  * they are ignored with no error. If you specify an Auto Scaling group, the results are limited to
4729
4755
  * that group.</p>
@@ -4836,7 +4862,7 @@ export interface DescribeScheduledActionsType {
4836
4862
  */
4837
4863
  AutoScalingGroupName?: string;
4838
4864
  /**
4839
- * <p>The names of one or more scheduled actions. If you omit this parameter, all scheduled
4865
+ * <p>The names of one or more scheduled actions. If you omit this property, all scheduled
4840
4866
  * actions are described. If you specify an unknown scheduled action, it is ignored with no
4841
4867
  * error.</p>
4842
4868
  * <p>Array Members: Maximum number of 50 actions.</p>
@@ -4844,12 +4870,12 @@ export interface DescribeScheduledActionsType {
4844
4870
  ScheduledActionNames?: string[];
4845
4871
  /**
4846
4872
  * <p>The earliest scheduled start time to return. If scheduled action names are provided,
4847
- * this parameter is ignored.</p>
4873
+ * this property is ignored.</p>
4848
4874
  */
4849
4875
  StartTime?: Date;
4850
4876
  /**
4851
4877
  * <p>The latest scheduled start time to return. If scheduled action names are provided,
4852
- * this parameter is ignored.</p>
4878
+ * this property is ignored.</p>
4853
4879
  */
4854
4880
  EndTime?: Date;
4855
4881
  /**
@@ -4887,7 +4913,7 @@ export interface ScheduledUpdateGroupAction {
4887
4913
  */
4888
4914
  ScheduledActionARN?: string;
4889
4915
  /**
4890
- * <p>This parameter is no longer used.</p>
4916
+ * <p>This property is no longer used.</p>
4891
4917
  */
4892
4918
  Time?: Date;
4893
4919
  /**
@@ -5138,7 +5164,8 @@ export interface DisableMetricsCollectionQuery {
5138
5164
  */
5139
5165
  AutoScalingGroupName: string | undefined;
5140
5166
  /**
5141
- * <p>Specifies one or more of the following metrics:</p>
5167
+ * <p>Identifies the metrics to disable.</p>
5168
+ * <p>You can specify one or more of the following metrics:</p>
5142
5169
  * <ul>
5143
5170
  * <li>
5144
5171
  * <p>
@@ -5241,7 +5268,8 @@ export interface DisableMetricsCollectionQuery {
5241
5268
  * </p>
5242
5269
  * </li>
5243
5270
  * </ul>
5244
- * <p>If you omit this parameter, all metrics are disabled. </p>
5271
+ * <p>If you omit this property, all metrics are disabled.</p>
5272
+ * <p>For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-cloudwatch-monitoring.html#as-group-metrics">Auto Scaling group metrics</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
5245
5273
  */
5246
5274
  Metrics?: string[];
5247
5275
  }
@@ -5257,8 +5285,8 @@ export interface EnableMetricsCollectionQuery {
5257
5285
  */
5258
5286
  AutoScalingGroupName: string | undefined;
5259
5287
  /**
5260
- * <p>Specifies which group-level metrics to start collecting. You can specify one or more
5261
- * of the following metrics:</p>
5288
+ * <p>Identifies the metrics to enable.</p>
5289
+ * <p>You can specify one or more of the following metrics:</p>
5262
5290
  * <ul>
5263
5291
  * <li>
5264
5292
  * <p>
@@ -5300,9 +5328,6 @@ export interface EnableMetricsCollectionQuery {
5300
5328
  * <code>GroupTotalInstances</code>
5301
5329
  * </p>
5302
5330
  * </li>
5303
- * </ul>
5304
- * <p>The instance weighting feature supports the following additional metrics: </p>
5305
- * <ul>
5306
5331
  * <li>
5307
5332
  * <p>
5308
5333
  * <code>GroupInServiceCapacity</code>
@@ -5328,9 +5353,6 @@ export interface EnableMetricsCollectionQuery {
5328
5353
  * <code>GroupTotalCapacity</code>
5329
5354
  * </p>
5330
5355
  * </li>
5331
- * </ul>
5332
- * <p>The warm pools feature supports the following additional metrics: </p>
5333
- * <ul>
5334
5356
  * <li>
5335
5357
  * <p>
5336
5358
  * <code>WarmPoolDesiredCapacity</code>
@@ -5367,11 +5389,13 @@ export interface EnableMetricsCollectionQuery {
5367
5389
  * </p>
5368
5390
  * </li>
5369
5391
  * </ul>
5370
- * <p>If you omit this parameter, all metrics are enabled. </p>
5392
+ * <p>If you specify <code>Granularity</code> and don't specify any metrics, all metrics are
5393
+ * enabled.</p>
5394
+ * <p>For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-cloudwatch-monitoring.html#as-group-metrics">Auto Scaling group metrics</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
5371
5395
  */
5372
5396
  Metrics?: string[];
5373
5397
  /**
5374
- * <p>The granularity to associate with the metrics to collect. The only valid value is
5398
+ * <p>The frequency at which Amazon EC2 Auto Scaling sends aggregated data to CloudWatch. The only valid value is
5375
5399
  * <code>1Minute</code>.</p>
5376
5400
  */
5377
5401
  Granularity: string | undefined;
@@ -5599,14 +5623,16 @@ export interface PutLifecycleHookType {
5599
5623
  */
5600
5624
  AutoScalingGroupName: string | undefined;
5601
5625
  /**
5602
- * <p>The instance state to which you want to attach the lifecycle hook. The valid values
5603
- * are:</p>
5626
+ * <p>The lifecycle transition. For Auto Scaling groups, there are two major lifecycle
5627
+ * transitions.</p>
5604
5628
  * <ul>
5605
5629
  * <li>
5606
- * <p>autoscaling:EC2_INSTANCE_LAUNCHING</p>
5630
+ * <p>To create a lifecycle hook for scale-out events, specify
5631
+ * <code>autoscaling:EC2_INSTANCE_LAUNCHING</code>.</p>
5607
5632
  * </li>
5608
5633
  * <li>
5609
- * <p>autoscaling:EC2_INSTANCE_TERMINATING</p>
5634
+ * <p>To create a lifecycle hook for scale-in events, specify
5635
+ * <code>autoscaling:EC2_INSTANCE_TERMINATING</code>.</p>
5610
5636
  * </li>
5611
5637
  * </ul>
5612
5638
  * <p>Required for new lifecycle hooks, but optional when updating existing hooks.</p>
@@ -5620,9 +5646,9 @@ export interface PutLifecycleHookType {
5620
5646
  */
5621
5647
  RoleARN?: string;
5622
5648
  /**
5623
- * <p>The ARN of the notification target that Amazon EC2 Auto Scaling uses to notify you when an instance
5624
- * is in the transition state for the lifecycle hook. This target can be either an SQS
5625
- * queue or an SNS topic.</p>
5649
+ * <p>The Amazon Resource Name (ARN) of the notification target that Amazon EC2 Auto Scaling uses to notify
5650
+ * you when an instance is in a wait state for the lifecycle hook. You can specify either
5651
+ * an Amazon SNS topic or an Amazon SQS queue.</p>
5626
5652
  * <p>If you specify an empty string, this overrides the current ARN.</p>
5627
5653
  * <p>This operation uses the JSON format when sending notifications to an Amazon SQS queue, and
5628
5654
  * an email key-value pair format when sending notifications to an Amazon SNS topic.</p>
@@ -5640,15 +5666,13 @@ export interface PutLifecycleHookType {
5640
5666
  * <p>The maximum time, in seconds, that can elapse before the lifecycle hook times out. The
5641
5667
  * range is from <code>30</code> to <code>7200</code> seconds. The default value is
5642
5668
  * <code>3600</code> seconds (1 hour).</p>
5643
- * <p>If the lifecycle hook times out, Amazon EC2 Auto Scaling performs the action that you specified in
5644
- * the <code>DefaultResult</code> parameter. You can prevent the lifecycle hook from timing
5645
- * out by calling the <a>RecordLifecycleActionHeartbeat</a> API.</p>
5646
5669
  */
5647
5670
  HeartbeatTimeout?: number;
5648
5671
  /**
5649
- * <p>Defines the action the Auto Scaling group should take when the lifecycle hook timeout elapses
5650
- * or if an unexpected failure occurs. This parameter can be either <code>CONTINUE</code>
5651
- * or <code>ABANDON</code>. The default value is <code>ABANDON</code>.</p>
5672
+ * <p>The action the Auto Scaling group takes when the lifecycle hook timeout elapses or if an
5673
+ * unexpected failure occurs. The default value is <code>ABANDON</code>.</p>
5674
+ * <p>Valid values: <code>CONTINUE</code> | <code>ABANDON</code>
5675
+ * </p>
5652
5676
  */
5653
5677
  DefaultResult?: string;
5654
5678
  }
@@ -5841,7 +5865,7 @@ export interface PutScalingPolicyType {
5841
5865
  * </li>
5842
5866
  * </ul>
5843
5867
  * <p>If you specify <code>ALBRequestCountPerTarget</code> for the metric, you must specify
5844
- * the <code>ResourceLabel</code> parameter with the
5868
+ * the <code>ResourceLabel</code> property with the
5845
5869
  * <code>PredefinedMetricSpecification</code>.</p>
5846
5870
  * <p>For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_TargetTrackingConfiguration.html">TargetTrackingConfiguration</a> in the <i>Amazon EC2 Auto Scaling API
5847
5871
  * Reference</i>.</p>
@@ -5882,21 +5906,20 @@ export interface PutScheduledUpdateGroupActionType {
5882
5906
  */
5883
5907
  ScheduledActionName: string | undefined;
5884
5908
  /**
5885
- * <p>This parameter is no longer used.</p>
5909
+ * <p>This property is no longer used.</p>
5886
5910
  */
5887
5911
  Time?: Date;
5888
5912
  /**
5889
5913
  * <p>The date and time for this action to start, in YYYY-MM-DDThh:mm:ssZ format in UTC/GMT
5890
- * only and in quotes (for example, <code>"2019-06-01T00:00:00Z"</code>).</p>
5914
+ * only and in quotes (for example, <code>"2021-06-01T00:00:00Z"</code>).</p>
5891
5915
  * <p>If you specify <code>Recurrence</code> and <code>StartTime</code>, Amazon EC2 Auto Scaling performs
5892
5916
  * the action at this time, and then performs the action based on the specified
5893
5917
  * recurrence.</p>
5894
- * <p>If you try to schedule your action in the past, Amazon EC2 Auto Scaling returns an error
5895
- * message.</p>
5896
5918
  */
5897
5919
  StartTime?: Date;
5898
5920
  /**
5899
- * <p>The date and time for the recurring schedule to end, in UTC.</p>
5921
+ * <p>The date and time for the recurring schedule to end, in UTC. For example,
5922
+ * <code>"2021-06-01T00:00:00Z"</code>.</p>
5900
5923
  */
5901
5924
  EndTime?: Date;
5902
5925
  /**
@@ -5922,6 +5945,10 @@ export interface PutScheduledUpdateGroupActionType {
5922
5945
  * <p>The desired capacity is the initial capacity of the Auto Scaling group after the scheduled
5923
5946
  * action runs and the capacity it attempts to maintain. It can scale beyond this capacity
5924
5947
  * if you add more scaling conditions. </p>
5948
+ * <note>
5949
+ * <p>You must specify at least one of the following properties: <code>MaxSize</code>,
5950
+ * <code>MinSize</code>, or <code>DesiredCapacity</code>. </p>
5951
+ * </note>
5925
5952
  */
5926
5953
  DesiredCapacity?: number;
5927
5954
  /**
@@ -6085,7 +6112,7 @@ export interface ScalingProcessQuery {
6085
6112
  * </p>
6086
6113
  * </li>
6087
6114
  * </ul>
6088
- * <p>If you omit this parameter, all processes are specified.</p>
6115
+ * <p>If you omit this property, all processes are specified.</p>
6089
6116
  */
6090
6117
  ScalingProcesses?: string[];
6091
6118
  }
@@ -6350,13 +6377,20 @@ export interface UpdateAutoScalingGroupType {
6350
6377
  /**
6351
6378
  * <p>A comma-separated list of subnet IDs for a virtual private cloud (VPC). If you specify
6352
6379
  * <code>VPCZoneIdentifier</code> with <code>AvailabilityZones</code>, the subnets that
6353
- * you specify for this parameter must reside in those Availability Zones.</p>
6380
+ * you specify must reside in those Availability Zones.</p>
6354
6381
  */
6355
6382
  VPCZoneIdentifier?: string;
6356
6383
  /**
6357
6384
  * <p>A policy or a list of policies that are used to select the instances to terminate. The
6358
- * policies are executed in the order that you list them. For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html">Controlling which Auto Scaling instances terminate during scale in</a> in the
6359
- * <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
6385
+ * policies are executed in the order that you list them. For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-termination-policies.html">Work with
6386
+ * Amazon EC2 Auto Scaling termination policies</a> in the
6387
+ * <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
6388
+ * <p>Valid values: <code>Default</code> | <code>AllocationStrategy</code> |
6389
+ * <code>ClosestToNextInstanceHour</code> | <code>NewestInstance</code> |
6390
+ * <code>OldestInstance</code> | <code>OldestLaunchConfiguration</code> |
6391
+ * <code>OldestLaunchTemplate</code> |
6392
+ * <code>arn:aws:lambda:region:account-id:function:my-function:my-alias</code>
6393
+ * </p>
6360
6394
  */
6361
6395
  TerminationPolicies?: string[];
6362
6396
  /**
@@ -6383,8 +6417,8 @@ export interface UpdateAutoScalingGroupType {
6383
6417
  */
6384
6418
  MaxInstanceLifetime?: number;
6385
6419
  /**
6386
- * <p>Enables or disables Capacity Rebalancing. For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-capacity-rebalancing.html">Amazon EC2 Auto Scaling
6387
- * Capacity Rebalancing</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
6420
+ * <p>Enables or disables Capacity Rebalancing. For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-capacity-rebalancing.html">Use Capacity
6421
+ * Rebalancing to handle Amazon EC2 Spot Interruptions</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
6388
6422
  */
6389
6423
  CapacityRebalance?: boolean;
6390
6424
  /**