aws-sdk-autoscaling 1.79.0 → 1.80.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -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
  #