aws-sdk-autoscaling 1.79.0 → 1.81.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.
@@ -30,7 +30,7 @@ require 'aws-sdk-core/plugins/http_checksum.rb'
30
30
  require 'aws-sdk-core/plugins/checksum_algorithm.rb'
31
31
  require 'aws-sdk-core/plugins/defaults_mode.rb'
32
32
  require 'aws-sdk-core/plugins/recursion_detection.rb'
33
- require 'aws-sdk-core/plugins/signature_v4.rb'
33
+ require 'aws-sdk-core/plugins/sign.rb'
34
34
  require 'aws-sdk-core/plugins/protocols/query.rb'
35
35
 
36
36
  Aws::Plugins::GlobalConfiguration.add_identifier(:autoscaling)
@@ -79,8 +79,9 @@ module Aws::AutoScaling
79
79
  add_plugin(Aws::Plugins::ChecksumAlgorithm)
80
80
  add_plugin(Aws::Plugins::DefaultsMode)
81
81
  add_plugin(Aws::Plugins::RecursionDetection)
82
- add_plugin(Aws::Plugins::SignatureV4)
82
+ add_plugin(Aws::Plugins::Sign)
83
83
  add_plugin(Aws::Plugins::Protocols::Query)
84
+ add_plugin(Aws::AutoScaling::Plugins::Endpoints)
84
85
 
85
86
  # @overload initialize(options)
86
87
  # @param [Hash] options
@@ -287,6 +288,19 @@ module Aws::AutoScaling
287
288
  # ** Please note ** When response stubbing is enabled, no HTTP
288
289
  # requests are made, and retries are disabled.
289
290
  #
291
+ # @option options [Aws::TokenProvider] :token_provider
292
+ # A Bearer Token Provider. This can be an instance of any one of the
293
+ # following classes:
294
+ #
295
+ # * `Aws::StaticTokenProvider` - Used for configuring static, non-refreshing
296
+ # tokens.
297
+ #
298
+ # * `Aws::SSOTokenProvider` - Used for loading tokens from AWS SSO using an
299
+ # access token generated from `aws login`.
300
+ #
301
+ # When `:token_provider` is not configured directly, the `Aws::TokenProviderChain`
302
+ # will be used to search for tokens configured for your profile in shared configuration files.
303
+ #
290
304
  # @option options [Boolean] :use_dualstack_endpoint
291
305
  # When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
292
306
  # will be used if available.
@@ -300,6 +314,9 @@ module Aws::AutoScaling
300
314
  # When `true`, request parameters are validated before
301
315
  # sending the request.
302
316
  #
317
+ # @option options [Aws::AutoScaling::EndpointProvider] :endpoint_provider
318
+ # The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::AutoScaling::EndpointParameters`
319
+ #
303
320
  # @option options [URI::HTTP,String] :http_proxy A proxy to send
304
321
  # requests through. Formatted like 'http://proxy.com:123'.
305
322
  #
@@ -428,8 +445,9 @@ module Aws::AutoScaling
428
445
  # This operation is additive and does not detach existing target groups
429
446
  # or Classic Load Balancers from the Auto Scaling group.
430
447
  #
431
- # For more information, see [Elastic Load Balancing and Amazon EC2 Auto
432
- # Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
448
+ # For more information, see [Use Elastic Load Balancing to distribute
449
+ # traffic across the instances in your Auto Scaling group][1] in the
450
+ # *Amazon EC2 Auto Scaling User Guide*.
433
451
  #
434
452
  #
435
453
  #
@@ -488,14 +506,15 @@ module Aws::AutoScaling
488
506
  # with these Classic Load Balancers.
489
507
  #
490
508
  # To describe the load balancers for an Auto Scaling group, call the
491
- # DescribeLoadBalancers API. To detach the load balancer from the Auto
509
+ # DescribeLoadBalancers API. To detach a load balancer from the Auto
492
510
  # Scaling group, call the DetachLoadBalancers API.
493
511
  #
494
512
  # This operation is additive and does not detach existing Classic Load
495
513
  # Balancers or target groups from the Auto Scaling group.
496
514
  #
497
- # For more information, see [Elastic Load Balancing and Amazon EC2 Auto
498
- # Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
515
+ # For more information, see [Use Elastic Load Balancing to distribute
516
+ # traffic across the instances in your Auto Scaling group][1] in the
517
+ # *Amazon EC2 Auto Scaling User Guide*.
499
518
  #
500
519
  #
501
520
  #
@@ -722,8 +741,8 @@ module Aws::AutoScaling
722
741
  # created the lifecycle hook.
723
742
  #
724
743
  # @option params [required, String] :lifecycle_action_result
725
- # The action for the group to take. This parameter can be either
726
- # `CONTINUE` or `ABANDON`.
744
+ # The action for the group to take. You can specify either `CONTINUE` or
745
+ # `ABANDON`.
727
746
  #
728
747
  # @option params [String] :instance_id
729
748
  # The ID of the instance.
@@ -770,8 +789,8 @@ module Aws::AutoScaling
770
789
  #
771
790
  # If you exceed your maximum limit of Auto Scaling groups, the call
772
791
  # 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*.
792
+ # information about updating this limit, see [Quotas for Amazon EC2 Auto
793
+ # Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
775
794
  #
776
795
  # For introductory exercises for creating an Auto Scaling group, see
777
796
  # [Getting started with Amazon EC2 Auto Scaling][2] and [Tutorial: Set
@@ -779,7 +798,7 @@ module Aws::AutoScaling
779
798
  # Scaling User Guide*. For more information, see [Auto Scaling
780
799
  # groups][4] in the *Amazon EC2 Auto Scaling User Guide*.
781
800
  #
782
- # Every Auto Scaling group has three size parameters (`DesiredCapacity`,
801
+ # Every Auto Scaling group has three size properties (`DesiredCapacity`,
783
802
  # `MaxSize`, and `MinSize`). Usually, you set these sizes based on a
784
803
  # specific number of instances. However, if you configure a mixed
785
804
  # instances policy that defines weights for the instance types, you must
@@ -788,7 +807,7 @@ module Aws::AutoScaling
788
807
  #
789
808
  #
790
809
  #
791
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-account-limits.html
810
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-quotas.html
792
811
  # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/GettingStartedTutorial.html
793
812
  # [3]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-register-lbs-with-asg.html
794
813
  # [4]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/AutoScalingGroup.html
@@ -805,7 +824,7 @@ module Aws::AutoScaling
805
824
  # (`LaunchConfigurationName` or `InstanceId`).
806
825
  #
807
826
  # @option params [Types::LaunchTemplateSpecification] :launch_template
808
- # Parameters used to specify the launch template and version to use to
827
+ # Information used to specify the launch template and version to use to
809
828
  # launch instances.
810
829
  #
811
830
  # Conditional: You must specify either a launch template
@@ -887,24 +906,24 @@ module Aws::AutoScaling
887
906
  #
888
907
  # @option params [Array<String>] :availability_zones
889
908
  # 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.
909
+ # can be created. Used for launching into the default VPC subnet in each
910
+ # Availability Zone when not using the `VPCZoneIdentifier` property, or
911
+ # for attaching a network interface when an existing network interface
912
+ # ID is specified in a launch template.
895
913
  #
896
914
  # @option params [Array<String>] :load_balancer_names
897
915
  # A list of Classic Load Balancers associated with this Auto Scaling
898
916
  # group. For Application Load Balancers, Network Load Balancers, and
899
- # Gateway Load Balancers, specify the `TargetGroupARNs` property
900
- # instead.
917
+ # Gateway Load Balancer, specify the `TargetGroupARNs` property instead.
901
918
  #
902
919
  # @option params [Array<String>] :target_group_arns
903
920
  # 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*.
921
+ # the Auto Scaling group. Instances are registered as targets with the
922
+ # target groups. The target groups receive incoming traffic and route
923
+ # requests to one or more registered targets. For more information, see
924
+ # [Use Elastic Load Balancing to distribute traffic across the instances
925
+ # in your Auto Scaling group][1] in the *Amazon EC2 Auto Scaling User
926
+ # Guide*.
908
927
  #
909
928
  #
910
929
  #
@@ -923,8 +942,6 @@ module Aws::AutoScaling
923
942
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html
924
943
  #
925
944
  # @option params [Integer] :health_check_grace_period
926
- # **
927
- #
928
945
  # The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
929
946
  # before checking the health status of an EC2 instance that has come
930
947
  # into service and marking it unhealthy due to a failed Elastic Load
@@ -940,9 +957,9 @@ module Aws::AutoScaling
940
957
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html#health-check-grace-period
941
958
  #
942
959
  # @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*.
960
+ # The name of the placement group into which to launch your instances.
961
+ # For more information, see [Placement groups][1] in the *Amazon EC2
962
+ # User Guide for Linux Instances*.
946
963
  #
947
964
  # <note markdown="1"> A *cluster* placement group is a logical grouping of instances within
948
965
  # a single Availability Zone. You cannot specify multiple Availability
@@ -958,22 +975,22 @@ module Aws::AutoScaling
958
975
  # A comma-separated list of subnet IDs for a virtual private cloud (VPC)
959
976
  # where instances in the Auto Scaling group can be created. If you
960
977
  # 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.
978
+ # you specify must reside in those Availability Zones.
966
979
  #
967
980
  # @option params [Array<String>] :termination_policies
968
981
  # A policy or a list of policies that are used to select the instance to
969
982
  # 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*.
983
+ # them. For more information, see [Work with Amazon EC2 Auto Scaling
984
+ # termination policies][1] in the *Amazon EC2 Auto Scaling User Guide*.
985
+ #
986
+ # Valid values: `Default` \| `AllocationStrategy` \|
987
+ # `ClosestToNextInstanceHour` \| `NewestInstance` \| `OldestInstance` \|
988
+ # `OldestLaunchConfiguration` \| `OldestLaunchTemplate` \|
989
+ # `arn:aws:lambda:region:account-id:function:my-function:my-alias`
973
990
  #
974
991
  #
975
992
  #
976
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html
993
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-termination-policies.html
977
994
  #
978
995
  # @option params [Boolean] :new_instances_protected_from_scale_in
979
996
  # Indicates whether newly launched instances are protected from
@@ -992,16 +1009,17 @@ module Aws::AutoScaling
992
1009
  # EC2 Auto Scaling attempts to launch a Spot Instance whenever Amazon
993
1010
  # EC2 notifies that a Spot Instance is at an elevated risk of
994
1011
  # 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*.
1012
+ # old instance. For more information, see [Use Capacity Rebalancing to
1013
+ # handle Amazon EC2 Spot Interruptions][1] in the in the *Amazon EC2
1014
+ # Auto Scaling User Guide*.
997
1015
  #
998
1016
  #
999
1017
  #
1000
1018
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-capacity-rebalancing.html
1001
1019
  #
1002
1020
  # @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.
1021
+ # One or more lifecycle hooks to add to the Auto Scaling group before
1022
+ # instances are launched.
1005
1023
  #
1006
1024
  # @option params [Array<Types::Tag>] :tags
1007
1025
  # One or more tags. You can tag your Auto Scaling group and propagate
@@ -1011,19 +1029,19 @@ module Aws::AutoScaling
1011
1029
  # template specifies an instance tag with a key that is also specified
1012
1030
  # for the Auto Scaling group, Amazon EC2 Auto Scaling overrides the
1013
1031
  # 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*.
1032
+ # Scaling group. For more information, see [Tag Auto Scaling groups and
1033
+ # instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
1016
1034
  #
1017
1035
  #
1018
1036
  #
1019
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html
1037
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-tagging.html
1020
1038
  #
1021
1039
  # @option params [String] :service_linked_role_arn
1022
1040
  # 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
1041
+ # Auto Scaling group uses to call other Amazon Web Services service on
1042
+ # your behalf. By default, Amazon EC2 Auto Scaling uses a service-linked
1043
+ # role named `AWSServiceRoleForAutoScaling`, which it creates if it does
1044
+ # not exist. For more information, see [Service-linked roles][1] in the
1027
1045
  # *Amazon EC2 Auto Scaling User Guide*.
1028
1046
  #
1029
1047
  #
@@ -1306,15 +1324,15 @@ module Aws::AutoScaling
1306
1324
  #
1307
1325
  # If you exceed your maximum limit of launch configurations, the call
1308
1326
  # 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*.
1327
+ # information about updating this limit, see [Quotas for Amazon EC2 Auto
1328
+ # Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
1311
1329
  #
1312
1330
  # For more information, see [Launch configurations][2] in the *Amazon
1313
1331
  # EC2 Auto Scaling User Guide*.
1314
1332
  #
1315
1333
  #
1316
1334
  #
1317
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-account-limits.html
1335
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-quotas.html
1318
1336
  # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/LaunchConfiguration.html
1319
1337
  #
1320
1338
  # @option params [required, String] :launch_configuration_name
@@ -1323,42 +1341,36 @@ module Aws::AutoScaling
1323
1341
  #
1324
1342
  # @option params [String] :image_id
1325
1343
  # 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*.
1344
+ # registration. For more information, see [Finding a Linux AMI][1] in
1345
+ # the *Amazon EC2 User Guide for Linux Instances*.
1328
1346
  #
1329
- # If you do not specify `InstanceId`, you must specify `ImageId`.
1347
+ # If you specify `InstanceId`, an `ImageId` is not required.
1330
1348
  #
1331
1349
  #
1332
1350
  #
1333
1351
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html
1334
1352
  #
1335
1353
  # @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*.
1354
+ # The name of the key pair. For more information, see [Amazon EC2 key
1355
+ # pairs and Linux instances][1] in the *Amazon EC2 User Guide for Linux
1356
+ # Instances*.
1338
1357
  #
1339
1358
  #
1340
1359
  #
1341
1360
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html
1342
1361
  #
1343
1362
  # @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*.
1363
+ # A list that contains the security group IDs to assign to the instances
1364
+ # in the Auto Scaling group. For more information, see [Control traffic
1365
+ # to resources using security groups][1] in the *Amazon Virtual Private
1366
+ # Cloud User Guide*.
1354
1367
  #
1355
1368
  #
1356
1369
  #
1357
1370
  # [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
1371
  #
1360
1372
  # @option params [String] :classic_link_vpc_id
1361
- # *EC2-Classic retires on August 15, 2022. This parameter is not
1373
+ # *EC2-Classic retires on August 15, 2022. This property is not
1362
1374
  # supported after that date.*
1363
1375
  #
1364
1376
  # The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances
@@ -1370,19 +1382,14 @@ module Aws::AutoScaling
1370
1382
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html
1371
1383
  #
1372
1384
  # @option params [Array<String>] :classic_link_vpc_security_groups
1373
- # *EC2-Classic retires on August 15, 2022. This parameter is not
1385
+ # *EC2-Classic retires on August 15, 2022. This property is not
1374
1386
  # supported after that date.*
1375
1387
  #
1376
1388
  # 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*.
1389
+ # ClassicLink-enabled VPC.
1379
1390
  #
1380
- # If you specify the `ClassicLinkVPCId` parameter, you must specify this
1381
- # parameter.
1382
- #
1383
- #
1384
- #
1385
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html
1391
+ # If you specify the `ClassicLinkVPCId` property, you must specify
1392
+ # `ClassicLinkVPCSecurityGroups`.
1386
1393
  #
1387
1394
  # @option params [String] :user_data
1388
1395
  # The user data to make available to the launched EC2 instances. For
@@ -1409,20 +1416,16 @@ module Aws::AutoScaling
1409
1416
  # For more information, see [Creating a launch configuration using an
1410
1417
  # EC2 instance][1] in the *Amazon EC2 Auto Scaling User Guide*.
1411
1418
  #
1412
- # If you do not specify `InstanceId`, you must specify both `ImageId`
1413
- # and `InstanceType`.
1414
- #
1415
1419
  #
1416
1420
  #
1417
1421
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-lc-with-instanceID.html
1418
1422
  #
1419
1423
  # @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*.
1424
+ # Specifies the instance type of the EC2 instance. For information about
1425
+ # available instance types, see [Available instance types][1] in the
1426
+ # *Amazon EC2 User Guide for Linux Instances*.
1424
1427
  #
1425
- # If you do not specify `InstanceId`, you must specify `InstanceType`.
1428
+ # If you specify `InstanceId`, an `InstanceType` is not required.
1426
1429
  #
1427
1430
  #
1428
1431
  #
@@ -1431,13 +1434,34 @@ module Aws::AutoScaling
1431
1434
  # @option params [String] :kernel_id
1432
1435
  # The ID of the kernel associated with the AMI.
1433
1436
  #
1437
+ # <note markdown="1"> We recommend that you use PV-GRUB instead of kernels and RAM disks.
1438
+ # For more information, see [User provided kernels][1] in the *Amazon
1439
+ # EC2 User Guide for Linux Instances*.
1440
+ #
1441
+ # </note>
1442
+ #
1443
+ #
1444
+ #
1445
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedKernels.html
1446
+ #
1434
1447
  # @option params [String] :ramdisk_id
1435
1448
  # The ID of the RAM disk to select.
1436
1449
  #
1450
+ # <note markdown="1"> We recommend that you use PV-GRUB instead of kernels and RAM disks.
1451
+ # For more information, see [User provided kernels][1] in the *Amazon
1452
+ # EC2 User Guide for Linux Instances*.
1453
+ #
1454
+ # </note>
1455
+ #
1456
+ #
1457
+ #
1458
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedKernels.html
1459
+ #
1437
1460
  # @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
1461
+ # The block device mapping entries that define the block devices to
1462
+ # attach to the instances at launch. By default, the block devices
1463
+ # specified in the block device mapping for the AMI are used. For more
1464
+ # information, see [Block device mappings][1] in the *Amazon EC2 User
1441
1465
  # Guide for Linux Instances*.
1442
1466
  #
1443
1467
  #
@@ -1464,8 +1488,10 @@ module Aws::AutoScaling
1464
1488
  # The maximum hourly price to be paid for any Spot Instance launched to
1465
1489
  # fulfill the request. Spot Instances are launched when the price you
1466
1490
  # specify exceeds the current Spot price. For more information, see
1467
- # [Requesting Spot Instances][1] in the *Amazon EC2 Auto Scaling User
1468
- # Guide*.
1491
+ # [Request Spot Instances for fault-tolerant and flexible
1492
+ # applications][1] in the *Amazon EC2 Auto Scaling User Guide*.
1493
+ #
1494
+ # Valid Range: Minimum value of 0.001
1469
1495
  #
1470
1496
  # <note markdown="1"> When you change your maximum price by creating a new launch
1471
1497
  # configuration, running instances will continue to run as long as the
@@ -1476,15 +1502,14 @@ module Aws::AutoScaling
1476
1502
  #
1477
1503
  #
1478
1504
  #
1479
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-launch-spot-instances.html
1505
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/launch-template-spot-instances.html
1480
1506
  #
1481
1507
  # @option params [String] :iam_instance_profile
1482
1508
  # The name or the Amazon Resource Name (ARN) of the instance profile
1483
1509
  # 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*.
1510
+ # contains the IAM role. For more information, see [IAM role for
1511
+ # applications that run on Amazon EC2 instances][1] in the *Amazon EC2
1512
+ # Auto Scaling User Guide*.
1488
1513
  #
1489
1514
  #
1490
1515
  #
@@ -1507,45 +1532,40 @@ module Aws::AutoScaling
1507
1532
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSOptimized.html
1508
1533
  #
1509
1534
  # @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
1535
+ # Specifies whether to assign a public IPv4 address to the group's
1536
+ # instances. If the instance is launched into a default subnet, the
1537
+ # default is to assign a public IPv4 address, unless you disabled the
1538
+ # option to assign a public IPv4 address on the subnet. If the instance
1539
+ # is launched into a nondefault subnet, the default is not to assign a
1540
+ # public IPv4 address, unless you enabled the option to assign a public
1541
+ # IPv4 address on the subnet.
1542
+ #
1543
+ # If you specify `true`, each instance in the Auto Scaling group
1544
+ # receives a unique public IPv4 address. For more information, see
1514
1545
  # [Launching Auto Scaling instances in a VPC][1] in the *Amazon EC2 Auto
1515
1546
  # Scaling User Guide*.
1516
1547
  #
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>
1548
+ # If you specify this property, you must specify at least one subnet for
1549
+ # `VPCZoneIdentifier` when you create your group.
1528
1550
  #
1529
1551
  #
1530
1552
  #
1531
1553
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html
1532
1554
  #
1533
1555
  # @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`.
1556
+ # The tenancy of the instance, either `default` or `dedicated`. An
1557
+ # instance with `dedicated` tenancy runs on isolated, single-tenant
1558
+ # hardware and can only be launched into a VPC. To launch dedicated
1559
+ # instances into a shared tenancy VPC (a VPC with the instance placement
1560
+ # tenancy attribute set to `default`), you must set the value of this
1561
+ # property to `dedicated`. For more information, see [Configuring
1562
+ # instance tenancy with Amazon EC2 Auto Scaling][1] in the *Amazon EC2
1563
+ # Auto Scaling User Guide*.
1541
1564
  #
1542
1565
  # If you specify `PlacementTenancy`, you must specify at least one
1543
1566
  # subnet for `VPCZoneIdentifier` when you create your group.
1544
1567
  #
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`
1568
+ # Valid values: `default` \| `dedicated`
1549
1569
  #
1550
1570
  #
1551
1571
  #
@@ -1637,12 +1657,12 @@ module Aws::AutoScaling
1637
1657
  # overwrites the previous tag definition, and you do not get an error
1638
1658
  # message.
1639
1659
  #
1640
- # For more information, see [Tagging Auto Scaling groups and
1641
- # instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
1660
+ # For more information, see [Tag Auto Scaling groups and instances][1]
1661
+ # in the *Amazon EC2 Auto Scaling User Guide*.
1642
1662
  #
1643
1663
  #
1644
1664
  #
1645
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html
1665
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-tagging.html
1646
1666
  #
1647
1667
  # @option params [required, Array<Types::Tag>] :tags
1648
1668
  # One or more tags.
@@ -1720,8 +1740,8 @@ module Aws::AutoScaling
1720
1740
  # @option params [Boolean] :force_delete
1721
1741
  # Specifies that the group is to be deleted along with all instances
1722
1742
  # 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.
1743
+ # terminated. This action also deletes any outstanding lifecycle actions
1744
+ # associated with the group.
1725
1745
  #
1726
1746
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1727
1747
  #
@@ -2041,12 +2061,12 @@ module Aws::AutoScaling
2041
2061
  # When you establish an Amazon Web Services account, the account has
2042
2062
  # initial quotas on the maximum number of Auto Scaling groups and launch
2043
2063
  # configurations that you can create in a given Region. For more
2044
- # information, see [Amazon EC2 Auto Scaling service quotas][1] in the
2064
+ # information, see [Quotas for Amazon EC2 Auto Scaling][1] in the
2045
2065
  # *Amazon EC2 Auto Scaling User Guide*.
2046
2066
  #
2047
2067
  #
2048
2068
  #
2049
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-account-limits.html
2069
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-quotas.html
2050
2070
  #
2051
2071
  # @return [Types::DescribeAccountLimitsAnswer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2052
2072
  #
@@ -2156,9 +2176,9 @@ module Aws::AutoScaling
2156
2176
  # @option params [Array<String>] :auto_scaling_group_names
2157
2177
  # The names of the Auto Scaling groups. By default, you can only specify
2158
2178
  # up to 50 names. You can optionally increase this limit using the
2159
- # `MaxRecords` parameter.
2179
+ # `MaxRecords` property.
2160
2180
  #
2161
- # If you omit this parameter, all Auto Scaling groups are described.
2181
+ # If you omit this property, all Auto Scaling groups are described.
2162
2182
  #
2163
2183
  # @option params [String] :next_token
2164
2184
  # The token for the next set of items to return. (You received this
@@ -2385,7 +2405,7 @@ module Aws::AutoScaling
2385
2405
  # Region.
2386
2406
  #
2387
2407
  # @option params [Array<String>] :instance_ids
2388
- # The IDs of the instances. If you omit this parameter, all Auto Scaling
2408
+ # The IDs of the instances. If you omit this property, all Auto Scaling
2389
2409
  # instances are described. If you specify an ID that does not exist, it
2390
2410
  # is ignored with no error.
2391
2411
  #
@@ -2691,7 +2711,7 @@ module Aws::AutoScaling
2691
2711
  # Region.
2692
2712
  #
2693
2713
  # @option params [Array<String>] :launch_configuration_names
2694
- # The launch configuration names. If you omit this parameter, all launch
2714
+ # The launch configuration names. If you omit this property, all launch
2695
2715
  # configurations are described.
2696
2716
  #
2697
2717
  # Array Members: Maximum number of 50 items.
@@ -2850,7 +2870,7 @@ module Aws::AutoScaling
2850
2870
  # The name of the Auto Scaling group.
2851
2871
  #
2852
2872
  # @option params [Array<String>] :lifecycle_hook_names
2853
- # The names of one or more lifecycle hooks. If you omit this parameter,
2873
+ # The names of one or more lifecycle hooks. If you omit this property,
2854
2874
  # all lifecycle hooks are described.
2855
2875
  #
2856
2876
  # @return [Types::DescribeLifecycleHooksAnswer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -2911,12 +2931,12 @@ module Aws::AutoScaling
2911
2931
  req.send_request(options)
2912
2932
  end
2913
2933
 
2914
- # Gets information about the load balancer target groups for the
2915
- # specified Auto Scaling group.
2934
+ # Gets information about the Elastic Load Balancing target groups for
2935
+ # the specified Auto Scaling group.
2916
2936
  #
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
2937
+ # To determine the attachment status of the target group, use the
2938
+ # `State` element in the response. When you attach a target group to an
2939
+ # Auto Scaling group, the initial `State` value is `Adding`. The state
2920
2940
  # transitions to `Added` after all Auto Scaling instances are registered
2921
2941
  # with the target group. If Elastic Load Balancing health checks are
2922
2942
  # enabled for the Auto Scaling group, the state transitions to
@@ -2934,8 +2954,9 @@ module Aws::AutoScaling
2934
2954
  #
2935
2955
  # For help with failed health checks, see [Troubleshooting Amazon EC2
2936
2956
  # 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*.
2957
+ # Guide*. For more information, see [Use Elastic Load Balancing to
2958
+ # distribute traffic across the instances in your Auto Scaling group][2]
2959
+ # in the *Amazon EC2 Auto Scaling User Guide*.
2939
2960
  #
2940
2961
  #
2941
2962
  #
@@ -3006,11 +3027,11 @@ module Aws::AutoScaling
3006
3027
  #
3007
3028
  # This operation describes only Classic Load Balancers. If you have
3008
3029
  # Application Load Balancers, Network Load Balancers, or Gateway Load
3009
- # Balancers, use the DescribeLoadBalancerTargetGroups API instead.
3030
+ # Balancer, use the DescribeLoadBalancerTargetGroups API instead.
3010
3031
  #
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
3032
+ # To determine the attachment status of the load balancer, use the
3033
+ # `State` element in the response. When you attach a load balancer to an
3034
+ # Auto Scaling group, the initial `State` value is `Adding`. The state
3014
3035
  # transitions to `Added` after all Auto Scaling instances are registered
3015
3036
  # with the load balancer. If Elastic Load Balancing health checks are
3016
3037
  # enabled for the Auto Scaling group, the state transitions to
@@ -3028,8 +3049,9 @@ module Aws::AutoScaling
3028
3049
  #
3029
3050
  # For help with failed health checks, see [Troubleshooting Amazon EC2
3030
3051
  # 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*.
3052
+ # Guide*. For more information, see [Use Elastic Load Balancing to
3053
+ # distribute traffic across the instances in your Auto Scaling group][2]
3054
+ # in the *Amazon EC2 Auto Scaling User Guide*.
3033
3055
  #
3034
3056
  #
3035
3057
  #
@@ -3098,10 +3120,6 @@ module Aws::AutoScaling
3098
3120
  # Describes the available CloudWatch metrics for Amazon EC2 Auto
3099
3121
  # Scaling.
3100
3122
  #
3101
- # The `GroupStandbyInstances` metric is not returned by default. You
3102
- # must explicitly request this metric when calling the
3103
- # EnableMetricsCollection API.
3104
- #
3105
3123
  # @return [Types::DescribeMetricCollectionTypesAnswer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3106
3124
  #
3107
3125
  # * {Types::DescribeMetricCollectionTypesAnswer#metrics #metrics} => Array&lt;Types::MetricCollectionType&gt;
@@ -3245,7 +3263,7 @@ module Aws::AutoScaling
3245
3263
  # The name of the Auto Scaling group.
3246
3264
  #
3247
3265
  # @option params [Array<String>] :policy_names
3248
- # The names of one or more policies. If you omit this parameter, all
3266
+ # The names of one or more policies. If you omit this property, all
3249
3267
  # policies are described. If a group name is provided, the results are
3250
3268
  # limited to that group. If you specify an unknown policy name, it is
3251
3269
  # ignored with no error.
@@ -3431,7 +3449,7 @@ module Aws::AutoScaling
3431
3449
  #
3432
3450
  # @option params [Array<String>] :activity_ids
3433
3451
  # The activity IDs of the desired scaling activities. If you omit this
3434
- # parameter, all activities for the past six weeks are described. If
3452
+ # property, all activities for the past six weeks are described. If
3435
3453
  # unknown activities are requested, they are ignored with no error. If
3436
3454
  # you specify an Auto Scaling group, the results are limited to that
3437
3455
  # group.
@@ -3591,19 +3609,19 @@ module Aws::AutoScaling
3591
3609
  # The name of the Auto Scaling group.
3592
3610
  #
3593
3611
  # @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.
3612
+ # The names of one or more scheduled actions. If you omit this property,
3613
+ # all scheduled actions are described. If you specify an unknown
3614
+ # scheduled action, it is ignored with no error.
3597
3615
  #
3598
3616
  # Array Members: Maximum number of 50 actions.
3599
3617
  #
3600
3618
  # @option params [Time,DateTime,Date,Integer,String] :start_time
3601
3619
  # The earliest scheduled start time to return. If scheduled action names
3602
- # are provided, this parameter is ignored.
3620
+ # are provided, this property is ignored.
3603
3621
  #
3604
3622
  # @option params [Time,DateTime,Date,Integer,String] :end_time
3605
3623
  # The latest scheduled start time to return. If scheduled action names
3606
- # are provided, this parameter is ignored.
3624
+ # are provided, this property is ignored.
3607
3625
  #
3608
3626
  # @option params [String] :next_token
3609
3627
  # The token for the next set of items to return. (You received this
@@ -3693,12 +3711,12 @@ module Aws::AutoScaling
3693
3711
  # for a particular tag only if it matches all the filters. If there's
3694
3712
  # no match, no special message is returned.
3695
3713
  #
3696
- # For more information, see [Tagging Auto Scaling groups and
3697
- # instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
3714
+ # For more information, see [Tag Auto Scaling groups and instances][1]
3715
+ # in the *Amazon EC2 Auto Scaling User Guide*.
3698
3716
  #
3699
3717
  #
3700
3718
  #
3701
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html
3719
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-tagging.html
3702
3720
  #
3703
3721
  # @option params [Array<Types::Filter>] :filters
3704
3722
  # One or more filters to scope the tags to return. The maximum number of
@@ -3790,13 +3808,12 @@ module Aws::AutoScaling
3790
3808
  # Describes the termination policies supported by Amazon EC2 Auto
3791
3809
  # Scaling.
3792
3810
  #
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*.
3811
+ # For more information, see [Work with Amazon EC2 Auto Scaling
3812
+ # termination policies][1] in the *Amazon EC2 Auto Scaling User Guide*.
3796
3813
  #
3797
3814
  #
3798
3815
  #
3799
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html
3816
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-termination-policies.html
3800
3817
  #
3801
3818
  # @return [Types::DescribeTerminationPolicyTypesAnswer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3802
3819
  #
@@ -3999,6 +4016,12 @@ module Aws::AutoScaling
3999
4016
  # Detaches one or more target groups from the specified Auto Scaling
4000
4017
  # group.
4001
4018
  #
4019
+ # When you detach a target group, it enters the `Removing` state while
4020
+ # deregistering the instances in the group. When all instances are
4021
+ # deregistered, then you can no longer describe the target group using
4022
+ # the DescribeLoadBalancerTargetGroups API call. The instances remain
4023
+ # running.
4024
+ #
4002
4025
  # @option params [required, String] :auto_scaling_group_name
4003
4026
  # The name of the Auto Scaling group.
4004
4027
  #
@@ -4041,7 +4064,7 @@ module Aws::AutoScaling
4041
4064
  #
4042
4065
  # This operation detaches only Classic Load Balancers. If you have
4043
4066
  # Application Load Balancers, Network Load Balancers, or Gateway Load
4044
- # Balancers, use the DetachLoadBalancerTargetGroups API instead.
4067
+ # Balancer, use the DetachLoadBalancerTargetGroups API instead.
4045
4068
  #
4046
4069
  # When you detach a load balancer, it enters the `Removing` state while
4047
4070
  # deregistering the instances in the group. When all instances are
@@ -4085,13 +4108,16 @@ module Aws::AutoScaling
4085
4108
  req.send_request(options)
4086
4109
  end
4087
4110
 
4088
- # Disables group metrics for the specified Auto Scaling group.
4111
+ # Disables group metrics collection for the specified Auto Scaling
4112
+ # group.
4089
4113
  #
4090
4114
  # @option params [required, String] :auto_scaling_group_name
4091
4115
  # The name of the Auto Scaling group.
4092
4116
  #
4093
4117
  # @option params [Array<String>] :metrics
4094
- # Specifies one or more of the following metrics:
4118
+ # Identifies the metrics to disable.
4119
+ #
4120
+ # You can specify one or more of the following metrics:
4095
4121
  #
4096
4122
  # * `GroupMinSize`
4097
4123
  #
@@ -4133,7 +4159,14 @@ module Aws::AutoScaling
4133
4159
  #
4134
4160
  # * `GroupAndWarmPoolTotalCapacity`
4135
4161
  #
4136
- # If you omit this parameter, all metrics are disabled.
4162
+ # If you omit this property, all metrics are disabled.
4163
+ #
4164
+ # For more information, see [Auto Scaling group metrics][1] in the
4165
+ # *Amazon EC2 Auto Scaling User Guide*.
4166
+ #
4167
+ #
4168
+ #
4169
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-cloudwatch-monitoring.html#as-group-metrics
4137
4170
  #
4138
4171
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4139
4172
  #
@@ -4165,20 +4198,26 @@ module Aws::AutoScaling
4165
4198
  req.send_request(options)
4166
4199
  end
4167
4200
 
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*.
4201
+ # Enables group metrics collection for the specified Auto Scaling group.
4202
+ #
4203
+ # You can use these metrics to track changes in an Auto Scaling group
4204
+ # and to set alarms on threshold values. You can view group metrics
4205
+ # using the Amazon EC2 Auto Scaling console or the CloudWatch console.
4206
+ # For more information, see [Monitor CloudWatch metrics for your Auto
4207
+ # Scaling groups and instances][1] in the *Amazon EC2 Auto Scaling User
4208
+ # Guide*.
4171
4209
  #
4172
4210
  #
4173
4211
  #
4174
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-monitoring.html
4212
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-cloudwatch-monitoring.html
4175
4213
  #
4176
4214
  # @option params [required, String] :auto_scaling_group_name
4177
4215
  # The name of the Auto Scaling group.
4178
4216
  #
4179
4217
  # @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:
4218
+ # Identifies the metrics to enable.
4219
+ #
4220
+ # You can specify one or more of the following metrics:
4182
4221
  #
4183
4222
  # * `GroupMinSize`
4184
4223
  #
@@ -4196,9 +4235,6 @@ module Aws::AutoScaling
4196
4235
  #
4197
4236
  # * `GroupTotalInstances`
4198
4237
  #
4199
- # The instance weighting feature supports the following additional
4200
- # metrics:
4201
- #
4202
4238
  # * `GroupInServiceCapacity`
4203
4239
  #
4204
4240
  # * `GroupPendingCapacity`
@@ -4209,8 +4245,6 @@ module Aws::AutoScaling
4209
4245
  #
4210
4246
  # * `GroupTotalCapacity`
4211
4247
  #
4212
- # The warm pools feature supports the following additional metrics:
4213
- #
4214
4248
  # * `WarmPoolDesiredCapacity`
4215
4249
  #
4216
4250
  # * `WarmPoolWarmedCapacity`
@@ -4225,11 +4259,19 @@ module Aws::AutoScaling
4225
4259
  #
4226
4260
  # * `GroupAndWarmPoolTotalCapacity`
4227
4261
  #
4228
- # If you omit this parameter, all metrics are enabled.
4262
+ # If you specify `Granularity` and don't specify any metrics, all
4263
+ # metrics are enabled.
4264
+ #
4265
+ # For more information, see [Auto Scaling group metrics][1] in the
4266
+ # *Amazon EC2 Auto Scaling User Guide*.
4267
+ #
4268
+ #
4269
+ #
4270
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-cloudwatch-monitoring.html#as-group-metrics
4229
4271
  #
4230
4272
  # @option params [required, String] :granularity
4231
- # The granularity to associate with the metrics to collect. The only
4232
- # valid value is `1Minute`.
4273
+ # The frequency at which Amazon EC2 Auto Scaling sends aggregated data
4274
+ # to CloudWatch. The only valid value is `1Minute`.
4233
4275
  #
4234
4276
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4235
4277
  #
@@ -4683,12 +4725,14 @@ module Aws::AutoScaling
4683
4725
  # The name of the Auto Scaling group.
4684
4726
  #
4685
4727
  # @option params [String] :lifecycle_transition
4686
- # The instance state to which you want to attach the lifecycle hook. The
4687
- # valid values are:
4728
+ # The lifecycle transition. For Auto Scaling groups, there are two major
4729
+ # lifecycle transitions.
4688
4730
  #
4689
- # * autoscaling:EC2\_INSTANCE\_LAUNCHING
4731
+ # * To create a lifecycle hook for scale-out events, specify
4732
+ # `autoscaling:EC2_INSTANCE_LAUNCHING`.
4690
4733
  #
4691
- # * autoscaling:EC2\_INSTANCE\_TERMINATING
4734
+ # * To create a lifecycle hook for scale-in events, specify
4735
+ # `autoscaling:EC2_INSTANCE_TERMINATING`.
4692
4736
  #
4693
4737
  # Required for new lifecycle hooks, but optional when updating existing
4694
4738
  # hooks.
@@ -4702,10 +4746,10 @@ module Aws::AutoScaling
4702
4746
  # updating existing hooks.
4703
4747
  #
4704
4748
  # @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.
4749
+ # The Amazon Resource Name (ARN) of the notification target that Amazon
4750
+ # EC2 Auto Scaling uses to notify you when an instance is in a wait
4751
+ # state for the lifecycle hook. You can specify either an Amazon SNS
4752
+ # topic or an Amazon SQS queue.
4709
4753
  #
4710
4754
  # If you specify an empty string, this overrides the current ARN.
4711
4755
  #
@@ -4726,16 +4770,12 @@ module Aws::AutoScaling
4726
4770
  # hook times out. The range is from `30` to `7200` seconds. The default
4727
4771
  # value is `3600` seconds (1 hour).
4728
4772
  #
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
4773
  # @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`.
4774
+ # The action the Auto Scaling group takes when the lifecycle hook
4775
+ # timeout elapses or if an unexpected failure occurs. The default value
4776
+ # is `ABANDON`.
4777
+ #
4778
+ # Valid values: `CONTINUE` \| `ABANDON`
4739
4779
  #
4740
4780
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4741
4781
  #
@@ -4986,7 +5026,7 @@ module Aws::AutoScaling
4986
5026
  # * `ALBRequestCountPerTarget`
4987
5027
  #
4988
5028
  # If you specify `ALBRequestCountPerTarget` for the metric, you must
4989
- # specify the `ResourceLabel` parameter with the
5029
+ # specify the `ResourceLabel` property with the
4990
5030
  # `PredefinedMetricSpecification`.
4991
5031
  #
4992
5032
  # For more information, see [TargetTrackingConfiguration][1] in the
@@ -5227,6 +5267,9 @@ module Aws::AutoScaling
5227
5267
  # scheduled action, you can delete it by calling the
5228
5268
  # DeleteScheduledAction API.
5229
5269
  #
5270
+ # If you try to schedule your action in the past, Amazon EC2 Auto
5271
+ # Scaling returns an error message.
5272
+ #
5230
5273
  #
5231
5274
  #
5232
5275
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/schedule_time.html
@@ -5238,22 +5281,20 @@ module Aws::AutoScaling
5238
5281
  # The name of this scaling action.
5239
5282
  #
5240
5283
  # @option params [Time,DateTime,Date,Integer,String] :time
5241
- # This parameter is no longer used.
5284
+ # This property is no longer used.
5242
5285
  #
5243
5286
  # @option params [Time,DateTime,Date,Integer,String] :start_time
5244
5287
  # The date and time for this action to start, in YYYY-MM-DDThh:mm:ssZ
5245
5288
  # format in UTC/GMT only and in quotes (for example,
5246
- # `"2019-06-01T00:00:00Z"`).
5289
+ # `"2021-06-01T00:00:00Z"`).
5247
5290
  #
5248
5291
  # If you specify `Recurrence` and `StartTime`, Amazon EC2 Auto Scaling
5249
5292
  # performs the action at this time, and then performs the action based
5250
5293
  # on the specified recurrence.
5251
5294
  #
5252
- # If you try to schedule your action in the past, Amazon EC2 Auto
5253
- # Scaling returns an error message.
5254
- #
5255
5295
  # @option params [Time,DateTime,Date,Integer,String] :end_time
5256
- # The date and time for the recurring schedule to end, in UTC.
5296
+ # The date and time for the recurring schedule to end, in UTC. For
5297
+ # example, `"2021-06-01T00:00:00Z"`.
5257
5298
  #
5258
5299
  # @option params [String] :recurrence
5259
5300
  # The recurring schedule for this action. This format consists of five
@@ -5283,6 +5324,11 @@ module Aws::AutoScaling
5283
5324
  # maintain. It can scale beyond this capacity if you add more scaling
5284
5325
  # conditions.
5285
5326
  #
5327
+ # <note markdown="1"> You must specify at least one of the following properties: `MaxSize`,
5328
+ # `MinSize`, or `DesiredCapacity`.
5329
+ #
5330
+ # </note>
5331
+ #
5286
5332
  # @option params [String] :time_zone
5287
5333
  # Specifies the time zone for a cron expression. If a time zone is not
5288
5334
  # provided, UTC is used by default.
@@ -5552,7 +5598,7 @@ module Aws::AutoScaling
5552
5598
  #
5553
5599
  # * `ScheduledActions`
5554
5600
  #
5555
- # If you omit this parameter, all processes are specified.
5601
+ # If you omit this property, all processes are specified.
5556
5602
  #
5557
5603
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
5558
5604
  #
@@ -6009,7 +6055,7 @@ module Aws::AutoScaling
6009
6055
  #
6010
6056
  # * `ScheduledActions`
6011
6057
  #
6012
- # If you omit this parameter, all processes are specified.
6058
+ # If you omit this property, all processes are specified.
6013
6059
  #
6014
6060
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
6015
6061
  #
@@ -6126,7 +6172,7 @@ module Aws::AutoScaling
6126
6172
  # Updates the configuration for the specified Auto Scaling group.
6127
6173
  #
6128
6174
  # 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
6175
+ # property that you want to change. Any properties that you don't
6130
6176
  # specify are not changed by this update request. The new settings take
6131
6177
  # effect on any scaling activities after this call returns.
6132
6178
  #
@@ -6162,7 +6208,7 @@ module Aws::AutoScaling
6162
6208
  # current size of the group, this sets the group's `DesiredCapacity`
6163
6209
  # to the new `MaxSize` value.
6164
6210
  #
6165
- # To see which parameters have been set, call the
6211
+ # To see which properties have been set, call the
6166
6212
  # DescribeAutoScalingGroups API. To view the scaling policies for an
6167
6213
  # Auto Scaling group, call the DescribePolicies API. If the group has
6168
6214
  # scaling policies, you can update them by calling the PutScalingPolicy
@@ -6264,19 +6310,22 @@ module Aws::AutoScaling
6264
6310
  # @option params [String] :vpc_zone_identifier
6265
6311
  # A comma-separated list of subnet IDs for a virtual private cloud
6266
6312
  # (VPC). If you specify `VPCZoneIdentifier` with `AvailabilityZones`,
6267
- # the subnets that you specify for this parameter must reside in those
6268
- # Availability Zones.
6313
+ # the subnets that you specify must reside in those Availability Zones.
6269
6314
  #
6270
6315
  # @option params [Array<String>] :termination_policies
6271
6316
  # A policy or a list of policies that are used to select the instances
6272
6317
  # 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*.
6318
+ # them. For more information, see [Work with Amazon EC2 Auto Scaling
6319
+ # termination policies][1] in the *Amazon EC2 Auto Scaling User Guide*.
6320
+ #
6321
+ # Valid values: `Default` \| `AllocationStrategy` \|
6322
+ # `ClosestToNextInstanceHour` \| `NewestInstance` \| `OldestInstance` \|
6323
+ # `OldestLaunchConfiguration` \| `OldestLaunchTemplate` \|
6324
+ # `arn:aws:lambda:region:account-id:function:my-function:my-alias`
6276
6325
  #
6277
6326
  #
6278
6327
  #
6279
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html
6328
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-termination-policies.html
6280
6329
  #
6281
6330
  # @option params [Boolean] :new_instances_protected_from_scale_in
6282
6331
  # Indicates whether newly launched instances are protected from
@@ -6313,8 +6362,8 @@ module Aws::AutoScaling
6313
6362
  #
6314
6363
  # @option params [Boolean] :capacity_rebalance
6315
6364
  # 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*.
6365
+ # [Use Capacity Rebalancing to handle Amazon EC2 Spot Interruptions][1]
6366
+ # in the *Amazon EC2 Auto Scaling User Guide*.
6318
6367
  #
6319
6368
  #
6320
6369
  #
@@ -6507,7 +6556,7 @@ module Aws::AutoScaling
6507
6556
  params: params,
6508
6557
  config: config)
6509
6558
  context[:gem_name] = 'aws-sdk-autoscaling'
6510
- context[:gem_version] = '1.79.0'
6559
+ context[:gem_version] = '1.81.0'
6511
6560
  Seahorse::Client::Request.new(handlers, context)
6512
6561
  end
6513
6562