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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-autoscaling/auto_scaling_group.rb +58 -39
- data/lib/aws-sdk-autoscaling/client.rb +270 -221
- data/lib/aws-sdk-autoscaling/endpoint_parameters.rb +66 -0
- data/lib/aws-sdk-autoscaling/endpoint_provider.rb +117 -0
- data/lib/aws-sdk-autoscaling/endpoints.rb +869 -0
- data/lib/aws-sdk-autoscaling/instance.rb +1 -1
- data/lib/aws-sdk-autoscaling/launch_configuration.rb +20 -14
- data/lib/aws-sdk-autoscaling/lifecycle_hook.rb +26 -30
- data/lib/aws-sdk-autoscaling/plugins/endpoints.rb +190 -0
- data/lib/aws-sdk-autoscaling/resource.rb +119 -118
- data/lib/aws-sdk-autoscaling/scheduled_action.rb +1 -1
- data/lib/aws-sdk-autoscaling/types.rb +316 -265
- data/lib/aws-sdk-autoscaling.rb +5 -1
- metadata +8 -4
@@ -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/
|
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::
|
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
|
432
|
-
#
|
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
|
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
|
498
|
-
#
|
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.
|
726
|
-
# `
|
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
|
774
|
-
#
|
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
|
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/
|
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
|
-
#
|
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.
|
891
|
-
#
|
892
|
-
#
|
893
|
-
#
|
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
|
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
|
905
|
-
# target
|
906
|
-
#
|
907
|
-
#
|
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
|
944
|
-
#
|
945
|
-
#
|
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
|
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 [
|
971
|
-
#
|
972
|
-
#
|
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/
|
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 [
|
996
|
-
#
|
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
|
1004
|
-
#
|
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 [
|
1015
|
-
#
|
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/
|
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
|
1024
|
-
# behalf. By default, Amazon EC2 Auto Scaling uses a service-linked
|
1025
|
-
# named `AWSServiceRoleForAutoScaling`, which it creates if it does
|
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
|
1310
|
-
#
|
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/
|
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
|
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
|
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
|
1337
|
-
#
|
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
|
1345
|
-
# the Auto Scaling group.
|
1346
|
-
#
|
1347
|
-
#
|
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
|
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
|
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.
|
1378
|
-
# the *Amazon EC2 User Guide for Linux Instances*.
|
1389
|
+
# ClassicLink-enabled VPC.
|
1379
1390
|
#
|
1380
|
-
# If you specify the `ClassicLinkVPCId`
|
1381
|
-
#
|
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
|
-
#
|
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
|
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
|
-
#
|
1439
|
-
#
|
1440
|
-
#
|
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
|
-
# [
|
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/
|
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
|
-
#
|
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
|
-
#
|
1511
|
-
#
|
1512
|
-
#
|
1513
|
-
#
|
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
|
1518
|
-
#
|
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
|
1535
|
-
# on isolated, single-tenant
|
1536
|
-
# VPC.
|
1537
|
-
#
|
1538
|
-
#
|
1539
|
-
#
|
1540
|
-
#
|
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
|
-
#
|
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 [
|
1641
|
-
#
|
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/
|
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
|
1724
|
-
#
|
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
|
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/
|
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`
|
2179
|
+
# `MaxRecords` property.
|
2160
2180
|
#
|
2161
|
-
# If you omit this
|
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
|
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
|
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
|
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
|
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
|
2918
|
-
# element in the response. When you attach a target group to an
|
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
|
2938
|
-
#
|
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
|
-
#
|
3030
|
+
# Balancer, use the DescribeLoadBalancerTargetGroups API instead.
|
3010
3031
|
#
|
3011
|
-
# To determine the
|
3012
|
-
# element in the response. When you attach a load balancer to an
|
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
|
3032
|
-
#
|
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<Types::MetricCollectionType>
|
@@ -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
|
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
|
-
#
|
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
|
-
#
|
3596
|
-
#
|
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
|
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
|
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 [
|
3697
|
-
#
|
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/
|
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 [
|
3794
|
-
#
|
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/
|
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
|
-
#
|
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
|
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
|
-
#
|
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
|
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.
|
4169
|
-
#
|
4170
|
-
#
|
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/
|
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
|
-
#
|
4181
|
-
#
|
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
|
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
|
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
|
4687
|
-
#
|
4728
|
+
# The lifecycle transition. For Auto Scaling groups, there are two major
|
4729
|
+
# lifecycle transitions.
|
4688
4730
|
#
|
4689
|
-
# *
|
4731
|
+
# * To create a lifecycle hook for scale-out events, specify
|
4732
|
+
# `autoscaling:EC2_INSTANCE_LAUNCHING`.
|
4690
4733
|
#
|
4691
|
-
# *
|
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
|
4706
|
-
# to notify you when an instance is in
|
4707
|
-
# lifecycle hook.
|
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
|
-
#
|
4736
|
-
#
|
4737
|
-
#
|
4738
|
-
#
|
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`
|
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
|
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
|
-
# `"
|
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
|
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
|
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
|
-
#
|
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
|
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
|
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 [
|
6274
|
-
#
|
6275
|
-
#
|
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/
|
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
|
-
# [
|
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.
|
6559
|
+
context[:gem_version] = '1.81.0'
|
6511
6560
|
Seahorse::Client::Request.new(handlers, context)
|
6512
6561
|
end
|
6513
6562
|
|