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.
@@ -428,8 +428,9 @@ module Aws::AutoScaling
428
428
  # This operation is additive and does not detach existing target groups
429
429
  # or Classic Load Balancers from the Auto Scaling group.
430
430
  #
431
- # For more information, see [Elastic Load Balancing and Amazon EC2 Auto
432
- # Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
431
+ # For more information, see [Use Elastic Load Balancing to distribute
432
+ # traffic across the instances in your Auto Scaling group][1] in the
433
+ # *Amazon EC2 Auto Scaling User Guide*.
433
434
  #
434
435
  #
435
436
  #
@@ -488,14 +489,15 @@ module Aws::AutoScaling
488
489
  # with these Classic Load Balancers.
489
490
  #
490
491
  # To describe the load balancers for an Auto Scaling group, call the
491
- # DescribeLoadBalancers API. To detach the load balancer from the Auto
492
+ # DescribeLoadBalancers API. To detach a load balancer from the Auto
492
493
  # Scaling group, call the DetachLoadBalancers API.
493
494
  #
494
495
  # This operation is additive and does not detach existing Classic Load
495
496
  # Balancers or target groups from the Auto Scaling group.
496
497
  #
497
- # For more information, see [Elastic Load Balancing and Amazon EC2 Auto
498
- # Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
498
+ # For more information, see [Use Elastic Load Balancing to distribute
499
+ # traffic across the instances in your Auto Scaling group][1] in the
500
+ # *Amazon EC2 Auto Scaling User Guide*.
499
501
  #
500
502
  #
501
503
  #
@@ -722,8 +724,8 @@ module Aws::AutoScaling
722
724
  # created the lifecycle hook.
723
725
  #
724
726
  # @option params [required, String] :lifecycle_action_result
725
- # The action for the group to take. This parameter can be either
726
- # `CONTINUE` or `ABANDON`.
727
+ # The action for the group to take. You can specify either `CONTINUE` or
728
+ # `ABANDON`.
727
729
  #
728
730
  # @option params [String] :instance_id
729
731
  # The ID of the instance.
@@ -770,8 +772,8 @@ module Aws::AutoScaling
770
772
  #
771
773
  # If you exceed your maximum limit of Auto Scaling groups, the call
772
774
  # fails. To query this limit, call the DescribeAccountLimits API. For
773
- # information about updating this limit, see [Amazon EC2 Auto Scaling
774
- # service quotas][1] in the *Amazon EC2 Auto Scaling User Guide*.
775
+ # information about updating this limit, see [Quotas for Amazon EC2 Auto
776
+ # Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
775
777
  #
776
778
  # For introductory exercises for creating an Auto Scaling group, see
777
779
  # [Getting started with Amazon EC2 Auto Scaling][2] and [Tutorial: Set
@@ -779,7 +781,7 @@ module Aws::AutoScaling
779
781
  # Scaling User Guide*. For more information, see [Auto Scaling
780
782
  # groups][4] in the *Amazon EC2 Auto Scaling User Guide*.
781
783
  #
782
- # Every Auto Scaling group has three size parameters (`DesiredCapacity`,
784
+ # Every Auto Scaling group has three size properties (`DesiredCapacity`,
783
785
  # `MaxSize`, and `MinSize`). Usually, you set these sizes based on a
784
786
  # specific number of instances. However, if you configure a mixed
785
787
  # instances policy that defines weights for the instance types, you must
@@ -788,7 +790,7 @@ module Aws::AutoScaling
788
790
  #
789
791
  #
790
792
  #
791
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-account-limits.html
793
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-quotas.html
792
794
  # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/GettingStartedTutorial.html
793
795
  # [3]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-register-lbs-with-asg.html
794
796
  # [4]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/AutoScalingGroup.html
@@ -805,7 +807,7 @@ module Aws::AutoScaling
805
807
  # (`LaunchConfigurationName` or `InstanceId`).
806
808
  #
807
809
  # @option params [Types::LaunchTemplateSpecification] :launch_template
808
- # Parameters used to specify the launch template and version to use to
810
+ # Information used to specify the launch template and version to use to
809
811
  # launch instances.
810
812
  #
811
813
  # Conditional: You must specify either a launch template
@@ -887,24 +889,24 @@ module Aws::AutoScaling
887
889
  #
888
890
  # @option params [Array<String>] :availability_zones
889
891
  # A list of Availability Zones where instances in the Auto Scaling group
890
- # can be created. This parameter is optional if you specify one or more
891
- # subnets for `VPCZoneIdentifier`.
892
- #
893
- # Conditional: If your account supports EC2-Classic and VPC, this
894
- # parameter is required to launch instances into EC2-Classic.
892
+ # can be created. Used for launching into the default VPC subnet in each
893
+ # Availability Zone when not using the `VPCZoneIdentifier` property, or
894
+ # for attaching a network interface when an existing network interface
895
+ # ID is specified in a launch template.
895
896
  #
896
897
  # @option params [Array<String>] :load_balancer_names
897
898
  # A list of Classic Load Balancers associated with this Auto Scaling
898
899
  # group. For Application Load Balancers, Network Load Balancers, and
899
- # Gateway Load Balancers, specify the `TargetGroupARNs` property
900
- # instead.
900
+ # Gateway Load Balancer, specify the `TargetGroupARNs` property instead.
901
901
  #
902
902
  # @option params [Array<String>] :target_group_arns
903
903
  # The Amazon Resource Names (ARN) of the target groups to associate with
904
- # the Auto Scaling group. Instances are registered as targets in a
905
- # target group, and traffic is routed to the target group. For more
906
- # information, see [Elastic Load Balancing and Amazon EC2 Auto
907
- # Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
904
+ # the Auto Scaling group. Instances are registered as targets with the
905
+ # target groups. The target groups receive incoming traffic and route
906
+ # requests to one or more registered targets. For more information, see
907
+ # [Use Elastic Load Balancing to distribute traffic across the instances
908
+ # in your Auto Scaling group][1] in the *Amazon EC2 Auto Scaling User
909
+ # Guide*.
908
910
  #
909
911
  #
910
912
  #
@@ -923,8 +925,6 @@ module Aws::AutoScaling
923
925
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html
924
926
  #
925
927
  # @option params [Integer] :health_check_grace_period
926
- # **
927
- #
928
928
  # The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
929
929
  # before checking the health status of an EC2 instance that has come
930
930
  # into service and marking it unhealthy due to a failed Elastic Load
@@ -940,9 +940,9 @@ module Aws::AutoScaling
940
940
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html#health-check-grace-period
941
941
  #
942
942
  # @option params [String] :placement_group
943
- # The name of an existing placement group into which to launch your
944
- # instances. For more information, see [Placement groups][1] in the
945
- # *Amazon EC2 User Guide for Linux Instances*.
943
+ # The name of the placement group into which to launch your instances.
944
+ # For more information, see [Placement groups][1] in the *Amazon EC2
945
+ # User Guide for Linux Instances*.
946
946
  #
947
947
  # <note markdown="1"> A *cluster* placement group is a logical grouping of instances within
948
948
  # a single Availability Zone. You cannot specify multiple Availability
@@ -958,22 +958,22 @@ module Aws::AutoScaling
958
958
  # A comma-separated list of subnet IDs for a virtual private cloud (VPC)
959
959
  # where instances in the Auto Scaling group can be created. If you
960
960
  # specify `VPCZoneIdentifier` with `AvailabilityZones`, the subnets that
961
- # you specify for this parameter must reside in those Availability
962
- # Zones.
963
- #
964
- # Conditional: If your account supports EC2-Classic and VPC, this
965
- # parameter is required to launch instances into a VPC.
961
+ # you specify must reside in those Availability Zones.
966
962
  #
967
963
  # @option params [Array<String>] :termination_policies
968
964
  # A policy or a list of policies that are used to select the instance to
969
965
  # terminate. These policies are executed in the order that you list
970
- # them. For more information, see [Controlling which Auto Scaling
971
- # instances terminate during scale in][1] in the *Amazon EC2 Auto
972
- # Scaling User Guide*.
966
+ # them. For more information, see [Work with Amazon EC2 Auto Scaling
967
+ # termination policies][1] in the *Amazon EC2 Auto Scaling User Guide*.
968
+ #
969
+ # Valid values: `Default` \| `AllocationStrategy` \|
970
+ # `ClosestToNextInstanceHour` \| `NewestInstance` \| `OldestInstance` \|
971
+ # `OldestLaunchConfiguration` \| `OldestLaunchTemplate` \|
972
+ # `arn:aws:lambda:region:account-id:function:my-function:my-alias`
973
973
  #
974
974
  #
975
975
  #
976
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html
976
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-termination-policies.html
977
977
  #
978
978
  # @option params [Boolean] :new_instances_protected_from_scale_in
979
979
  # Indicates whether newly launched instances are protected from
@@ -992,16 +992,17 @@ module Aws::AutoScaling
992
992
  # EC2 Auto Scaling attempts to launch a Spot Instance whenever Amazon
993
993
  # EC2 notifies that a Spot Instance is at an elevated risk of
994
994
  # interruption. After launching a new instance, it then terminates an
995
- # old instance. For more information, see [Amazon EC2 Auto Scaling
996
- # Capacity Rebalancing][1] in the *Amazon EC2 Auto Scaling User Guide*.
995
+ # old instance. For more information, see [Use Capacity Rebalancing to
996
+ # handle Amazon EC2 Spot Interruptions][1] in the in the *Amazon EC2
997
+ # Auto Scaling User Guide*.
997
998
  #
998
999
  #
999
1000
  #
1000
1001
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-capacity-rebalancing.html
1001
1002
  #
1002
1003
  # @option params [Array<Types::LifecycleHookSpecification>] :lifecycle_hook_specification_list
1003
- # One or more lifecycle hooks for the group, which specify actions to
1004
- # perform when Amazon EC2 Auto Scaling launches or terminates instances.
1004
+ # One or more lifecycle hooks to add to the Auto Scaling group before
1005
+ # instances are launched.
1005
1006
  #
1006
1007
  # @option params [Array<Types::Tag>] :tags
1007
1008
  # One or more tags. You can tag your Auto Scaling group and propagate
@@ -1011,19 +1012,19 @@ module Aws::AutoScaling
1011
1012
  # template specifies an instance tag with a key that is also specified
1012
1013
  # for the Auto Scaling group, Amazon EC2 Auto Scaling overrides the
1013
1014
  # value of that instance tag with the value specified by the Auto
1014
- # Scaling group. For more information, see [Tagging Auto Scaling groups
1015
- # and instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
1015
+ # Scaling group. For more information, see [Tag Auto Scaling groups and
1016
+ # instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
1016
1017
  #
1017
1018
  #
1018
1019
  #
1019
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html
1020
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-tagging.html
1020
1021
  #
1021
1022
  # @option params [String] :service_linked_role_arn
1022
1023
  # The Amazon Resource Name (ARN) of the service-linked role that the
1023
- # Auto Scaling group uses to call other Amazon Web Services on your
1024
- # behalf. By default, Amazon EC2 Auto Scaling uses a service-linked role
1025
- # named `AWSServiceRoleForAutoScaling`, which it creates if it does not
1026
- # exist. For more information, see [Service-linked roles][1] in the
1024
+ # Auto Scaling group uses to call other Amazon Web Services service on
1025
+ # your behalf. By default, Amazon EC2 Auto Scaling uses a service-linked
1026
+ # role named `AWSServiceRoleForAutoScaling`, which it creates if it does
1027
+ # not exist. For more information, see [Service-linked roles][1] in the
1027
1028
  # *Amazon EC2 Auto Scaling User Guide*.
1028
1029
  #
1029
1030
  #
@@ -1306,15 +1307,15 @@ module Aws::AutoScaling
1306
1307
  #
1307
1308
  # If you exceed your maximum limit of launch configurations, the call
1308
1309
  # fails. To query this limit, call the DescribeAccountLimits API. For
1309
- # information about updating this limit, see [Amazon EC2 Auto Scaling
1310
- # service quotas][1] in the *Amazon EC2 Auto Scaling User Guide*.
1310
+ # information about updating this limit, see [Quotas for Amazon EC2 Auto
1311
+ # Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
1311
1312
  #
1312
1313
  # For more information, see [Launch configurations][2] in the *Amazon
1313
1314
  # EC2 Auto Scaling User Guide*.
1314
1315
  #
1315
1316
  #
1316
1317
  #
1317
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-account-limits.html
1318
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-quotas.html
1318
1319
  # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/LaunchConfiguration.html
1319
1320
  #
1320
1321
  # @option params [required, String] :launch_configuration_name
@@ -1323,42 +1324,36 @@ module Aws::AutoScaling
1323
1324
  #
1324
1325
  # @option params [String] :image_id
1325
1326
  # The ID of the Amazon Machine Image (AMI) that was assigned during
1326
- # registration. For more information, see [Finding an AMI][1] in the
1327
- # *Amazon EC2 User Guide for Linux Instances*.
1327
+ # registration. For more information, see [Finding a Linux AMI][1] in
1328
+ # the *Amazon EC2 User Guide for Linux Instances*.
1328
1329
  #
1329
- # If you do not specify `InstanceId`, you must specify `ImageId`.
1330
+ # If you specify `InstanceId`, an `ImageId` is not required.
1330
1331
  #
1331
1332
  #
1332
1333
  #
1333
1334
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html
1334
1335
  #
1335
1336
  # @option params [String] :key_name
1336
- # The name of the key pair. For more information, see [Amazon EC2 Key
1337
- # Pairs][1] in the *Amazon EC2 User Guide for Linux Instances*.
1337
+ # The name of the key pair. For more information, see [Amazon EC2 key
1338
+ # pairs and Linux instances][1] in the *Amazon EC2 User Guide for Linux
1339
+ # Instances*.
1338
1340
  #
1339
1341
  #
1340
1342
  #
1341
1343
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html
1342
1344
  #
1343
1345
  # @option params [Array<String>] :security_groups
1344
- # A list that contains the security groups to assign to the instances in
1345
- # the Auto Scaling group.
1346
- #
1347
- # \[EC2-VPC\] Specify the security group IDs. For more information, see
1348
- # [Security Groups for Your VPC][1] in the *Amazon Virtual Private Cloud
1349
- # User Guide*.
1350
- #
1351
- # \[EC2-Classic\] Specify either the security group names or the
1352
- # security group IDs. For more information, see [Amazon EC2 Security
1353
- # Groups][2] in the *Amazon EC2 User Guide for Linux Instances*.
1346
+ # A list that contains the security group IDs to assign to the instances
1347
+ # in the Auto Scaling group. For more information, see [Control traffic
1348
+ # to resources using security groups][1] in the *Amazon Virtual Private
1349
+ # Cloud User Guide*.
1354
1350
  #
1355
1351
  #
1356
1352
  #
1357
1353
  # [1]: https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_SecurityGroups.html
1358
- # [2]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-network-security.html
1359
1354
  #
1360
1355
  # @option params [String] :classic_link_vpc_id
1361
- # *EC2-Classic retires on August 15, 2022. This parameter is not
1356
+ # *EC2-Classic retires on August 15, 2022. This property is not
1362
1357
  # supported after that date.*
1363
1358
  #
1364
1359
  # The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances
@@ -1370,19 +1365,14 @@ module Aws::AutoScaling
1370
1365
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html
1371
1366
  #
1372
1367
  # @option params [Array<String>] :classic_link_vpc_security_groups
1373
- # *EC2-Classic retires on August 15, 2022. This parameter is not
1368
+ # *EC2-Classic retires on August 15, 2022. This property is not
1374
1369
  # supported after that date.*
1375
1370
  #
1376
1371
  # The IDs of one or more security groups for the specified
1377
- # ClassicLink-enabled VPC. For more information, see [ClassicLink][1] in
1378
- # the *Amazon EC2 User Guide for Linux Instances*.
1379
- #
1380
- # If you specify the `ClassicLinkVPCId` parameter, you must specify this
1381
- # parameter.
1372
+ # ClassicLink-enabled VPC.
1382
1373
  #
1383
- #
1384
- #
1385
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html
1374
+ # If you specify the `ClassicLinkVPCId` property, you must specify
1375
+ # `ClassicLinkVPCSecurityGroups`.
1386
1376
  #
1387
1377
  # @option params [String] :user_data
1388
1378
  # The user data to make available to the launched EC2 instances. For
@@ -1409,20 +1399,16 @@ module Aws::AutoScaling
1409
1399
  # For more information, see [Creating a launch configuration using an
1410
1400
  # EC2 instance][1] in the *Amazon EC2 Auto Scaling User Guide*.
1411
1401
  #
1412
- # If you do not specify `InstanceId`, you must specify both `ImageId`
1413
- # and `InstanceType`.
1414
- #
1415
1402
  #
1416
1403
  #
1417
1404
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-lc-with-instanceID.html
1418
1405
  #
1419
1406
  # @option params [String] :instance_type
1420
- # Specifies the instance type of the EC2 instance.
1421
- #
1422
- # For information about available instance types, see [Available
1423
- # Instance Types][1] in the *Amazon EC2 User Guide for Linux Instances*.
1407
+ # Specifies the instance type of the EC2 instance. For information about
1408
+ # available instance types, see [Available instance types][1] in the
1409
+ # *Amazon EC2 User Guide for Linux Instances*.
1424
1410
  #
1425
- # If you do not specify `InstanceId`, you must specify `InstanceType`.
1411
+ # If you specify `InstanceId`, an `InstanceType` is not required.
1426
1412
  #
1427
1413
  #
1428
1414
  #
@@ -1431,13 +1417,34 @@ module Aws::AutoScaling
1431
1417
  # @option params [String] :kernel_id
1432
1418
  # The ID of the kernel associated with the AMI.
1433
1419
  #
1420
+ # <note markdown="1"> We recommend that you use PV-GRUB instead of kernels and RAM disks.
1421
+ # For more information, see [User provided kernels][1] in the *Amazon
1422
+ # EC2 User Guide for Linux Instances*.
1423
+ #
1424
+ # </note>
1425
+ #
1426
+ #
1427
+ #
1428
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedKernels.html
1429
+ #
1434
1430
  # @option params [String] :ramdisk_id
1435
1431
  # The ID of the RAM disk to select.
1436
1432
  #
1433
+ # <note markdown="1"> We recommend that you use PV-GRUB instead of kernels and RAM disks.
1434
+ # For more information, see [User provided kernels][1] in the *Amazon
1435
+ # EC2 User Guide for Linux Instances*.
1436
+ #
1437
+ # </note>
1438
+ #
1439
+ #
1440
+ #
1441
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedKernels.html
1442
+ #
1437
1443
  # @option params [Array<Types::BlockDeviceMapping>] :block_device_mappings
1438
- # A block device mapping, which specifies the block devices for the
1439
- # instance. You can specify virtual devices and EBS volumes. For more
1440
- # information, see [Block Device Mapping][1] in the *Amazon EC2 User
1444
+ # The block device mapping entries that define the block devices to
1445
+ # attach to the instances at launch. By default, the block devices
1446
+ # specified in the block device mapping for the AMI are used. For more
1447
+ # information, see [Block device mappings][1] in the *Amazon EC2 User
1441
1448
  # Guide for Linux Instances*.
1442
1449
  #
1443
1450
  #
@@ -1464,8 +1471,10 @@ module Aws::AutoScaling
1464
1471
  # The maximum hourly price to be paid for any Spot Instance launched to
1465
1472
  # fulfill the request. Spot Instances are launched when the price you
1466
1473
  # specify exceeds the current Spot price. For more information, see
1467
- # [Requesting Spot Instances][1] in the *Amazon EC2 Auto Scaling User
1468
- # Guide*.
1474
+ # [Request Spot Instances for fault-tolerant and flexible
1475
+ # applications][1] in the *Amazon EC2 Auto Scaling User Guide*.
1476
+ #
1477
+ # Valid Range: Minimum value of 0.001
1469
1478
  #
1470
1479
  # <note markdown="1"> When you change your maximum price by creating a new launch
1471
1480
  # configuration, running instances will continue to run as long as the
@@ -1476,15 +1485,14 @@ module Aws::AutoScaling
1476
1485
  #
1477
1486
  #
1478
1487
  #
1479
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-launch-spot-instances.html
1488
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/launch-template-spot-instances.html
1480
1489
  #
1481
1490
  # @option params [String] :iam_instance_profile
1482
1491
  # The name or the Amazon Resource Name (ARN) of the instance profile
1483
1492
  # associated with the IAM role for the instance. The instance profile
1484
- # contains the IAM role.
1485
- #
1486
- # For more information, see [IAM role for applications that run on
1487
- # Amazon EC2 instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
1493
+ # contains the IAM role. For more information, see [IAM role for
1494
+ # applications that run on Amazon EC2 instances][1] in the *Amazon EC2
1495
+ # Auto Scaling User Guide*.
1488
1496
  #
1489
1497
  #
1490
1498
  #
@@ -1507,45 +1515,40 @@ module Aws::AutoScaling
1507
1515
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSOptimized.html
1508
1516
  #
1509
1517
  # @option params [Boolean] :associate_public_ip_address
1510
- # For Auto Scaling groups that are running in a virtual private cloud
1511
- # (VPC), specifies whether to assign a public IP address to the group's
1512
- # instances. If you specify `true`, each instance in the Auto Scaling
1513
- # group receives a unique public IP address. For more information, see
1518
+ # Specifies whether to assign a public IPv4 address to the group's
1519
+ # instances. If the instance is launched into a default subnet, the
1520
+ # default is to assign a public IPv4 address, unless you disabled the
1521
+ # option to assign a public IPv4 address on the subnet. If the instance
1522
+ # is launched into a nondefault subnet, the default is not to assign a
1523
+ # public IPv4 address, unless you enabled the option to assign a public
1524
+ # IPv4 address on the subnet.
1525
+ #
1526
+ # If you specify `true`, each instance in the Auto Scaling group
1527
+ # receives a unique public IPv4 address. For more information, see
1514
1528
  # [Launching Auto Scaling instances in a VPC][1] in the *Amazon EC2 Auto
1515
1529
  # Scaling User Guide*.
1516
1530
  #
1517
- # If you specify this parameter, you must specify at least one subnet
1518
- # for `VPCZoneIdentifier` when you create your group.
1519
- #
1520
- # <note markdown="1"> If the instance is launched into a default subnet, the default is to
1521
- # assign a public IP address, unless you disabled the option to assign a
1522
- # public IP address on the subnet. If the instance is launched into a
1523
- # nondefault subnet, the default is not to assign a public IP address,
1524
- # unless you enabled the option to assign a public IP address on the
1525
- # subnet.
1526
- #
1527
- # </note>
1531
+ # If you specify this property, you must specify at least one subnet for
1532
+ # `VPCZoneIdentifier` when you create your group.
1528
1533
  #
1529
1534
  #
1530
1535
  #
1531
1536
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html
1532
1537
  #
1533
1538
  # @option params [String] :placement_tenancy
1534
- # The tenancy of the instance. An instance with `dedicated` tenancy runs
1535
- # on isolated, single-tenant hardware and can only be launched into a
1536
- # VPC.
1537
- #
1538
- # To launch dedicated instances into a shared tenancy VPC (a VPC with
1539
- # the instance placement tenancy attribute set to `default`), you must
1540
- # set the value of this parameter to `dedicated`.
1539
+ # The tenancy of the instance, either `default` or `dedicated`. An
1540
+ # instance with `dedicated` tenancy runs on isolated, single-tenant
1541
+ # hardware and can only be launched into a VPC. To launch dedicated
1542
+ # instances into a shared tenancy VPC (a VPC with the instance placement
1543
+ # tenancy attribute set to `default`), you must set the value of this
1544
+ # property to `dedicated`. For more information, see [Configuring
1545
+ # instance tenancy with Amazon EC2 Auto Scaling][1] in the *Amazon EC2
1546
+ # Auto Scaling User Guide*.
1541
1547
  #
1542
1548
  # If you specify `PlacementTenancy`, you must specify at least one
1543
1549
  # subnet for `VPCZoneIdentifier` when you create your group.
1544
1550
  #
1545
- # For more information, see [Configuring instance tenancy with Amazon
1546
- # EC2 Auto Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
1547
- #
1548
- # Valid Values: `default` \| `dedicated`
1551
+ # Valid values: `default` \| `dedicated`
1549
1552
  #
1550
1553
  #
1551
1554
  #
@@ -1637,12 +1640,12 @@ module Aws::AutoScaling
1637
1640
  # overwrites the previous tag definition, and you do not get an error
1638
1641
  # message.
1639
1642
  #
1640
- # For more information, see [Tagging Auto Scaling groups and
1641
- # instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
1643
+ # For more information, see [Tag Auto Scaling groups and instances][1]
1644
+ # in the *Amazon EC2 Auto Scaling User Guide*.
1642
1645
  #
1643
1646
  #
1644
1647
  #
1645
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html
1648
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-tagging.html
1646
1649
  #
1647
1650
  # @option params [required, Array<Types::Tag>] :tags
1648
1651
  # One or more tags.
@@ -1720,8 +1723,8 @@ module Aws::AutoScaling
1720
1723
  # @option params [Boolean] :force_delete
1721
1724
  # Specifies that the group is to be deleted along with all instances
1722
1725
  # associated with the group, without waiting for all instances to be
1723
- # terminated. This parameter also deletes any outstanding lifecycle
1724
- # actions associated with the group.
1726
+ # terminated. This action also deletes any outstanding lifecycle actions
1727
+ # associated with the group.
1725
1728
  #
1726
1729
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1727
1730
  #
@@ -2041,12 +2044,12 @@ module Aws::AutoScaling
2041
2044
  # When you establish an Amazon Web Services account, the account has
2042
2045
  # initial quotas on the maximum number of Auto Scaling groups and launch
2043
2046
  # configurations that you can create in a given Region. For more
2044
- # information, see [Amazon EC2 Auto Scaling service quotas][1] in the
2047
+ # information, see [Quotas for Amazon EC2 Auto Scaling][1] in the
2045
2048
  # *Amazon EC2 Auto Scaling User Guide*.
2046
2049
  #
2047
2050
  #
2048
2051
  #
2049
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-account-limits.html
2052
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-quotas.html
2050
2053
  #
2051
2054
  # @return [Types::DescribeAccountLimitsAnswer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2052
2055
  #
@@ -2156,9 +2159,9 @@ module Aws::AutoScaling
2156
2159
  # @option params [Array<String>] :auto_scaling_group_names
2157
2160
  # The names of the Auto Scaling groups. By default, you can only specify
2158
2161
  # up to 50 names. You can optionally increase this limit using the
2159
- # `MaxRecords` parameter.
2162
+ # `MaxRecords` property.
2160
2163
  #
2161
- # If you omit this parameter, all Auto Scaling groups are described.
2164
+ # If you omit this property, all Auto Scaling groups are described.
2162
2165
  #
2163
2166
  # @option params [String] :next_token
2164
2167
  # The token for the next set of items to return. (You received this
@@ -2385,7 +2388,7 @@ module Aws::AutoScaling
2385
2388
  # Region.
2386
2389
  #
2387
2390
  # @option params [Array<String>] :instance_ids
2388
- # The IDs of the instances. If you omit this parameter, all Auto Scaling
2391
+ # The IDs of the instances. If you omit this property, all Auto Scaling
2389
2392
  # instances are described. If you specify an ID that does not exist, it
2390
2393
  # is ignored with no error.
2391
2394
  #
@@ -2691,7 +2694,7 @@ module Aws::AutoScaling
2691
2694
  # Region.
2692
2695
  #
2693
2696
  # @option params [Array<String>] :launch_configuration_names
2694
- # The launch configuration names. If you omit this parameter, all launch
2697
+ # The launch configuration names. If you omit this property, all launch
2695
2698
  # configurations are described.
2696
2699
  #
2697
2700
  # Array Members: Maximum number of 50 items.
@@ -2850,7 +2853,7 @@ module Aws::AutoScaling
2850
2853
  # The name of the Auto Scaling group.
2851
2854
  #
2852
2855
  # @option params [Array<String>] :lifecycle_hook_names
2853
- # The names of one or more lifecycle hooks. If you omit this parameter,
2856
+ # The names of one or more lifecycle hooks. If you omit this property,
2854
2857
  # all lifecycle hooks are described.
2855
2858
  #
2856
2859
  # @return [Types::DescribeLifecycleHooksAnswer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -2911,12 +2914,12 @@ module Aws::AutoScaling
2911
2914
  req.send_request(options)
2912
2915
  end
2913
2916
 
2914
- # Gets information about the load balancer target groups for the
2915
- # specified Auto Scaling group.
2917
+ # Gets information about the Elastic Load Balancing target groups for
2918
+ # the specified Auto Scaling group.
2916
2919
  #
2917
- # To determine the availability of registered instances, use the `State`
2918
- # element in the response. When you attach a target group to an Auto
2919
- # Scaling group, the initial `State` value is `Adding`. The state
2920
+ # To determine the attachment status of the target group, use the
2921
+ # `State` element in the response. When you attach a target group to an
2922
+ # Auto Scaling group, the initial `State` value is `Adding`. The state
2920
2923
  # transitions to `Added` after all Auto Scaling instances are registered
2921
2924
  # with the target group. If Elastic Load Balancing health checks are
2922
2925
  # enabled for the Auto Scaling group, the state transitions to
@@ -2934,8 +2937,9 @@ module Aws::AutoScaling
2934
2937
  #
2935
2938
  # For help with failed health checks, see [Troubleshooting Amazon EC2
2936
2939
  # Auto Scaling: Health checks][1] in the *Amazon EC2 Auto Scaling User
2937
- # Guide*. For more information, see [Elastic Load Balancing and Amazon
2938
- # EC2 Auto Scaling][2] in the *Amazon EC2 Auto Scaling User Guide*.
2940
+ # Guide*. For more information, see [Use Elastic Load Balancing to
2941
+ # distribute traffic across the instances in your Auto Scaling group][2]
2942
+ # in the *Amazon EC2 Auto Scaling User Guide*.
2939
2943
  #
2940
2944
  #
2941
2945
  #
@@ -3006,11 +3010,11 @@ module Aws::AutoScaling
3006
3010
  #
3007
3011
  # This operation describes only Classic Load Balancers. If you have
3008
3012
  # Application Load Balancers, Network Load Balancers, or Gateway Load
3009
- # Balancers, use the DescribeLoadBalancerTargetGroups API instead.
3013
+ # Balancer, use the DescribeLoadBalancerTargetGroups API instead.
3010
3014
  #
3011
- # To determine the availability of registered instances, use the `State`
3012
- # element in the response. When you attach a load balancer to an Auto
3013
- # Scaling group, the initial `State` value is `Adding`. The state
3015
+ # To determine the attachment status of the load balancer, use the
3016
+ # `State` element in the response. When you attach a load balancer to an
3017
+ # Auto Scaling group, the initial `State` value is `Adding`. The state
3014
3018
  # transitions to `Added` after all Auto Scaling instances are registered
3015
3019
  # with the load balancer. If Elastic Load Balancing health checks are
3016
3020
  # enabled for the Auto Scaling group, the state transitions to
@@ -3028,8 +3032,9 @@ module Aws::AutoScaling
3028
3032
  #
3029
3033
  # For help with failed health checks, see [Troubleshooting Amazon EC2
3030
3034
  # Auto Scaling: Health checks][1] in the *Amazon EC2 Auto Scaling User
3031
- # Guide*. For more information, see [Elastic Load Balancing and Amazon
3032
- # EC2 Auto Scaling][2] in the *Amazon EC2 Auto Scaling User Guide*.
3035
+ # Guide*. For more information, see [Use Elastic Load Balancing to
3036
+ # distribute traffic across the instances in your Auto Scaling group][2]
3037
+ # in the *Amazon EC2 Auto Scaling User Guide*.
3033
3038
  #
3034
3039
  #
3035
3040
  #
@@ -3098,10 +3103,6 @@ module Aws::AutoScaling
3098
3103
  # Describes the available CloudWatch metrics for Amazon EC2 Auto
3099
3104
  # Scaling.
3100
3105
  #
3101
- # The `GroupStandbyInstances` metric is not returned by default. You
3102
- # must explicitly request this metric when calling the
3103
- # EnableMetricsCollection API.
3104
- #
3105
3106
  # @return [Types::DescribeMetricCollectionTypesAnswer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3106
3107
  #
3107
3108
  # * {Types::DescribeMetricCollectionTypesAnswer#metrics #metrics} => Array&lt;Types::MetricCollectionType&gt;
@@ -3245,7 +3246,7 @@ module Aws::AutoScaling
3245
3246
  # The name of the Auto Scaling group.
3246
3247
  #
3247
3248
  # @option params [Array<String>] :policy_names
3248
- # The names of one or more policies. If you omit this parameter, all
3249
+ # The names of one or more policies. If you omit this property, all
3249
3250
  # policies are described. If a group name is provided, the results are
3250
3251
  # limited to that group. If you specify an unknown policy name, it is
3251
3252
  # ignored with no error.
@@ -3431,7 +3432,7 @@ module Aws::AutoScaling
3431
3432
  #
3432
3433
  # @option params [Array<String>] :activity_ids
3433
3434
  # The activity IDs of the desired scaling activities. If you omit this
3434
- # parameter, all activities for the past six weeks are described. If
3435
+ # property, all activities for the past six weeks are described. If
3435
3436
  # unknown activities are requested, they are ignored with no error. If
3436
3437
  # you specify an Auto Scaling group, the results are limited to that
3437
3438
  # group.
@@ -3591,19 +3592,19 @@ module Aws::AutoScaling
3591
3592
  # The name of the Auto Scaling group.
3592
3593
  #
3593
3594
  # @option params [Array<String>] :scheduled_action_names
3594
- # The names of one or more scheduled actions. If you omit this
3595
- # parameter, all scheduled actions are described. If you specify an
3596
- # unknown scheduled action, it is ignored with no error.
3595
+ # The names of one or more scheduled actions. If you omit this property,
3596
+ # all scheduled actions are described. If you specify an unknown
3597
+ # scheduled action, it is ignored with no error.
3597
3598
  #
3598
3599
  # Array Members: Maximum number of 50 actions.
3599
3600
  #
3600
3601
  # @option params [Time,DateTime,Date,Integer,String] :start_time
3601
3602
  # The earliest scheduled start time to return. If scheduled action names
3602
- # are provided, this parameter is ignored.
3603
+ # are provided, this property is ignored.
3603
3604
  #
3604
3605
  # @option params [Time,DateTime,Date,Integer,String] :end_time
3605
3606
  # The latest scheduled start time to return. If scheduled action names
3606
- # are provided, this parameter is ignored.
3607
+ # are provided, this property is ignored.
3607
3608
  #
3608
3609
  # @option params [String] :next_token
3609
3610
  # The token for the next set of items to return. (You received this
@@ -3693,12 +3694,12 @@ module Aws::AutoScaling
3693
3694
  # for a particular tag only if it matches all the filters. If there's
3694
3695
  # no match, no special message is returned.
3695
3696
  #
3696
- # For more information, see [Tagging Auto Scaling groups and
3697
- # instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
3697
+ # For more information, see [Tag Auto Scaling groups and instances][1]
3698
+ # in the *Amazon EC2 Auto Scaling User Guide*.
3698
3699
  #
3699
3700
  #
3700
3701
  #
3701
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html
3702
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-tagging.html
3702
3703
  #
3703
3704
  # @option params [Array<Types::Filter>] :filters
3704
3705
  # One or more filters to scope the tags to return. The maximum number of
@@ -3790,13 +3791,12 @@ module Aws::AutoScaling
3790
3791
  # Describes the termination policies supported by Amazon EC2 Auto
3791
3792
  # Scaling.
3792
3793
  #
3793
- # For more information, see [Controlling which Auto Scaling instances
3794
- # terminate during scale in][1] in the *Amazon EC2 Auto Scaling User
3795
- # Guide*.
3794
+ # For more information, see [Work with Amazon EC2 Auto Scaling
3795
+ # termination policies][1] in the *Amazon EC2 Auto Scaling User Guide*.
3796
3796
  #
3797
3797
  #
3798
3798
  #
3799
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html
3799
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-termination-policies.html
3800
3800
  #
3801
3801
  # @return [Types::DescribeTerminationPolicyTypesAnswer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3802
3802
  #
@@ -3999,6 +3999,12 @@ module Aws::AutoScaling
3999
3999
  # Detaches one or more target groups from the specified Auto Scaling
4000
4000
  # group.
4001
4001
  #
4002
+ # When you detach a target group, it enters the `Removing` state while
4003
+ # deregistering the instances in the group. When all instances are
4004
+ # deregistered, then you can no longer describe the target group using
4005
+ # the DescribeLoadBalancerTargetGroups API call. The instances remain
4006
+ # running.
4007
+ #
4002
4008
  # @option params [required, String] :auto_scaling_group_name
4003
4009
  # The name of the Auto Scaling group.
4004
4010
  #
@@ -4041,7 +4047,7 @@ module Aws::AutoScaling
4041
4047
  #
4042
4048
  # This operation detaches only Classic Load Balancers. If you have
4043
4049
  # Application Load Balancers, Network Load Balancers, or Gateway Load
4044
- # Balancers, use the DetachLoadBalancerTargetGroups API instead.
4050
+ # Balancer, use the DetachLoadBalancerTargetGroups API instead.
4045
4051
  #
4046
4052
  # When you detach a load balancer, it enters the `Removing` state while
4047
4053
  # deregistering the instances in the group. When all instances are
@@ -4085,13 +4091,16 @@ module Aws::AutoScaling
4085
4091
  req.send_request(options)
4086
4092
  end
4087
4093
 
4088
- # Disables group metrics for the specified Auto Scaling group.
4094
+ # Disables group metrics collection for the specified Auto Scaling
4095
+ # group.
4089
4096
  #
4090
4097
  # @option params [required, String] :auto_scaling_group_name
4091
4098
  # The name of the Auto Scaling group.
4092
4099
  #
4093
4100
  # @option params [Array<String>] :metrics
4094
- # Specifies one or more of the following metrics:
4101
+ # Identifies the metrics to disable.
4102
+ #
4103
+ # You can specify one or more of the following metrics:
4095
4104
  #
4096
4105
  # * `GroupMinSize`
4097
4106
  #
@@ -4133,7 +4142,14 @@ module Aws::AutoScaling
4133
4142
  #
4134
4143
  # * `GroupAndWarmPoolTotalCapacity`
4135
4144
  #
4136
- # If you omit this parameter, all metrics are disabled.
4145
+ # If you omit this property, all metrics are disabled.
4146
+ #
4147
+ # For more information, see [Auto Scaling group metrics][1] in the
4148
+ # *Amazon EC2 Auto Scaling User Guide*.
4149
+ #
4150
+ #
4151
+ #
4152
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-cloudwatch-monitoring.html#as-group-metrics
4137
4153
  #
4138
4154
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4139
4155
  #
@@ -4165,20 +4181,26 @@ module Aws::AutoScaling
4165
4181
  req.send_request(options)
4166
4182
  end
4167
4183
 
4168
- # Enables group metrics for the specified Auto Scaling group. For more
4169
- # information, see [Monitoring CloudWatch metrics for your Auto Scaling
4170
- # groups and instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
4184
+ # Enables group metrics collection for the specified Auto Scaling group.
4185
+ #
4186
+ # You can use these metrics to track changes in an Auto Scaling group
4187
+ # and to set alarms on threshold values. You can view group metrics
4188
+ # using the Amazon EC2 Auto Scaling console or the CloudWatch console.
4189
+ # For more information, see [Monitor CloudWatch metrics for your Auto
4190
+ # Scaling groups and instances][1] in the *Amazon EC2 Auto Scaling User
4191
+ # Guide*.
4171
4192
  #
4172
4193
  #
4173
4194
  #
4174
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-monitoring.html
4195
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-cloudwatch-monitoring.html
4175
4196
  #
4176
4197
  # @option params [required, String] :auto_scaling_group_name
4177
4198
  # The name of the Auto Scaling group.
4178
4199
  #
4179
4200
  # @option params [Array<String>] :metrics
4180
- # Specifies which group-level metrics to start collecting. You can
4181
- # specify one or more of the following metrics:
4201
+ # Identifies the metrics to enable.
4202
+ #
4203
+ # You can specify one or more of the following metrics:
4182
4204
  #
4183
4205
  # * `GroupMinSize`
4184
4206
  #
@@ -4196,9 +4218,6 @@ module Aws::AutoScaling
4196
4218
  #
4197
4219
  # * `GroupTotalInstances`
4198
4220
  #
4199
- # The instance weighting feature supports the following additional
4200
- # metrics:
4201
- #
4202
4221
  # * `GroupInServiceCapacity`
4203
4222
  #
4204
4223
  # * `GroupPendingCapacity`
@@ -4209,8 +4228,6 @@ module Aws::AutoScaling
4209
4228
  #
4210
4229
  # * `GroupTotalCapacity`
4211
4230
  #
4212
- # The warm pools feature supports the following additional metrics:
4213
- #
4214
4231
  # * `WarmPoolDesiredCapacity`
4215
4232
  #
4216
4233
  # * `WarmPoolWarmedCapacity`
@@ -4225,11 +4242,19 @@ module Aws::AutoScaling
4225
4242
  #
4226
4243
  # * `GroupAndWarmPoolTotalCapacity`
4227
4244
  #
4228
- # If you omit this parameter, all metrics are enabled.
4245
+ # If you specify `Granularity` and don't specify any metrics, all
4246
+ # metrics are enabled.
4247
+ #
4248
+ # For more information, see [Auto Scaling group metrics][1] in the
4249
+ # *Amazon EC2 Auto Scaling User Guide*.
4250
+ #
4251
+ #
4252
+ #
4253
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-cloudwatch-monitoring.html#as-group-metrics
4229
4254
  #
4230
4255
  # @option params [required, String] :granularity
4231
- # The granularity to associate with the metrics to collect. The only
4232
- # valid value is `1Minute`.
4256
+ # The frequency at which Amazon EC2 Auto Scaling sends aggregated data
4257
+ # to CloudWatch. The only valid value is `1Minute`.
4233
4258
  #
4234
4259
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4235
4260
  #
@@ -4683,12 +4708,14 @@ module Aws::AutoScaling
4683
4708
  # The name of the Auto Scaling group.
4684
4709
  #
4685
4710
  # @option params [String] :lifecycle_transition
4686
- # The instance state to which you want to attach the lifecycle hook. The
4687
- # valid values are:
4711
+ # The lifecycle transition. For Auto Scaling groups, there are two major
4712
+ # lifecycle transitions.
4688
4713
  #
4689
- # * autoscaling:EC2\_INSTANCE\_LAUNCHING
4714
+ # * To create a lifecycle hook for scale-out events, specify
4715
+ # `autoscaling:EC2_INSTANCE_LAUNCHING`.
4690
4716
  #
4691
- # * autoscaling:EC2\_INSTANCE\_TERMINATING
4717
+ # * To create a lifecycle hook for scale-in events, specify
4718
+ # `autoscaling:EC2_INSTANCE_TERMINATING`.
4692
4719
  #
4693
4720
  # Required for new lifecycle hooks, but optional when updating existing
4694
4721
  # hooks.
@@ -4702,10 +4729,10 @@ module Aws::AutoScaling
4702
4729
  # updating existing hooks.
4703
4730
  #
4704
4731
  # @option params [String] :notification_target_arn
4705
- # The ARN of the notification target that Amazon EC2 Auto Scaling uses
4706
- # to notify you when an instance is in the transition state for the
4707
- # lifecycle hook. This target can be either an SQS queue or an SNS
4708
- # topic.
4732
+ # The Amazon Resource Name (ARN) of the notification target that Amazon
4733
+ # EC2 Auto Scaling uses to notify you when an instance is in a wait
4734
+ # state for the lifecycle hook. You can specify either an Amazon SNS
4735
+ # topic or an Amazon SQS queue.
4709
4736
  #
4710
4737
  # If you specify an empty string, this overrides the current ARN.
4711
4738
  #
@@ -4726,16 +4753,12 @@ module Aws::AutoScaling
4726
4753
  # hook times out. The range is from `30` to `7200` seconds. The default
4727
4754
  # value is `3600` seconds (1 hour).
4728
4755
  #
4729
- # If the lifecycle hook times out, Amazon EC2 Auto Scaling performs the
4730
- # action that you specified in the `DefaultResult` parameter. You can
4731
- # prevent the lifecycle hook from timing out by calling the
4732
- # RecordLifecycleActionHeartbeat API.
4733
- #
4734
4756
  # @option params [String] :default_result
4735
- # Defines the action the Auto Scaling group should take when the
4736
- # lifecycle hook timeout elapses or if an unexpected failure occurs.
4737
- # This parameter can be either `CONTINUE` or `ABANDON`. The default
4738
- # value is `ABANDON`.
4757
+ # The action the Auto Scaling group takes when the lifecycle hook
4758
+ # timeout elapses or if an unexpected failure occurs. The default value
4759
+ # is `ABANDON`.
4760
+ #
4761
+ # Valid values: `CONTINUE` \| `ABANDON`
4739
4762
  #
4740
4763
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4741
4764
  #
@@ -4986,7 +5009,7 @@ module Aws::AutoScaling
4986
5009
  # * `ALBRequestCountPerTarget`
4987
5010
  #
4988
5011
  # If you specify `ALBRequestCountPerTarget` for the metric, you must
4989
- # specify the `ResourceLabel` parameter with the
5012
+ # specify the `ResourceLabel` property with the
4990
5013
  # `PredefinedMetricSpecification`.
4991
5014
  #
4992
5015
  # For more information, see [TargetTrackingConfiguration][1] in the
@@ -5227,6 +5250,9 @@ module Aws::AutoScaling
5227
5250
  # scheduled action, you can delete it by calling the
5228
5251
  # DeleteScheduledAction API.
5229
5252
  #
5253
+ # If you try to schedule your action in the past, Amazon EC2 Auto
5254
+ # Scaling returns an error message.
5255
+ #
5230
5256
  #
5231
5257
  #
5232
5258
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/schedule_time.html
@@ -5238,22 +5264,20 @@ module Aws::AutoScaling
5238
5264
  # The name of this scaling action.
5239
5265
  #
5240
5266
  # @option params [Time,DateTime,Date,Integer,String] :time
5241
- # This parameter is no longer used.
5267
+ # This property is no longer used.
5242
5268
  #
5243
5269
  # @option params [Time,DateTime,Date,Integer,String] :start_time
5244
5270
  # The date and time for this action to start, in YYYY-MM-DDThh:mm:ssZ
5245
5271
  # format in UTC/GMT only and in quotes (for example,
5246
- # `"2019-06-01T00:00:00Z"`).
5272
+ # `"2021-06-01T00:00:00Z"`).
5247
5273
  #
5248
5274
  # If you specify `Recurrence` and `StartTime`, Amazon EC2 Auto Scaling
5249
5275
  # performs the action at this time, and then performs the action based
5250
5276
  # on the specified recurrence.
5251
5277
  #
5252
- # If you try to schedule your action in the past, Amazon EC2 Auto
5253
- # Scaling returns an error message.
5254
- #
5255
5278
  # @option params [Time,DateTime,Date,Integer,String] :end_time
5256
- # The date and time for the recurring schedule to end, in UTC.
5279
+ # The date and time for the recurring schedule to end, in UTC. For
5280
+ # example, `"2021-06-01T00:00:00Z"`.
5257
5281
  #
5258
5282
  # @option params [String] :recurrence
5259
5283
  # The recurring schedule for this action. This format consists of five
@@ -5283,6 +5307,11 @@ module Aws::AutoScaling
5283
5307
  # maintain. It can scale beyond this capacity if you add more scaling
5284
5308
  # conditions.
5285
5309
  #
5310
+ # <note markdown="1"> You must specify at least one of the following properties: `MaxSize`,
5311
+ # `MinSize`, or `DesiredCapacity`.
5312
+ #
5313
+ # </note>
5314
+ #
5286
5315
  # @option params [String] :time_zone
5287
5316
  # Specifies the time zone for a cron expression. If a time zone is not
5288
5317
  # provided, UTC is used by default.
@@ -5552,7 +5581,7 @@ module Aws::AutoScaling
5552
5581
  #
5553
5582
  # * `ScheduledActions`
5554
5583
  #
5555
- # If you omit this parameter, all processes are specified.
5584
+ # If you omit this property, all processes are specified.
5556
5585
  #
5557
5586
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
5558
5587
  #
@@ -6009,7 +6038,7 @@ module Aws::AutoScaling
6009
6038
  #
6010
6039
  # * `ScheduledActions`
6011
6040
  #
6012
- # If you omit this parameter, all processes are specified.
6041
+ # If you omit this property, all processes are specified.
6013
6042
  #
6014
6043
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
6015
6044
  #
@@ -6126,7 +6155,7 @@ module Aws::AutoScaling
6126
6155
  # Updates the configuration for the specified Auto Scaling group.
6127
6156
  #
6128
6157
  # To update an Auto Scaling group, specify the name of the group and the
6129
- # parameter that you want to change. Any parameters that you don't
6158
+ # property that you want to change. Any properties that you don't
6130
6159
  # specify are not changed by this update request. The new settings take
6131
6160
  # effect on any scaling activities after this call returns.
6132
6161
  #
@@ -6162,7 +6191,7 @@ module Aws::AutoScaling
6162
6191
  # current size of the group, this sets the group's `DesiredCapacity`
6163
6192
  # to the new `MaxSize` value.
6164
6193
  #
6165
- # To see which parameters have been set, call the
6194
+ # To see which properties have been set, call the
6166
6195
  # DescribeAutoScalingGroups API. To view the scaling policies for an
6167
6196
  # Auto Scaling group, call the DescribePolicies API. If the group has
6168
6197
  # scaling policies, you can update them by calling the PutScalingPolicy
@@ -6264,19 +6293,22 @@ module Aws::AutoScaling
6264
6293
  # @option params [String] :vpc_zone_identifier
6265
6294
  # A comma-separated list of subnet IDs for a virtual private cloud
6266
6295
  # (VPC). If you specify `VPCZoneIdentifier` with `AvailabilityZones`,
6267
- # the subnets that you specify for this parameter must reside in those
6268
- # Availability Zones.
6296
+ # the subnets that you specify must reside in those Availability Zones.
6269
6297
  #
6270
6298
  # @option params [Array<String>] :termination_policies
6271
6299
  # A policy or a list of policies that are used to select the instances
6272
6300
  # to terminate. The policies are executed in the order that you list
6273
- # them. For more information, see [Controlling which Auto Scaling
6274
- # instances terminate during scale in][1] in the *Amazon EC2 Auto
6275
- # Scaling User Guide*.
6301
+ # them. For more information, see [Work with Amazon EC2 Auto Scaling
6302
+ # termination policies][1] in the *Amazon EC2 Auto Scaling User Guide*.
6276
6303
  #
6304
+ # Valid values: `Default` \| `AllocationStrategy` \|
6305
+ # `ClosestToNextInstanceHour` \| `NewestInstance` \| `OldestInstance` \|
6306
+ # `OldestLaunchConfiguration` \| `OldestLaunchTemplate` \|
6307
+ # `arn:aws:lambda:region:account-id:function:my-function:my-alias`
6277
6308
  #
6278
6309
  #
6279
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html
6310
+ #
6311
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-termination-policies.html
6280
6312
  #
6281
6313
  # @option params [Boolean] :new_instances_protected_from_scale_in
6282
6314
  # Indicates whether newly launched instances are protected from
@@ -6313,8 +6345,8 @@ module Aws::AutoScaling
6313
6345
  #
6314
6346
  # @option params [Boolean] :capacity_rebalance
6315
6347
  # Enables or disables Capacity Rebalancing. For more information, see
6316
- # [Amazon EC2 Auto Scaling Capacity Rebalancing][1] in the *Amazon EC2
6317
- # Auto Scaling User Guide*.
6348
+ # [Use Capacity Rebalancing to handle Amazon EC2 Spot Interruptions][1]
6349
+ # in the *Amazon EC2 Auto Scaling User Guide*.
6318
6350
  #
6319
6351
  #
6320
6352
  #
@@ -6507,7 +6539,7 @@ module Aws::AutoScaling
6507
6539
  params: params,
6508
6540
  config: config)
6509
6541
  context[:gem_name] = 'aws-sdk-autoscaling'
6510
- context[:gem_version] = '1.79.0'
6542
+ context[:gem_version] = '1.80.0'
6511
6543
  Seahorse::Client::Request.new(handlers, context)
6512
6544
  end
6513
6545