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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +5 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-autoscaling/auto_scaling_group.rb +58 -39
- data/lib/aws-sdk-autoscaling/client.rb +251 -219
- data/lib/aws-sdk-autoscaling/instance.rb +1 -1
- data/lib/aws-sdk-autoscaling/launch_configuration.rb +20 -14
- data/lib/aws-sdk-autoscaling/lifecycle_hook.rb +26 -30
- data/lib/aws-sdk-autoscaling/resource.rb +119 -118
- data/lib/aws-sdk-autoscaling/scheduled_action.rb +1 -1
- data/lib/aws-sdk-autoscaling/types.rb +316 -265
- data/lib/aws-sdk-autoscaling.rb +1 -1
- metadata +2 -2
@@ -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`
|
537
|
+
# the `MaxRecords` property.
|
538
538
|
#
|
539
|
-
# If you omit this
|
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
|
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
|
831
|
-
#
|
832
|
-
#
|
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
|
837
|
-
#
|
838
|
-
#
|
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
|
-
#
|
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`
|
854
|
-
#
|
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.
|
959
|
-
#
|
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
|
-
#
|
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.
|
1211
|
-
#
|
1212
|
-
#
|
1213
|
-
#
|
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
|
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
|
1227
|
-
#
|
1228
|
-
#
|
1229
|
-
#
|
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
|
1270
|
-
#
|
1271
|
-
#
|
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
|
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 [
|
1299
|
-
#
|
1300
|
-
#
|
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
|
-
#
|
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 [
|
1326
|
-
#
|
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
|
1336
|
-
#
|
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 [
|
1349
|
-
#
|
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/
|
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
|
1360
|
-
# behalf. By default, Amazon EC2 Auto Scaling uses a
|
1361
|
-
# role named `AWSServiceRoleForAutoScaling`, which it
|
1362
|
-
# does not exist. For more information, see
|
1363
|
-
# in the *Amazon EC2 Auto Scaling User
|
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
|
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
|
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
|
1531
|
-
#
|
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
|
1540
|
-
# in the Auto Scaling group.
|
1541
|
-
#
|
1542
|
-
#
|
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
|
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
|
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.
|
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
|
-
#
|
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
|
-
#
|
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
|
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
|
-
#
|
1643
|
-
#
|
1644
|
-
#
|
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 [
|
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/
|
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
|
-
#
|
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
|
-
#
|
1722
|
-
#
|
1723
|
-
#
|
1724
|
-
#
|
1725
|
-
#
|
1726
|
-
#
|
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
|
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
|
1747
|
-
# runs on isolated, single-tenant
|
1748
|
-
# into a VPC.
|
1749
|
-
#
|
1750
|
-
#
|
1751
|
-
#
|
1752
|
-
#
|
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
|
-
#
|
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
|
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
|
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
|
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
|
-
#
|
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
|
-
#
|
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
|
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
|
-
#
|
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
|
-
#
|
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
|
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
|
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
|
-
#
|
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
|
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
|
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 [
|
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
|
-
#
|
3207
|
-
#
|
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
|
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
|
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 [
|
3510
|
-
#
|
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/
|
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
|
4124
|
-
# specified attributes. When Amazon EC2 Auto
|
4125
|
-
# types with your attributes, we will exclude
|
4126
|
-
# price is higher than your threshold. The
|
4127
|
-
# integer, which Amazon EC2 Auto Scaling
|
4128
|
-
# To turn off price protection, specify a
|
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
|
4142
|
-
# your specified attributes. When Amazon EC2
|
4143
|
-
# instance types with your attributes, we will
|
4144
|
-
# whose price is higher than your threshold.
|
4145
|
-
# integer, which Amazon EC2 Auto Scaling
|
4146
|
-
# To turn off price protection, specify a
|
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
|
-
# `
|
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 [
|
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
|
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
|
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
|
-
#
|
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
|
-
#
|
4572
|
-
#
|
4573
|
-
#
|
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
|
-
#
|
4633
|
-
#
|
4634
|
-
#
|
4635
|
-
#
|
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
|
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
|
5085
|
-
# The following are possible values:
|
5122
|
+
# The lifecycle transition.
|
5086
5123
|
#
|
5087
|
-
#
|
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
|
5095
|
-
# lifecycle hook.
|
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`
|
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
|
-
#
|
5125
|
-
#
|
5126
|
-
#
|
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
|
5174
|
-
# lifecycle
|
5209
|
+
# The lifecycle transition. For Auto Scaling groups, there are two
|
5210
|
+
# major lifecycle transitions.
|
5175
5211
|
#
|
5176
|
-
# *
|
5212
|
+
# * To create a lifecycle hook for scale-out events, specify
|
5213
|
+
# `autoscaling:EC2_INSTANCE_LAUNCHING`.
|
5177
5214
|
#
|
5178
|
-
# *
|
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
|
-
#
|
5198
|
-
#
|
5199
|
-
#
|
5200
|
-
#
|
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
|
5205
|
-
# notifications to when an instance is
|
5206
|
-
# lifecycle hook.
|
5207
|
-
# or an
|
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.
|
5216
|
-
#
|
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
|
-
#
|
5819
|
-
#
|
5820
|
-
#
|
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
|
-
#
|
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
|
6766
|
-
#
|
6804
|
+
# The lifecycle transition. For Auto Scaling groups, there are two
|
6805
|
+
# major lifecycle transitions.
|
6767
6806
|
#
|
6768
|
-
# *
|
6807
|
+
# * To create a lifecycle hook for scale-out events, specify
|
6808
|
+
# `autoscaling:EC2_INSTANCE_LAUNCHING`.
|
6769
6809
|
#
|
6770
|
-
# *
|
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
|
6787
|
-
# to notify you when an instance is in
|
6788
|
-
# lifecycle hook.
|
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
|
-
#
|
6821
|
-
#
|
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`
|
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
|
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
|
-
# `"
|
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
|
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
|
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
|
8760
|
-
#
|
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 [
|
8767
|
-
#
|
8768
|
-
#
|
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
|
-
#
|
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
|
-
# [
|
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
|
#
|