aws-sdk-autoscaling 1.79.0 → 1.80.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -534,9 +534,9 @@ module Aws::AutoScaling
534
534
  # @!attribute [rw] auto_scaling_group_names
535
535
  # The names of the Auto Scaling groups. By default, you can only
536
536
  # specify up to 50 names. You can optionally increase this limit using
537
- # the `MaxRecords` parameter.
537
+ # the `MaxRecords` property.
538
538
  #
539
- # If you omit this parameter, all Auto Scaling groups are described.
539
+ # If you omit this property, all Auto Scaling groups are described.
540
540
  # @return [Array<String>]
541
541
  #
542
542
  # @!attribute [rw] next_token
@@ -608,7 +608,7 @@ module Aws::AutoScaling
608
608
  # used. For information about lifecycle states, see [Instance
609
609
  # lifecycle][1] in the *Amazon EC2 Auto Scaling User Guide*.
610
610
  #
611
- # Valid Values: `Pending` \| `Pending:Wait` \| `Pending:Proceed` \|
611
+ # Valid values: `Pending` \| `Pending:Wait` \| `Pending:Proceed` \|
612
612
  # `Quarantined` \| `InService` \| `Terminating` \| `Terminating:Wait`
613
613
  # \| `Terminating:Proceed` \| `Terminated` \| `Detaching` \|
614
614
  # `Detached` \| `EnteringStandby` \| `Standby` \| `Warmed:Pending` \|
@@ -827,15 +827,22 @@ module Aws::AutoScaling
827
827
  # }
828
828
  #
829
829
  # @!attribute [rw] virtual_name
830
- # The name of the virtual device (for example, `ephemeral0`).
831
- #
832
- # You can specify either `VirtualName` or `Ebs`, but not both.
830
+ # The name of the instance store volume (virtual device) to attach to
831
+ # an instance at launch. The name must be in the form ephemeral*X*
832
+ # where *X* is a number starting from zero (0), for example,
833
+ # `ephemeral0`.
833
834
  # @return [String]
834
835
  #
835
836
  # @!attribute [rw] device_name
836
- # The device name exposed to the EC2 instance (for example, `/dev/sdh`
837
- # or `xvdh`). For more information, see [Device Naming on Linux
838
- # Instances][1] in the *Amazon EC2 User Guide for Linux Instances*.
837
+ # The device name assigned to the volume (for example, `/dev/sdh` or
838
+ # `xvdh`). For more information, see [Device naming on Linux
839
+ # instances][1] in the *Amazon EC2 User Guide for Linux Instances*.
840
+ #
841
+ # <note markdown="1"> To define a block device mapping, set the device name and exactly
842
+ # one of the following properties: `Ebs`, `NoDevice`, or
843
+ # `VirtualName`.
844
+ #
845
+ # </note>
839
846
  #
840
847
  #
841
848
  #
@@ -843,21 +850,17 @@ module Aws::AutoScaling
843
850
  # @return [String]
844
851
  #
845
852
  # @!attribute [rw] ebs
846
- # Parameters used to automatically set up EBS volumes when an instance
847
- # is launched.
848
- #
849
- # You can specify either `VirtualName` or `Ebs`, but not both.
853
+ # Information to attach an EBS volume to an instance at launch.
850
854
  # @return [Types::Ebs]
851
855
  #
852
856
  # @!attribute [rw] no_device
853
- # Setting this value to `true` suppresses the specified device
854
- # included in the block device mapping of the AMI.
857
+ # Setting this value to `true` prevents a volume that is included in
858
+ # the block device mapping of the AMI from being mapped to the
859
+ # specified device name at launch.
855
860
  #
856
861
  # If `NoDevice` is `true` for the root device, instances might fail
857
862
  # the EC2 health check. In that case, Amazon EC2 Auto Scaling launches
858
863
  # replacement instances.
859
- #
860
- # If you specify `NoDevice`, you cannot specify `Ebs`.
861
864
  # @return [Boolean]
862
865
  #
863
866
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/BlockDeviceMapping AWS API Documentation
@@ -955,8 +958,8 @@ module Aws::AutoScaling
955
958
  # @return [String]
956
959
  #
957
960
  # @!attribute [rw] lifecycle_action_result
958
- # The action for the group to take. This parameter can be either
959
- # `CONTINUE` or `ABANDON`.
961
+ # The action for the group to take. You can specify either `CONTINUE`
962
+ # or `ABANDON`.
960
963
  # @return [String]
961
964
  #
962
965
  # @!attribute [rw] instance_id
@@ -1117,8 +1120,8 @@ module Aws::AutoScaling
1117
1120
  # @return [String]
1118
1121
  #
1119
1122
  # @!attribute [rw] launch_template
1120
- # Parameters used to specify the launch template and version to use to
1121
- # launch instances.
1123
+ # Information used to specify the launch template and version to use
1124
+ # to launch instances.
1122
1125
  #
1123
1126
  # Conditional: You must specify either a launch template
1124
1127
  # (`LaunchTemplate` or `MixedInstancesPolicy`) or a launch
@@ -1207,26 +1210,27 @@ module Aws::AutoScaling
1207
1210
  #
1208
1211
  # @!attribute [rw] availability_zones
1209
1212
  # A list of Availability Zones where instances in the Auto Scaling
1210
- # group can be created. This parameter is optional if you specify one
1211
- # or more subnets for `VPCZoneIdentifier`.
1212
- #
1213
- # Conditional: If your account supports EC2-Classic and VPC, this
1214
- # parameter is required to launch instances into EC2-Classic.
1213
+ # group can be created. Used for launching into the default VPC subnet
1214
+ # in each Availability Zone when not using the `VPCZoneIdentifier`
1215
+ # property, or for attaching a network interface when an existing
1216
+ # network interface ID is specified in a launch template.
1215
1217
  # @return [Array<String>]
1216
1218
  #
1217
1219
  # @!attribute [rw] load_balancer_names
1218
1220
  # A list of Classic Load Balancers associated with this Auto Scaling
1219
1221
  # group. For Application Load Balancers, Network Load Balancers, and
1220
- # Gateway Load Balancers, specify the `TargetGroupARNs` property
1222
+ # Gateway Load Balancer, specify the `TargetGroupARNs` property
1221
1223
  # instead.
1222
1224
  # @return [Array<String>]
1223
1225
  #
1224
1226
  # @!attribute [rw] target_group_arns
1225
1227
  # The Amazon Resource Names (ARN) of the target groups to associate
1226
- # with the Auto Scaling group. Instances are registered as targets in
1227
- # a target group, and traffic is routed to the target group. For more
1228
- # information, see [Elastic Load Balancing and Amazon EC2 Auto
1229
- # Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
1228
+ # with the Auto Scaling group. Instances are registered as targets
1229
+ # with the target groups. The target groups receive incoming traffic
1230
+ # and route requests to one or more registered targets. For more
1231
+ # information, see [Use Elastic Load Balancing to distribute traffic
1232
+ # across the instances in your Auto Scaling group][1] in the *Amazon
1233
+ # EC2 Auto Scaling User Guide*.
1230
1234
  #
1231
1235
  #
1232
1236
  #
@@ -1248,8 +1252,6 @@ module Aws::AutoScaling
1248
1252
  # @return [String]
1249
1253
  #
1250
1254
  # @!attribute [rw] health_check_grace_period
1251
- # **
1252
- #
1253
1255
  # The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
1254
1256
  # before checking the health status of an EC2 instance that has come
1255
1257
  # into service and marking it unhealthy due to a failed Elastic Load
@@ -1266,9 +1268,9 @@ module Aws::AutoScaling
1266
1268
  # @return [Integer]
1267
1269
  #
1268
1270
  # @!attribute [rw] placement_group
1269
- # The name of an existing placement group into which to launch your
1270
- # instances. For more information, see [Placement groups][1] in the
1271
- # *Amazon EC2 User Guide for Linux Instances*.
1271
+ # The name of the placement group into which to launch your instances.
1272
+ # For more information, see [Placement groups][1] in the *Amazon EC2
1273
+ # User Guide for Linux Instances*.
1272
1274
  #
1273
1275
  # <note markdown="1"> A *cluster* placement group is a logical grouping of instances
1274
1276
  # within a single Availability Zone. You cannot specify multiple
@@ -1285,23 +1287,24 @@ module Aws::AutoScaling
1285
1287
  # A comma-separated list of subnet IDs for a virtual private cloud
1286
1288
  # (VPC) where instances in the Auto Scaling group can be created. If
1287
1289
  # you specify `VPCZoneIdentifier` with `AvailabilityZones`, the
1288
- # subnets that you specify for this parameter must reside in those
1289
- # Availability Zones.
1290
- #
1291
- # Conditional: If your account supports EC2-Classic and VPC, this
1292
- # parameter is required to launch instances into a VPC.
1290
+ # subnets that you specify must reside in those Availability Zones.
1293
1291
  # @return [String]
1294
1292
  #
1295
1293
  # @!attribute [rw] termination_policies
1296
1294
  # A policy or a list of policies that are used to select the instance
1297
1295
  # to terminate. These policies are executed in the order that you list
1298
- # them. For more information, see [Controlling which Auto Scaling
1299
- # instances terminate during scale in][1] in the *Amazon EC2 Auto
1300
- # Scaling User Guide*.
1296
+ # them. For more information, see [Work with Amazon EC2 Auto Scaling
1297
+ # termination policies][1] in the *Amazon EC2 Auto Scaling User
1298
+ # Guide*.
1301
1299
  #
1300
+ # Valid values: `Default` \| `AllocationStrategy` \|
1301
+ # `ClosestToNextInstanceHour` \| `NewestInstance` \| `OldestInstance`
1302
+ # \| `OldestLaunchConfiguration` \| `OldestLaunchTemplate` \|
1303
+ # `arn:aws:lambda:region:account-id:function:my-function:my-alias`
1302
1304
  #
1303
1305
  #
1304
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html
1306
+ #
1307
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-termination-policies.html
1305
1308
  # @return [Array<String>]
1306
1309
  #
1307
1310
  # @!attribute [rw] new_instances_protected_from_scale_in
@@ -1322,9 +1325,9 @@ module Aws::AutoScaling
1322
1325
  # Rebalancing, Amazon EC2 Auto Scaling attempts to launch a Spot
1323
1326
  # Instance whenever Amazon EC2 notifies that a Spot Instance is at an
1324
1327
  # elevated risk of interruption. After launching a new instance, it
1325
- # then terminates an old instance. For more information, see [Amazon
1326
- # EC2 Auto Scaling Capacity Rebalancing][1] in the *Amazon EC2 Auto
1327
- # Scaling User Guide*.
1328
+ # then terminates an old instance. For more information, see [Use
1329
+ # Capacity Rebalancing to handle Amazon EC2 Spot Interruptions][1] in
1330
+ # the in the *Amazon EC2 Auto Scaling User Guide*.
1328
1331
  #
1329
1332
  #
1330
1333
  #
@@ -1332,9 +1335,8 @@ module Aws::AutoScaling
1332
1335
  # @return [Boolean]
1333
1336
  #
1334
1337
  # @!attribute [rw] lifecycle_hook_specification_list
1335
- # One or more lifecycle hooks for the group, which specify actions to
1336
- # perform when Amazon EC2 Auto Scaling launches or terminates
1337
- # instances.
1338
+ # One or more lifecycle hooks to add to the Auto Scaling group before
1339
+ # instances are launched.
1338
1340
  # @return [Array<Types::LifecycleHookSpecification>]
1339
1341
  #
1340
1342
  # @!attribute [rw] tags
@@ -1345,22 +1347,22 @@ module Aws::AutoScaling
1345
1347
  # template specifies an instance tag with a key that is also specified
1346
1348
  # for the Auto Scaling group, Amazon EC2 Auto Scaling overrides the
1347
1349
  # value of that instance tag with the value specified by the Auto
1348
- # Scaling group. For more information, see [Tagging Auto Scaling
1349
- # groups and instances][1] in the *Amazon EC2 Auto Scaling User
1350
- # Guide*.
1350
+ # Scaling group. For more information, see [Tag Auto Scaling groups
1351
+ # and instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
1351
1352
  #
1352
1353
  #
1353
1354
  #
1354
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html
1355
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-tagging.html
1355
1356
  # @return [Array<Types::Tag>]
1356
1357
  #
1357
1358
  # @!attribute [rw] service_linked_role_arn
1358
1359
  # The Amazon Resource Name (ARN) of the service-linked role that the
1359
- # Auto Scaling group uses to call other Amazon Web Services on your
1360
- # behalf. By default, Amazon EC2 Auto Scaling uses a service-linked
1361
- # role named `AWSServiceRoleForAutoScaling`, which it creates if it
1362
- # does not exist. For more information, see [Service-linked roles][1]
1363
- # in the *Amazon EC2 Auto Scaling User Guide*.
1360
+ # Auto Scaling group uses to call other Amazon Web Services service on
1361
+ # your behalf. By default, Amazon EC2 Auto Scaling uses a
1362
+ # service-linked role named `AWSServiceRoleForAutoScaling`, which it
1363
+ # creates if it does not exist. For more information, see
1364
+ # [Service-linked roles][1] in the *Amazon EC2 Auto Scaling User
1365
+ # Guide*.
1364
1366
  #
1365
1367
  #
1366
1368
  #
@@ -1516,10 +1518,10 @@ module Aws::AutoScaling
1516
1518
  #
1517
1519
  # @!attribute [rw] image_id
1518
1520
  # The ID of the Amazon Machine Image (AMI) that was assigned during
1519
- # registration. For more information, see [Finding an AMI][1] in the
1520
- # *Amazon EC2 User Guide for Linux Instances*.
1521
+ # registration. For more information, see [Finding a Linux AMI][1] in
1522
+ # the *Amazon EC2 User Guide for Linux Instances*.
1521
1523
  #
1522
- # If you do not specify `InstanceId`, you must specify `ImageId`.
1524
+ # If you specify `InstanceId`, an `ImageId` is not required.
1523
1525
  #
1524
1526
  #
1525
1527
  #
@@ -1527,8 +1529,9 @@ module Aws::AutoScaling
1527
1529
  # @return [String]
1528
1530
  #
1529
1531
  # @!attribute [rw] key_name
1530
- # The name of the key pair. For more information, see [Amazon EC2 Key
1531
- # Pairs][1] in the *Amazon EC2 User Guide for Linux Instances*.
1532
+ # The name of the key pair. For more information, see [Amazon EC2 key
1533
+ # pairs and Linux instances][1] in the *Amazon EC2 User Guide for
1534
+ # Linux Instances*.
1532
1535
  #
1533
1536
  #
1534
1537
  #
@@ -1536,25 +1539,18 @@ module Aws::AutoScaling
1536
1539
  # @return [String]
1537
1540
  #
1538
1541
  # @!attribute [rw] security_groups
1539
- # A list that contains the security groups to assign to the instances
1540
- # in the Auto Scaling group.
1541
- #
1542
- # \[EC2-VPC\] Specify the security group IDs. For more information,
1543
- # see [Security Groups for Your VPC][1] in the *Amazon Virtual Private
1544
- # Cloud User Guide*.
1545
- #
1546
- # \[EC2-Classic\] Specify either the security group names or the
1547
- # security group IDs. For more information, see [Amazon EC2 Security
1548
- # Groups][2] in the *Amazon EC2 User Guide for Linux Instances*.
1542
+ # A list that contains the security group IDs to assign to the
1543
+ # instances in the Auto Scaling group. For more information, see
1544
+ # [Control traffic to resources using security groups][1] in the
1545
+ # *Amazon Virtual Private Cloud User Guide*.
1549
1546
  #
1550
1547
  #
1551
1548
  #
1552
1549
  # [1]: https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_SecurityGroups.html
1553
- # [2]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-network-security.html
1554
1550
  # @return [Array<String>]
1555
1551
  #
1556
1552
  # @!attribute [rw] classic_link_vpc_id
1557
- # *EC2-Classic retires on August 15, 2022. This parameter is not
1553
+ # *EC2-Classic retires on August 15, 2022. This property is not
1558
1554
  # supported after that date.*
1559
1555
  #
1560
1556
  # The ID of a ClassicLink-enabled VPC to link your EC2-Classic
@@ -1567,19 +1563,14 @@ module Aws::AutoScaling
1567
1563
  # @return [String]
1568
1564
  #
1569
1565
  # @!attribute [rw] classic_link_vpc_security_groups
1570
- # *EC2-Classic retires on August 15, 2022. This parameter is not
1566
+ # *EC2-Classic retires on August 15, 2022. This property is not
1571
1567
  # supported after that date.*
1572
1568
  #
1573
1569
  # The IDs of one or more security groups for the specified
1574
- # ClassicLink-enabled VPC. For more information, see [ClassicLink][1]
1575
- # in the *Amazon EC2 User Guide for Linux Instances*.
1576
- #
1577
- # If you specify the `ClassicLinkVPCId` parameter, you must specify
1578
- # this parameter.
1579
- #
1580
- #
1570
+ # ClassicLink-enabled VPC.
1581
1571
  #
1582
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html
1572
+ # If you specify the `ClassicLinkVPCId` property, you must specify
1573
+ # `ClassicLinkVPCSecurityGroups`.
1583
1574
  # @return [Array<String>]
1584
1575
  #
1585
1576
  # @!attribute [rw] user_data
@@ -1608,22 +1599,17 @@ module Aws::AutoScaling
1608
1599
  # For more information, see [Creating a launch configuration using an
1609
1600
  # EC2 instance][1] in the *Amazon EC2 Auto Scaling User Guide*.
1610
1601
  #
1611
- # If you do not specify `InstanceId`, you must specify both `ImageId`
1612
- # and `InstanceType`.
1613
- #
1614
1602
  #
1615
1603
  #
1616
1604
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-lc-with-instanceID.html
1617
1605
  # @return [String]
1618
1606
  #
1619
1607
  # @!attribute [rw] instance_type
1620
- # Specifies the instance type of the EC2 instance.
1621
- #
1622
- # For information about available instance types, see [Available
1623
- # Instance Types][1] in the *Amazon EC2 User Guide for Linux
1624
- # Instances*.
1608
+ # Specifies the instance type of the EC2 instance. For information
1609
+ # about available instance types, see [Available instance types][1] in
1610
+ # the *Amazon EC2 User Guide for Linux Instances*.
1625
1611
  #
1626
- # If you do not specify `InstanceId`, you must specify `InstanceType`.
1612
+ # If you specify `InstanceId`, an `InstanceType` is not required.
1627
1613
  #
1628
1614
  #
1629
1615
  #
@@ -1632,16 +1618,37 @@ module Aws::AutoScaling
1632
1618
  #
1633
1619
  # @!attribute [rw] kernel_id
1634
1620
  # The ID of the kernel associated with the AMI.
1621
+ #
1622
+ # <note markdown="1"> We recommend that you use PV-GRUB instead of kernels and RAM disks.
1623
+ # For more information, see [User provided kernels][1] in the *Amazon
1624
+ # EC2 User Guide for Linux Instances*.
1625
+ #
1626
+ # </note>
1627
+ #
1628
+ #
1629
+ #
1630
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedKernels.html
1635
1631
  # @return [String]
1636
1632
  #
1637
1633
  # @!attribute [rw] ramdisk_id
1638
1634
  # The ID of the RAM disk to select.
1635
+ #
1636
+ # <note markdown="1"> We recommend that you use PV-GRUB instead of kernels and RAM disks.
1637
+ # For more information, see [User provided kernels][1] in the *Amazon
1638
+ # EC2 User Guide for Linux Instances*.
1639
+ #
1640
+ # </note>
1641
+ #
1642
+ #
1643
+ #
1644
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedKernels.html
1639
1645
  # @return [String]
1640
1646
  #
1641
1647
  # @!attribute [rw] block_device_mappings
1642
- # A block device mapping, which specifies the block devices for the
1643
- # instance. You can specify virtual devices and EBS volumes. For more
1644
- # information, see [Block Device Mapping][1] in the *Amazon EC2 User
1648
+ # The block device mapping entries that define the block devices to
1649
+ # attach to the instances at launch. By default, the block devices
1650
+ # specified in the block device mapping for the AMI are used. For more
1651
+ # information, see [Block device mappings][1] in the *Amazon EC2 User
1645
1652
  # Guide for Linux Instances*.
1646
1653
  #
1647
1654
  #
@@ -1670,8 +1677,10 @@ module Aws::AutoScaling
1670
1677
  # The maximum hourly price to be paid for any Spot Instance launched
1671
1678
  # to fulfill the request. Spot Instances are launched when the price
1672
1679
  # you specify exceeds the current Spot price. For more information,
1673
- # see [Requesting Spot Instances][1] in the *Amazon EC2 Auto Scaling
1674
- # User Guide*.
1680
+ # see [Request Spot Instances for fault-tolerant and flexible
1681
+ # applications][1] in the *Amazon EC2 Auto Scaling User Guide*.
1682
+ #
1683
+ # Valid Range: Minimum value of 0.001
1675
1684
  #
1676
1685
  # <note markdown="1"> When you change your maximum price by creating a new launch
1677
1686
  # configuration, running instances will continue to run as long as the
@@ -1682,17 +1691,15 @@ module Aws::AutoScaling
1682
1691
  #
1683
1692
  #
1684
1693
  #
1685
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-launch-spot-instances.html
1694
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/launch-template-spot-instances.html
1686
1695
  # @return [String]
1687
1696
  #
1688
1697
  # @!attribute [rw] iam_instance_profile
1689
1698
  # The name or the Amazon Resource Name (ARN) of the instance profile
1690
1699
  # associated with the IAM role for the instance. The instance profile
1691
- # contains the IAM role.
1692
- #
1693
- # For more information, see [IAM role for applications that run on
1694
- # Amazon EC2 instances][1] in the *Amazon EC2 Auto Scaling User
1695
- # Guide*.
1700
+ # contains the IAM role. For more information, see [IAM role for
1701
+ # applications that run on Amazon EC2 instances][1] in the *Amazon EC2
1702
+ # Auto Scaling User Guide*.
1696
1703
  #
1697
1704
  #
1698
1705
  #
@@ -1718,46 +1725,41 @@ module Aws::AutoScaling
1718
1725
  # @return [Boolean]
1719
1726
  #
1720
1727
  # @!attribute [rw] associate_public_ip_address
1721
- # For Auto Scaling groups that are running in a virtual private cloud
1722
- # (VPC), specifies whether to assign a public IP address to the
1723
- # group's instances. If you specify `true`, each instance in the Auto
1724
- # Scaling group receives a unique public IP address. For more
1725
- # information, see [Launching Auto Scaling instances in a VPC][1] in
1726
- # the *Amazon EC2 Auto Scaling User Guide*.
1728
+ # Specifies whether to assign a public IPv4 address to the group's
1729
+ # instances. If the instance is launched into a default subnet, the
1730
+ # default is to assign a public IPv4 address, unless you disabled the
1731
+ # option to assign a public IPv4 address on the subnet. If the
1732
+ # instance is launched into a nondefault subnet, the default is not to
1733
+ # assign a public IPv4 address, unless you enabled the option to
1734
+ # assign a public IPv4 address on the subnet.
1735
+ #
1736
+ # If you specify `true`, each instance in the Auto Scaling group
1737
+ # receives a unique public IPv4 address. For more information, see
1738
+ # [Launching Auto Scaling instances in a VPC][1] in the *Amazon EC2
1739
+ # Auto Scaling User Guide*.
1727
1740
  #
1728
- # If you specify this parameter, you must specify at least one subnet
1741
+ # If you specify this property, you must specify at least one subnet
1729
1742
  # for `VPCZoneIdentifier` when you create your group.
1730
1743
  #
1731
- # <note markdown="1"> If the instance is launched into a default subnet, the default is to
1732
- # assign a public IP address, unless you disabled the option to assign
1733
- # a public IP address on the subnet. If the instance is launched into
1734
- # a nondefault subnet, the default is not to assign a public IP
1735
- # address, unless you enabled the option to assign a public IP address
1736
- # on the subnet.
1737
- #
1738
- # </note>
1739
- #
1740
1744
  #
1741
1745
  #
1742
1746
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html
1743
1747
  # @return [Boolean]
1744
1748
  #
1745
1749
  # @!attribute [rw] placement_tenancy
1746
- # The tenancy of the instance. An instance with `dedicated` tenancy
1747
- # runs on isolated, single-tenant hardware and can only be launched
1748
- # into a VPC.
1749
- #
1750
- # To launch dedicated instances into a shared tenancy VPC (a VPC with
1751
- # the instance placement tenancy attribute set to `default`), you must
1752
- # set the value of this parameter to `dedicated`.
1750
+ # The tenancy of the instance, either `default` or `dedicated`. An
1751
+ # instance with `dedicated` tenancy runs on isolated, single-tenant
1752
+ # hardware and can only be launched into a VPC. To launch dedicated
1753
+ # instances into a shared tenancy VPC (a VPC with the instance
1754
+ # placement tenancy attribute set to `default`), you must set the
1755
+ # value of this property to `dedicated`. For more information, see
1756
+ # [Configuring instance tenancy with Amazon EC2 Auto Scaling][1] in
1757
+ # the *Amazon EC2 Auto Scaling User Guide*.
1753
1758
  #
1754
1759
  # If you specify `PlacementTenancy`, you must specify at least one
1755
1760
  # subnet for `VPCZoneIdentifier` when you create your group.
1756
1761
  #
1757
- # For more information, see [Configuring instance tenancy with Amazon
1758
- # EC2 Auto Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
1759
- #
1760
- # Valid Values: `default` \| `dedicated`
1762
+ # Valid values: `default` \| `dedicated`
1761
1763
  #
1762
1764
  #
1763
1765
  #
@@ -1832,7 +1834,7 @@ module Aws::AutoScaling
1832
1834
  #
1833
1835
  # To create your customized metric specification:
1834
1836
  #
1835
- # * Add values for each required parameter from CloudWatch. You can use
1837
+ # * Add values for each required property from CloudWatch. You can use
1836
1838
  # an existing metric, or a new metric that you create. To use your own
1837
1839
  # metric, you must first publish the metric to CloudWatch. For more
1838
1840
  # information, see [Publish custom metrics][1] in the *Amazon
@@ -1938,7 +1940,7 @@ module Aws::AutoScaling
1938
1940
  # @!attribute [rw] force_delete
1939
1941
  # Specifies that the group is to be deleted along with all instances
1940
1942
  # associated with the group, without waiting for all instances to be
1941
- # terminated. This parameter also deletes any outstanding lifecycle
1943
+ # terminated. This action also deletes any outstanding lifecycle
1942
1944
  # actions associated with the group.
1943
1945
  # @return [Boolean]
1944
1946
  #
@@ -2165,7 +2167,7 @@ module Aws::AutoScaling
2165
2167
  # }
2166
2168
  #
2167
2169
  # @!attribute [rw] instance_ids
2168
- # The IDs of the instances. If you omit this parameter, all Auto
2170
+ # The IDs of the instances. If you omit this property, all Auto
2169
2171
  # Scaling instances are described. If you specify an ID that does not
2170
2172
  # exist, it is ignored with no error.
2171
2173
  #
@@ -2205,7 +2207,8 @@ module Aws::AutoScaling
2205
2207
  end
2206
2208
 
2207
2209
  # @!attribute [rw] instance_refreshes
2208
- # The instance refreshes for the specified group.
2210
+ # The instance refreshes for the specified group, sorted by creation
2211
+ # timestamp in descending order.
2209
2212
  # @return [Array<Types::InstanceRefresh>]
2210
2213
  #
2211
2214
  # @!attribute [rw] next_token
@@ -2301,8 +2304,8 @@ module Aws::AutoScaling
2301
2304
  # @return [String]
2302
2305
  #
2303
2306
  # @!attribute [rw] lifecycle_hook_names
2304
- # The names of one or more lifecycle hooks. If you omit this
2305
- # parameter, all lifecycle hooks are described.
2307
+ # The names of one or more lifecycle hooks. If you omit this property,
2308
+ # all lifecycle hooks are described.
2306
2309
  # @return [Array<String>]
2307
2310
  #
2308
2311
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLifecycleHooksType AWS API Documentation
@@ -2423,7 +2426,7 @@ module Aws::AutoScaling
2423
2426
  end
2424
2427
 
2425
2428
  # @!attribute [rw] metrics
2426
- # One or more metrics.
2429
+ # The metrics.
2427
2430
  # @return [Array<Types::MetricCollectionType>]
2428
2431
  #
2429
2432
  # @!attribute [rw] granularities
@@ -2509,7 +2512,7 @@ module Aws::AutoScaling
2509
2512
  # @return [String]
2510
2513
  #
2511
2514
  # @!attribute [rw] policy_names
2512
- # The names of one or more policies. If you omit this parameter, all
2515
+ # The names of one or more policies. If you omit this property, all
2513
2516
  # policies are described. If a group name is provided, the results are
2514
2517
  # limited to that group. If you specify an unknown policy name, it is
2515
2518
  # ignored with no error.
@@ -2557,7 +2560,7 @@ module Aws::AutoScaling
2557
2560
  #
2558
2561
  # @!attribute [rw] activity_ids
2559
2562
  # The activity IDs of the desired scaling activities. If you omit this
2560
- # parameter, all activities for the past six weeks are described. If
2563
+ # property, all activities for the past six weeks are described. If
2561
2564
  # unknown activities are requested, they are ignored with no error. If
2562
2565
  # you specify an Auto Scaling group, the results are limited to that
2563
2566
  # group.
@@ -2614,7 +2617,7 @@ module Aws::AutoScaling
2614
2617
  #
2615
2618
  # @!attribute [rw] scheduled_action_names
2616
2619
  # The names of one or more scheduled actions. If you omit this
2617
- # parameter, all scheduled actions are described. If you specify an
2620
+ # property, all scheduled actions are described. If you specify an
2618
2621
  # unknown scheduled action, it is ignored with no error.
2619
2622
  #
2620
2623
  # Array Members: Maximum number of 50 actions.
@@ -2622,12 +2625,12 @@ module Aws::AutoScaling
2622
2625
  #
2623
2626
  # @!attribute [rw] start_time
2624
2627
  # The earliest scheduled start time to return. If scheduled action
2625
- # names are provided, this parameter is ignored.
2628
+ # names are provided, this property is ignored.
2626
2629
  # @return [Time]
2627
2630
  #
2628
2631
  # @!attribute [rw] end_time
2629
2632
  # The latest scheduled start time to return. If scheduled action names
2630
- # are provided, this parameter is ignored.
2633
+ # are provided, this property is ignored.
2631
2634
  # @return [Time]
2632
2635
  #
2633
2636
  # @!attribute [rw] next_token
@@ -3006,7 +3009,9 @@ module Aws::AutoScaling
3006
3009
  # @return [String]
3007
3010
  #
3008
3011
  # @!attribute [rw] metrics
3009
- # Specifies one or more of the following metrics:
3012
+ # Identifies the metrics to disable.
3013
+ #
3014
+ # You can specify one or more of the following metrics:
3010
3015
  #
3011
3016
  # * `GroupMinSize`
3012
3017
  #
@@ -3048,7 +3053,14 @@ module Aws::AutoScaling
3048
3053
  #
3049
3054
  # * `GroupAndWarmPoolTotalCapacity`
3050
3055
  #
3051
- # If you omit this parameter, all metrics are disabled.
3056
+ # If you omit this property, all metrics are disabled.
3057
+ #
3058
+ # For more information, see [Auto Scaling group metrics][1] in the
3059
+ # *Amazon EC2 Auto Scaling User Guide*.
3060
+ #
3061
+ #
3062
+ #
3063
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-cloudwatch-monitoring.html#as-group-metrics
3052
3064
  # @return [Array<String>]
3053
3065
  #
3054
3066
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DisableMetricsCollectionQuery AWS API Documentation
@@ -3103,7 +3115,7 @@ module Aws::AutoScaling
3103
3115
  # The volume type. For more information, see [Amazon EBS volume
3104
3116
  # types][1] in the *Amazon EC2 User Guide for Linux Instances*.
3105
3117
  #
3106
- # Valid Values: `standard` \| `io1` \| `gp2` \| `st1` \| `sc1` \|
3118
+ # Valid values: `standard` \| `io1` \| `gp2` \| `st1` \| `sc1` \|
3107
3119
  # `gp3`
3108
3120
  #
3109
3121
  #
@@ -3159,7 +3171,7 @@ module Aws::AutoScaling
3159
3171
  # KMS key or a customer-managed KMS key, regardless of whether the
3160
3172
  # snapshot was encrypted.
3161
3173
  #
3162
- # For more information, see [Using Amazon Web Services KMS keys to
3174
+ # For more information, see [Use Amazon Web Services KMS keys to
3163
3175
  # encrypt Amazon EBS volumes][2] in the *Amazon EC2 Auto Scaling User
3164
3176
  # Guide*.
3165
3177
  #
@@ -3203,8 +3215,9 @@ module Aws::AutoScaling
3203
3215
  # @return [String]
3204
3216
  #
3205
3217
  # @!attribute [rw] metrics
3206
- # Specifies which group-level metrics to start collecting. You can
3207
- # specify one or more of the following metrics:
3218
+ # Identifies the metrics to enable.
3219
+ #
3220
+ # You can specify one or more of the following metrics:
3208
3221
  #
3209
3222
  # * `GroupMinSize`
3210
3223
  #
@@ -3222,9 +3235,6 @@ module Aws::AutoScaling
3222
3235
  #
3223
3236
  # * `GroupTotalInstances`
3224
3237
  #
3225
- # The instance weighting feature supports the following additional
3226
- # metrics:
3227
- #
3228
3238
  # * `GroupInServiceCapacity`
3229
3239
  #
3230
3240
  # * `GroupPendingCapacity`
@@ -3235,8 +3245,6 @@ module Aws::AutoScaling
3235
3245
  #
3236
3246
  # * `GroupTotalCapacity`
3237
3247
  #
3238
- # The warm pools feature supports the following additional metrics:
3239
- #
3240
3248
  # * `WarmPoolDesiredCapacity`
3241
3249
  #
3242
3250
  # * `WarmPoolWarmedCapacity`
@@ -3251,12 +3259,20 @@ module Aws::AutoScaling
3251
3259
  #
3252
3260
  # * `GroupAndWarmPoolTotalCapacity`
3253
3261
  #
3254
- # If you omit this parameter, all metrics are enabled.
3262
+ # If you specify `Granularity` and don't specify any metrics, all
3263
+ # metrics are enabled.
3264
+ #
3265
+ # For more information, see [Auto Scaling group metrics][1] in the
3266
+ # *Amazon EC2 Auto Scaling User Guide*.
3267
+ #
3268
+ #
3269
+ #
3270
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-cloudwatch-monitoring.html#as-group-metrics
3255
3271
  # @return [Array<String>]
3256
3272
  #
3257
3273
  # @!attribute [rw] granularity
3258
- # The granularity to associate with the metrics to collect. The only
3259
- # valid value is `1Minute`.
3274
+ # The frequency at which Amazon EC2 Auto Scaling sends aggregated data
3275
+ # to CloudWatch. The only valid value is `1Minute`.
3260
3276
  # @return [String]
3261
3277
  #
3262
3278
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/EnableMetricsCollectionQuery AWS API Documentation
@@ -3269,7 +3285,7 @@ module Aws::AutoScaling
3269
3285
  include Aws::Structure
3270
3286
  end
3271
3287
 
3272
- # Describes an enabled metric.
3288
+ # Describes an enabled Auto Scaling group metric.
3273
3289
  #
3274
3290
  # @!attribute [rw] metric
3275
3291
  # One of the following metrics:
@@ -3313,6 +3329,13 @@ module Aws::AutoScaling
3313
3329
  # * `GroupAndWarmPoolDesiredCapacity`
3314
3330
  #
3315
3331
  # * `GroupAndWarmPoolTotalCapacity`
3332
+ #
3333
+ # For more information, see [Auto Scaling group metrics][1] in the
3334
+ # *Amazon EC2 Auto Scaling User Guide*.
3335
+ #
3336
+ #
3337
+ #
3338
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-cloudwatch-monitoring.html#as-group-metrics
3316
3339
  # @return [String]
3317
3340
  #
3318
3341
  # @!attribute [rw] granularity
@@ -3506,12 +3529,12 @@ module Aws::AutoScaling
3506
3529
  # logically joined with an `AND`, and the request returns only the
3507
3530
  # results that match all of the specified filters.
3508
3531
  #
3509
- # For more information, see [Tagging Auto Scaling groups and
3510
- # instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
3532
+ # For more information, see [Tag Auto Scaling groups and instances][1]
3533
+ # in the *Amazon EC2 Auto Scaling User Guide*.
3511
3534
  #
3512
3535
  #
3513
3536
  #
3514
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html
3537
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-tagging.html
3515
3538
  #
3516
3539
  # @note When making an API call, you may pass Filter
3517
3540
  # data as a hash:
@@ -4120,13 +4143,13 @@ module Aws::AutoScaling
4120
4143
  # @!attribute [rw] spot_max_price_percentage_over_lowest_price
4121
4144
  # The price protection threshold for Spot Instances. This is the
4122
4145
  # maximum you’ll pay for a Spot Instance, expressed as a percentage
4123
- # higher than the cheapest M, C, or R instance type with your
4124
- # specified attributes. When Amazon EC2 Auto Scaling selects instance
4125
- # types with your attributes, we will exclude instance types whose
4126
- # price is higher than your threshold. The parameter accepts an
4127
- # integer, which Amazon EC2 Auto Scaling interprets as a percentage.
4128
- # To turn off price protection, specify a high value, such as
4129
- # `999999`.
4146
+ # higher than the least expensive current generation M, C, or R
4147
+ # instance type with your specified attributes. When Amazon EC2 Auto
4148
+ # Scaling selects instance types with your attributes, we will exclude
4149
+ # instance types whose price is higher than your threshold. The
4150
+ # parameter accepts an integer, which Amazon EC2 Auto Scaling
4151
+ # interprets as a percentage. To turn off price protection, specify a
4152
+ # high value, such as `999999`.
4130
4153
  #
4131
4154
  # If you set `DesiredCapacityType` to `vcpu` or `memory-mib`, the
4132
4155
  # price protection threshold is applied based on the per vCPU or per
@@ -4138,13 +4161,13 @@ module Aws::AutoScaling
4138
4161
  # @!attribute [rw] on_demand_max_price_percentage_over_lowest_price
4139
4162
  # The price protection threshold for On-Demand Instances. This is the
4140
4163
  # maximum you’ll pay for an On-Demand Instance, expressed as a
4141
- # percentage higher than the cheapest M, C, or R instance type with
4142
- # your specified attributes. When Amazon EC2 Auto Scaling selects
4143
- # instance types with your attributes, we will exclude instance types
4144
- # whose price is higher than your threshold. The parameter accepts an
4145
- # integer, which Amazon EC2 Auto Scaling interprets as a percentage.
4146
- # To turn off price protection, specify a high value, such as
4147
- # `999999`.
4164
+ # percentage higher than the least expensive current generation M, C,
4165
+ # or R instance type with your specified attributes. When Amazon EC2
4166
+ # Auto Scaling selects instance types with your attributes, we will
4167
+ # exclude instance types whose price is higher than your threshold.
4168
+ # The parameter accepts an integer, which Amazon EC2 Auto Scaling
4169
+ # interprets as a percentage. To turn off price protection, specify a
4170
+ # high value, such as `999999`.
4148
4171
  #
4149
4172
  # If you set `DesiredCapacityType` to `vcpu` or `memory-mib`, the
4150
4173
  # price protection threshold is applied based on the per vCPU or per
@@ -4207,7 +4230,7 @@ module Aws::AutoScaling
4207
4230
  # `hdd`.
4208
4231
  #
4209
4232
  # * For instance types with solid state drive (SSD) storage, specify
4210
- # `sdd`.
4233
+ # `ssd`.
4211
4234
  #
4212
4235
  # Default: Any local storage type
4213
4236
  # @return [Array<String>]
@@ -4386,6 +4409,8 @@ module Aws::AutoScaling
4386
4409
  # Default: `lowest-price` for Auto Scaling groups that specify
4387
4410
  # InstanceRequirements in the overrides and `prioritized` for Auto
4388
4411
  # Scaling groups that don't.
4412
+ #
4413
+ # Valid values: `lowest-price` \| `prioritized`
4389
4414
  # @return [String]
4390
4415
  #
4391
4416
  # @!attribute [rw] on_demand_base_capacity
@@ -4430,6 +4455,9 @@ module Aws::AutoScaling
4430
4455
  # best-effort basis but optimizes for capacity first.
4431
4456
  #
4432
4457
  # Default: `lowest-price`
4458
+ #
4459
+ # Valid values: `lowest-price` \| `capacity-optimized` \|
4460
+ # `capacity-optimized-prioritized`
4433
4461
  # @return [String]
4434
4462
  #
4435
4463
  # @!attribute [rw] spot_instance_pools
@@ -4447,6 +4475,11 @@ module Aws::AutoScaling
4447
4475
  # Amazon EC2 Auto Scaling uses the On-Demand price as the maximum Spot
4448
4476
  # price. To remove a value that you previously set, include the
4449
4477
  # property but specify an empty string ("") for the value.
4478
+ #
4479
+ # If your maximum price is lower than the Spot price for the instance
4480
+ # types that you selected, your Spot Instances are not launched.
4481
+ #
4482
+ # Valid Range: Minimum value of 0.001
4450
4483
  # @return [String]
4451
4484
  #
4452
4485
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/InstancesDistribution AWS API Documentation
@@ -4487,7 +4520,7 @@ module Aws::AutoScaling
4487
4520
  #
4488
4521
  # @!attribute [rw] image_id
4489
4522
  # The ID of the Amazon Machine Image (AMI) to use to launch your EC2
4490
- # instances. For more information, see [Finding an AMI][1] in the
4523
+ # instances. For more information, see [Find a Linux AMI][1] in the
4491
4524
  # *Amazon EC2 User Guide for Linux Instances*.
4492
4525
  #
4493
4526
  #
@@ -4518,7 +4551,7 @@ module Aws::AutoScaling
4518
4551
  # @return [Array<String>]
4519
4552
  #
4520
4553
  # @!attribute [rw] classic_link_vpc_id
4521
- # *EC2-Classic retires on August 15, 2022. This parameter is not
4554
+ # *EC2-Classic retires on August 15, 2022. This property is not
4522
4555
  # supported after that date.*
4523
4556
  #
4524
4557
  # The ID of a ClassicLink-enabled VPC to link your EC2-Classic
@@ -4526,7 +4559,7 @@ module Aws::AutoScaling
4526
4559
  # @return [String]
4527
4560
  #
4528
4561
  # @!attribute [rw] classic_link_vpc_security_groups
4529
- # *EC2-Classic retires on August 15, 2022. This parameter is not
4562
+ # *EC2-Classic retires on August 15, 2022. This property is not
4530
4563
  # supported after that date.*
4531
4564
  #
4532
4565
  # The IDs of one or more security groups for the VPC specified in
@@ -4548,11 +4581,9 @@ module Aws::AutoScaling
4548
4581
  # @return [String]
4549
4582
  #
4550
4583
  # @!attribute [rw] instance_type
4551
- # The instance type for the instances.
4552
- #
4553
- # For information about available instance types, see [Available
4554
- # Instance Types][1] in the *Amazon EC2 User Guide for Linux
4555
- # Instances*.
4584
+ # The instance type for the instances. For information about available
4585
+ # instance types, see [Available instance types][1] in the *Amazon EC2
4586
+ # User Guide for Linux Instances*.
4556
4587
  #
4557
4588
  #
4558
4589
  #
@@ -4568,9 +4599,11 @@ module Aws::AutoScaling
4568
4599
  # @return [String]
4569
4600
  #
4570
4601
  # @!attribute [rw] block_device_mappings
4571
- # A block device mapping, which specifies the block devices for the
4572
- # instance. For more information, see [Block Device Mapping][1] in the
4573
- # *Amazon EC2 User Guide for Linux Instances*.
4602
+ # The block device mapping entries that define the block devices to
4603
+ # attach to the instances at launch. By default, the block devices
4604
+ # specified in the block device mapping for the AMI are used. For more
4605
+ # information, see [Block Device Mapping][1] in the *Amazon EC2 User
4606
+ # Guide for Linux Instances*.
4574
4607
  #
4575
4608
  #
4576
4609
  #
@@ -4629,10 +4662,15 @@ module Aws::AutoScaling
4629
4662
  # @return [Boolean]
4630
4663
  #
4631
4664
  # @!attribute [rw] associate_public_ip_address
4632
- # For Auto Scaling groups that are running in a VPC, specifies whether
4633
- # to assign a public IP address to the group's instances. For more
4634
- # information, see [Launching Auto Scaling instances in a VPC][1] in
4635
- # the *Amazon EC2 Auto Scaling User Guide*.
4665
+ # Specifies whether to assign a public IPv4 address to the group's
4666
+ # instances. If the instance is launched into a default subnet, the
4667
+ # default is to assign a public IPv4 address, unless you disabled the
4668
+ # option to assign a public IPv4 address on the subnet. If the
4669
+ # instance is launched into a nondefault subnet, the default is not to
4670
+ # assign a public IPv4 address, unless you enabled the option to
4671
+ # assign a public IPv4 address on the subnet. For more information,
4672
+ # see [Launching Auto Scaling instances in a VPC][1] in the *Amazon
4673
+ # EC2 Auto Scaling User Guide*.
4636
4674
  #
4637
4675
  #
4638
4676
  #
@@ -4718,7 +4756,7 @@ module Aws::AutoScaling
4718
4756
  # }
4719
4757
  #
4720
4758
  # @!attribute [rw] launch_configuration_names
4721
- # The launch configuration names. If you omit this parameter, all
4759
+ # The launch configuration names. If you omit this property, all
4722
4760
  # launch configurations are described.
4723
4761
  #
4724
4762
  # Array Members: Maximum number of 50 items.
@@ -5081,19 +5119,16 @@ module Aws::AutoScaling
5081
5119
  # @return [String]
5082
5120
  #
5083
5121
  # @!attribute [rw] lifecycle_transition
5084
- # The state of the EC2 instance to which to attach the lifecycle hook.
5085
- # The following are possible values:
5122
+ # The lifecycle transition.
5086
5123
  #
5087
- # * autoscaling:EC2\_INSTANCE\_LAUNCHING
5088
- #
5089
- # * autoscaling:EC2\_INSTANCE\_TERMINATING
5124
+ # Valid values: `autoscaling:EC2_INSTANCE_LAUNCHING` \|
5125
+ # `autoscaling:EC2_INSTANCE_TERMINATING`
5090
5126
  # @return [String]
5091
5127
  #
5092
5128
  # @!attribute [rw] notification_target_arn
5093
5129
  # The ARN of the target that Amazon EC2 Auto Scaling sends
5094
- # notifications to when an instance is in the transition state for the
5095
- # lifecycle hook. The notification target can be either an SQS queue
5096
- # or an SNS topic.
5130
+ # notifications to when an instance is in a wait state for the
5131
+ # lifecycle hook.
5097
5132
  # @return [String]
5098
5133
  #
5099
5134
  # @!attribute [rw] role_arn
@@ -5111,7 +5146,7 @@ module Aws::AutoScaling
5111
5146
  # The maximum time, in seconds, that can elapse before the lifecycle
5112
5147
  # hook times out. If the lifecycle hook times out, Amazon EC2 Auto
5113
5148
  # Scaling performs the action that you specified in the
5114
- # `DefaultResult` parameter.
5149
+ # `DefaultResult` property.
5115
5150
  # @return [Integer]
5116
5151
  #
5117
5152
  # @!attribute [rw] global_timeout
@@ -5121,9 +5156,10 @@ module Aws::AutoScaling
5121
5156
  # @return [Integer]
5122
5157
  #
5123
5158
  # @!attribute [rw] default_result
5124
- # Defines the action the Auto Scaling group should take when the
5125
- # lifecycle hook timeout elapses or if an unexpected failure occurs.
5126
- # The possible values are `CONTINUE` and `ABANDON`.
5159
+ # The action the Auto Scaling group takes when the lifecycle hook
5160
+ # timeout elapses or if an unexpected failure occurs.
5161
+ #
5162
+ # Valid values: `CONTINUE` \| `ABANDON`
5127
5163
  # @return [String]
5128
5164
  #
5129
5165
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/LifecycleHook AWS API Documentation
@@ -5170,12 +5206,14 @@ module Aws::AutoScaling
5170
5206
  # @return [String]
5171
5207
  #
5172
5208
  # @!attribute [rw] lifecycle_transition
5173
- # The state of the EC2 instance to which you want to attach the
5174
- # lifecycle hook. The valid values are:
5209
+ # The lifecycle transition. For Auto Scaling groups, there are two
5210
+ # major lifecycle transitions.
5175
5211
  #
5176
- # * autoscaling:EC2\_INSTANCE\_LAUNCHING
5212
+ # * To create a lifecycle hook for scale-out events, specify
5213
+ # `autoscaling:EC2_INSTANCE_LAUNCHING`.
5177
5214
  #
5178
- # * autoscaling:EC2\_INSTANCE\_TERMINATING
5215
+ # * To create a lifecycle hook for scale-in events, specify
5216
+ # `autoscaling:EC2_INSTANCE_TERMINATING`.
5179
5217
  # @return [String]
5180
5218
  #
5181
5219
  # @!attribute [rw] notification_metadata
@@ -5185,35 +5223,37 @@ module Aws::AutoScaling
5185
5223
  #
5186
5224
  # @!attribute [rw] heartbeat_timeout
5187
5225
  # The maximum time, in seconds, that can elapse before the lifecycle
5188
- # hook times out.
5189
- #
5190
- # If the lifecycle hook times out, Amazon EC2 Auto Scaling performs
5191
- # the action that you specified in the `DefaultResult` parameter. You
5192
- # can prevent the lifecycle hook from timing out by calling
5193
- # RecordLifecycleActionHeartbeat.
5226
+ # hook times out. The range is from `30` to `7200` seconds. The
5227
+ # default value is `3600` seconds (1 hour).
5194
5228
  # @return [Integer]
5195
5229
  #
5196
5230
  # @!attribute [rw] default_result
5197
- # Defines the action the Auto Scaling group should take when the
5198
- # lifecycle hook timeout elapses or if an unexpected failure occurs.
5199
- # The valid values are `CONTINUE` and `ABANDON`. The default value is
5200
- # `ABANDON`.
5231
+ # The action the Auto Scaling group takes when the lifecycle hook
5232
+ # timeout elapses or if an unexpected failure occurs. The default
5233
+ # value is `ABANDON`.
5234
+ #
5235
+ # Valid values: `CONTINUE` \| `ABANDON`
5201
5236
  # @return [String]
5202
5237
  #
5203
5238
  # @!attribute [rw] notification_target_arn
5204
- # The ARN of the target that Amazon EC2 Auto Scaling sends
5205
- # notifications to when an instance is in the transition state for the
5206
- # lifecycle hook. The notification target can be either an SQS queue
5207
- # or an SNS topic.
5239
+ # The Amazon Resource Name (ARN) of the notification target that
5240
+ # Amazon EC2 Auto Scaling sends notifications to when an instance is
5241
+ # in a wait state for the lifecycle hook. You can specify an Amazon
5242
+ # SNS topic or an Amazon SQS queue.
5208
5243
  # @return [String]
5209
5244
  #
5210
5245
  # @!attribute [rw] role_arn
5211
5246
  # The ARN of the IAM role that allows the Auto Scaling group to
5212
- # publish to the specified notification target.
5247
+ # publish to the specified notification target. For information about
5248
+ # creating this role, see [Configure a notification target for a
5249
+ # lifecycle hook][1] in the *Amazon EC2 Auto Scaling User Guide*.
5213
5250
  #
5214
5251
  # Valid only if the notification target is an Amazon SNS topic or an
5215
- # Amazon SQS queue. Required for new lifecycle hooks, but optional
5216
- # when updating existing hooks.
5252
+ # Amazon SQS queue.
5253
+ #
5254
+ #
5255
+ #
5256
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/prepare-for-lifecycle-notifications.html#lifecycle-hook-notification-target
5217
5257
  # @return [String]
5218
5258
  #
5219
5259
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/LifecycleHookSpecification AWS API Documentation
@@ -5815,14 +5855,13 @@ module Aws::AutoScaling
5815
5855
  # }
5816
5856
  #
5817
5857
  # @!attribute [rw] launch_template
5818
- # Specifies the launch template to use and the instance types
5819
- # (overrides) that are used to launch EC2 instances to fulfill
5820
- # On-Demand and Spot capacities. Required when creating a mixed
5821
- # instances policy.
5858
+ # One or more launch templates and the instance types (overrides) that
5859
+ # are used to launch EC2 instances to fulfill On-Demand and Spot
5860
+ # capacities.
5822
5861
  # @return [Types::LaunchTemplate]
5823
5862
  #
5824
5863
  # @!attribute [rw] instances_distribution
5825
- # Specifies the instances distribution.
5864
+ # The instances distribution.
5826
5865
  # @return [Types::InstancesDistribution]
5827
5866
  #
5828
5867
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/MixedInstancesPolicy AWS API Documentation
@@ -6762,12 +6801,14 @@ module Aws::AutoScaling
6762
6801
  # @return [String]
6763
6802
  #
6764
6803
  # @!attribute [rw] lifecycle_transition
6765
- # The instance state to which you want to attach the lifecycle hook.
6766
- # The valid values are:
6804
+ # The lifecycle transition. For Auto Scaling groups, there are two
6805
+ # major lifecycle transitions.
6767
6806
  #
6768
- # * autoscaling:EC2\_INSTANCE\_LAUNCHING
6807
+ # * To create a lifecycle hook for scale-out events, specify
6808
+ # `autoscaling:EC2_INSTANCE_LAUNCHING`.
6769
6809
  #
6770
- # * autoscaling:EC2\_INSTANCE\_TERMINATING
6810
+ # * To create a lifecycle hook for scale-in events, specify
6811
+ # `autoscaling:EC2_INSTANCE_TERMINATING`.
6771
6812
  #
6772
6813
  # Required for new lifecycle hooks, but optional when updating
6773
6814
  # existing hooks.
@@ -6783,10 +6824,10 @@ module Aws::AutoScaling
6783
6824
  # @return [String]
6784
6825
  #
6785
6826
  # @!attribute [rw] notification_target_arn
6786
- # The ARN of the notification target that Amazon EC2 Auto Scaling uses
6787
- # to notify you when an instance is in the transition state for the
6788
- # lifecycle hook. This target can be either an SQS queue or an SNS
6789
- # topic.
6827
+ # The Amazon Resource Name (ARN) of the notification target that
6828
+ # Amazon EC2 Auto Scaling uses to notify you when an instance is in a
6829
+ # wait state for the lifecycle hook. You can specify either an Amazon
6830
+ # SNS topic or an Amazon SQS queue.
6790
6831
  #
6791
6832
  # If you specify an empty string, this overrides the current ARN.
6792
6833
  #
@@ -6809,18 +6850,14 @@ module Aws::AutoScaling
6809
6850
  # The maximum time, in seconds, that can elapse before the lifecycle
6810
6851
  # hook times out. The range is from `30` to `7200` seconds. The
6811
6852
  # default value is `3600` seconds (1 hour).
6812
- #
6813
- # If the lifecycle hook times out, Amazon EC2 Auto Scaling performs
6814
- # the action that you specified in the `DefaultResult` parameter. You
6815
- # can prevent the lifecycle hook from timing out by calling the
6816
- # RecordLifecycleActionHeartbeat API.
6817
6853
  # @return [Integer]
6818
6854
  #
6819
6855
  # @!attribute [rw] default_result
6820
- # Defines the action the Auto Scaling group should take when the
6821
- # lifecycle hook timeout elapses or if an unexpected failure occurs.
6822
- # This parameter can be either `CONTINUE` or `ABANDON`. The default
6856
+ # The action the Auto Scaling group takes when the lifecycle hook
6857
+ # timeout elapses or if an unexpected failure occurs. The default
6823
6858
  # value is `ABANDON`.
6859
+ #
6860
+ # Valid values: `CONTINUE` \| `ABANDON`
6824
6861
  # @return [String]
6825
6862
  #
6826
6863
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PutLifecycleHookType AWS API Documentation
@@ -7151,7 +7188,7 @@ module Aws::AutoScaling
7151
7188
  # * `ALBRequestCountPerTarget`
7152
7189
  #
7153
7190
  # If you specify `ALBRequestCountPerTarget` for the metric, you must
7154
- # specify the `ResourceLabel` parameter with the
7191
+ # specify the `ResourceLabel` property with the
7155
7192
  # `PredefinedMetricSpecification`.
7156
7193
  #
7157
7194
  # For more information, see [TargetTrackingConfiguration][1] in the
@@ -7238,24 +7275,22 @@ module Aws::AutoScaling
7238
7275
  # @return [String]
7239
7276
  #
7240
7277
  # @!attribute [rw] time
7241
- # This parameter is no longer used.
7278
+ # This property is no longer used.
7242
7279
  # @return [Time]
7243
7280
  #
7244
7281
  # @!attribute [rw] start_time
7245
7282
  # The date and time for this action to start, in YYYY-MM-DDThh:mm:ssZ
7246
7283
  # format in UTC/GMT only and in quotes (for example,
7247
- # `"2019-06-01T00:00:00Z"`).
7284
+ # `"2021-06-01T00:00:00Z"`).
7248
7285
  #
7249
7286
  # If you specify `Recurrence` and `StartTime`, Amazon EC2 Auto Scaling
7250
7287
  # performs the action at this time, and then performs the action based
7251
7288
  # on the specified recurrence.
7252
- #
7253
- # If you try to schedule your action in the past, Amazon EC2 Auto
7254
- # Scaling returns an error message.
7255
7289
  # @return [Time]
7256
7290
  #
7257
7291
  # @!attribute [rw] end_time
7258
- # The date and time for the recurring schedule to end, in UTC.
7292
+ # The date and time for the recurring schedule to end, in UTC. For
7293
+ # example, `"2021-06-01T00:00:00Z"`.
7259
7294
  # @return [Time]
7260
7295
  #
7261
7296
  # @!attribute [rw] recurrence
@@ -7288,6 +7323,11 @@ module Aws::AutoScaling
7288
7323
  # group after the scheduled action runs and the capacity it attempts
7289
7324
  # to maintain. It can scale beyond this capacity if you add more
7290
7325
  # scaling conditions.
7326
+ #
7327
+ # <note markdown="1"> You must specify at least one of the following properties:
7328
+ # `MaxSize`, `MinSize`, or `DesiredCapacity`.
7329
+ #
7330
+ # </note>
7291
7331
  # @return [Integer]
7292
7332
  #
7293
7333
  # @!attribute [rw] time_zone
@@ -7714,7 +7754,7 @@ module Aws::AutoScaling
7714
7754
  #
7715
7755
  # * `ScheduledActions`
7716
7756
  #
7717
- # If you omit this parameter, all processes are specified.
7757
+ # If you omit this property, all processes are specified.
7718
7758
  # @return [Array<String>]
7719
7759
  #
7720
7760
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ScalingProcessQuery AWS API Documentation
@@ -7762,7 +7802,7 @@ module Aws::AutoScaling
7762
7802
  # @return [String]
7763
7803
  #
7764
7804
  # @!attribute [rw] time
7765
- # This parameter is no longer used.
7805
+ # This property is no longer used.
7766
7806
  # @return [Time]
7767
7807
  #
7768
7808
  # @!attribute [rw] start_time
@@ -8277,6 +8317,12 @@ module Aws::AutoScaling
8277
8317
  # The amount by which to scale, based on the specified adjustment
8278
8318
  # type. A positive value adds to the current capacity while a negative
8279
8319
  # number removes from the current capacity.
8320
+ #
8321
+ # The amount by which to scale. The adjustment is based on the value
8322
+ # that you specified in the `AdjustmentType` property (either an
8323
+ # absolute number or a percentage). A positive value adds to the
8324
+ # current capacity and a negative number subtracts from the current
8325
+ # capacity.
8280
8326
  # @return [Integer]
8281
8327
  #
8282
8328
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/StepAdjustment AWS API Documentation
@@ -8756,20 +8802,25 @@ module Aws::AutoScaling
8756
8802
  # @!attribute [rw] vpc_zone_identifier
8757
8803
  # A comma-separated list of subnet IDs for a virtual private cloud
8758
8804
  # (VPC). If you specify `VPCZoneIdentifier` with `AvailabilityZones`,
8759
- # the subnets that you specify for this parameter must reside in those
8760
- # Availability Zones.
8805
+ # the subnets that you specify must reside in those Availability
8806
+ # Zones.
8761
8807
  # @return [String]
8762
8808
  #
8763
8809
  # @!attribute [rw] termination_policies
8764
8810
  # A policy or a list of policies that are used to select the instances
8765
8811
  # to terminate. The policies are executed in the order that you list
8766
- # them. For more information, see [Controlling which Auto Scaling
8767
- # instances terminate during scale in][1] in the *Amazon EC2 Auto
8768
- # Scaling User Guide*.
8812
+ # them. For more information, see [Work with Amazon EC2 Auto Scaling
8813
+ # termination policies][1] in the *Amazon EC2 Auto Scaling User
8814
+ # Guide*.
8769
8815
  #
8816
+ # Valid values: `Default` \| `AllocationStrategy` \|
8817
+ # `ClosestToNextInstanceHour` \| `NewestInstance` \| `OldestInstance`
8818
+ # \| `OldestLaunchConfiguration` \| `OldestLaunchTemplate` \|
8819
+ # `arn:aws:lambda:region:account-id:function:my-function:my-alias`
8770
8820
  #
8771
8821
  #
8772
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html
8822
+ #
8823
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-termination-policies.html
8773
8824
  # @return [Array<String>]
8774
8825
  #
8775
8826
  # @!attribute [rw] new_instances_protected_from_scale_in
@@ -8810,8 +8861,8 @@ module Aws::AutoScaling
8810
8861
  #
8811
8862
  # @!attribute [rw] capacity_rebalance
8812
8863
  # Enables or disables Capacity Rebalancing. For more information, see
8813
- # [Amazon EC2 Auto Scaling Capacity Rebalancing][1] in the *Amazon EC2
8814
- # Auto Scaling User Guide*.
8864
+ # [Use Capacity Rebalancing to handle Amazon EC2 Spot
8865
+ # Interruptions][1] in the *Amazon EC2 Auto Scaling User Guide*.
8815
8866
  #
8816
8867
  #
8817
8868
  #