aws-sdk-autoscaling 1.79.0 → 1.81.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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