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.
- 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
|
|