aws-sdk-autoscaling 1.48.0 → 1.49.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/lib/aws-sdk-autoscaling.rb +1 -1
- data/lib/aws-sdk-autoscaling/auto_scaling_group.rb +46 -77
- data/lib/aws-sdk-autoscaling/client.rb +205 -273
- data/lib/aws-sdk-autoscaling/launch_configuration.rb +26 -40
- data/lib/aws-sdk-autoscaling/resource.rb +111 -148
- data/lib/aws-sdk-autoscaling/scaling_policy.rb +3 -3
- data/lib/aws-sdk-autoscaling/types.rb +269 -390
- metadata +2 -2
@@ -55,8 +55,8 @@ module Aws::AutoScaling
|
|
55
55
|
#
|
56
56
|
# * `SimpleScaling` (default)
|
57
57
|
#
|
58
|
-
# For more information, see [Target
|
59
|
-
# [Step and
|
58
|
+
# For more information, see [Target tracking scaling policies][1] and
|
59
|
+
# [Step and simple scaling policies][2] in the *Amazon EC2 Auto Scaling
|
60
60
|
# User Guide*.
|
61
61
|
#
|
62
62
|
#
|
@@ -309,7 +309,7 @@ module Aws::AutoScaling
|
|
309
309
|
# period to complete before executing the policy.
|
310
310
|
#
|
311
311
|
# Valid only if the policy type is `SimpleScaling`. For more
|
312
|
-
# information, see [Scaling
|
312
|
+
# information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1] in
|
313
313
|
# the *Amazon EC2 Auto Scaling User Guide*.
|
314
314
|
#
|
315
315
|
#
|
@@ -373,7 +373,7 @@ module Aws::AutoScaling
|
|
373
373
|
# @return [Integer]
|
374
374
|
#
|
375
375
|
# @!attribute [rw] capacity_rebalance
|
376
|
-
# Indicates whether
|
376
|
+
# Indicates whether Capacity Rebalancing is enabled.
|
377
377
|
# @return [Boolean]
|
378
378
|
#
|
379
379
|
# @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/AutoScalingGroup AWS API Documentation
|
@@ -420,10 +420,9 @@ module Aws::AutoScaling
|
|
420
420
|
# }
|
421
421
|
#
|
422
422
|
# @!attribute [rw] auto_scaling_group_names
|
423
|
-
# The names of the Auto Scaling groups.
|
424
|
-
#
|
425
|
-
#
|
426
|
-
# parameter.
|
423
|
+
# The names of the Auto Scaling groups. By default, you can only
|
424
|
+
# specify up to 50 names. You can optionally increase this limit using
|
425
|
+
# the `MaxRecords` parameter.
|
427
426
|
#
|
428
427
|
# If you omit this parameter, all Auto Scaling groups are described.
|
429
428
|
# @return [Array<String>]
|
@@ -870,34 +869,32 @@ module Aws::AutoScaling
|
|
870
869
|
# @return [String]
|
871
870
|
#
|
872
871
|
# @!attribute [rw] launch_configuration_name
|
873
|
-
# The name of the launch configuration to use
|
874
|
-
# launched. To get the launch configuration name, use the
|
875
|
-
# DescribeLaunchConfigurations API operation. New launch
|
876
|
-
# configurations can be created with the CreateLaunchConfiguration
|
877
|
-
# API.
|
872
|
+
# The name of the launch configuration to use to launch instances.
|
878
873
|
#
|
879
|
-
# You must specify
|
880
|
-
# `
|
881
|
-
# `
|
874
|
+
# Conditional: You must specify either a launch template
|
875
|
+
# (`LaunchTemplate` or `MixedInstancesPolicy`) or a launch
|
876
|
+
# configuration (`LaunchConfigurationName` or `InstanceId`).
|
882
877
|
# @return [String]
|
883
878
|
#
|
884
879
|
# @!attribute [rw] launch_template
|
885
|
-
# Parameters used to specify the launch template and version to
|
886
|
-
#
|
880
|
+
# Parameters used to specify the [launch template][1] and version to
|
881
|
+
# use to launch instances.
|
887
882
|
#
|
888
|
-
#
|
889
|
-
#
|
883
|
+
# Conditional: You must specify either a launch template
|
884
|
+
# (`LaunchTemplate` or `MixedInstancesPolicy`) or a launch
|
885
|
+
# configuration (`LaunchConfigurationName` or `InstanceId`).
|
890
886
|
#
|
891
|
-
#
|
892
|
-
# Scaling group
|
887
|
+
# <note markdown="1"> The launch template that is specified must be configured for use
|
888
|
+
# with an Auto Scaling group. For more information, see [Creating a
|
889
|
+
# launch template for an Auto Scaling group][2] in the *Amazon EC2
|
890
|
+
# Auto Scaling User Guide*.
|
893
891
|
#
|
894
|
-
#
|
895
|
-
# `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
|
896
|
-
# `MixedInstancesPolicy`.
|
892
|
+
# </note>
|
897
893
|
#
|
898
894
|
#
|
899
895
|
#
|
900
|
-
# [1]: https://docs.aws.amazon.com/
|
896
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-launchtemplate.html
|
897
|
+
# [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-launch-template.html
|
901
898
|
# @return [Types::LaunchTemplateSpecification]
|
902
899
|
#
|
903
900
|
# @!attribute [rw] mixed_instances_policy
|
@@ -908,42 +905,35 @@ module Aws::AutoScaling
|
|
908
905
|
# The policy includes parameters that not only define the distribution
|
909
906
|
# of On-Demand Instances and Spot Instances, the maximum price to pay
|
910
907
|
# for Spot Instances, and how the Auto Scaling group allocates
|
911
|
-
# instance types to fulfill On-Demand and Spot
|
912
|
-
# parameters that specify the instance configuration
|
913
|
-
# launch template and instance types.
|
914
|
-
#
|
915
|
-
#
|
916
|
-
#
|
917
|
-
# Multiple Instance Types and Purchase Options][2] in the *Amazon EC2
|
918
|
-
# Auto Scaling User Guide*.
|
908
|
+
# instance types to fulfill On-Demand and Spot capacities, but also
|
909
|
+
# the parameters that specify the instance configuration
|
910
|
+
# information—the launch template and instance types. The policy can
|
911
|
+
# also include a weight for each instance type. For more information,
|
912
|
+
# see [Auto Scaling groups with multiple instance types and purchase
|
913
|
+
# options][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
919
914
|
#
|
920
|
-
# You must specify
|
921
|
-
# `
|
922
|
-
# `
|
915
|
+
# Conditional: You must specify either a launch template
|
916
|
+
# (`LaunchTemplate` or `MixedInstancesPolicy`) or a launch
|
917
|
+
# configuration (`LaunchConfigurationName` or `InstanceId`).
|
923
918
|
#
|
924
919
|
#
|
925
920
|
#
|
926
|
-
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/
|
927
|
-
# [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
|
921
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
|
928
922
|
# @return [Types::MixedInstancesPolicy]
|
929
923
|
#
|
930
924
|
# @!attribute [rw] instance_id
|
931
|
-
# The ID of the instance used to
|
932
|
-
#
|
933
|
-
#
|
934
|
-
#
|
935
|
-
#
|
936
|
-
#
|
937
|
-
#
|
938
|
-
# instance, except for the block device mapping.
|
939
|
-
#
|
940
|
-
# You must specify one of the following parameters in your request:
|
941
|
-
# `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
|
942
|
-
# `MixedInstancesPolicy`.
|
925
|
+
# The ID of the instance used to base the launch configuration on. If
|
926
|
+
# specified, Amazon EC2 Auto Scaling uses the configuration values
|
927
|
+
# from the specified instance to create a new launch configuration. To
|
928
|
+
# get the instance ID, use the Amazon EC2 [DescribeInstances][1] API
|
929
|
+
# operation. For more information, see [Creating an Auto Scaling group
|
930
|
+
# using an EC2 instance][2] in the *Amazon EC2 Auto Scaling User
|
931
|
+
# Guide*.
|
943
932
|
#
|
944
933
|
#
|
945
934
|
#
|
946
935
|
# [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html
|
936
|
+
# [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-from-instance.html
|
947
937
|
# @return [String]
|
948
938
|
#
|
949
939
|
# @!attribute [rw] min_size
|
@@ -966,23 +956,19 @@ module Aws::AutoScaling
|
|
966
956
|
# @!attribute [rw] desired_capacity
|
967
957
|
# The desired capacity is the initial capacity of the Auto Scaling
|
968
958
|
# group at the time of its creation and the capacity it attempts to
|
969
|
-
# maintain. It can scale beyond this capacity if you configure
|
970
|
-
#
|
971
|
-
#
|
972
|
-
#
|
973
|
-
#
|
974
|
-
# you do not specify a desired capacity, the default is the minimum
|
975
|
-
# size of the group.
|
959
|
+
# maintain. It can scale beyond this capacity if you configure auto
|
960
|
+
# scaling. This number must be greater than or equal to the minimum
|
961
|
+
# size of the group and less than or equal to the maximum size of the
|
962
|
+
# group. If you do not specify a desired capacity, the default is the
|
963
|
+
# minimum size of the group.
|
976
964
|
# @return [Integer]
|
977
965
|
#
|
978
966
|
# @!attribute [rw] default_cooldown
|
979
967
|
# The amount of time, in seconds, after a scaling activity completes
|
980
968
|
# before another scaling activity can start. The default value is
|
981
|
-
# `300`.
|
982
|
-
#
|
983
|
-
#
|
984
|
-
# when using other scaling policies or scheduled scaling. For more
|
985
|
-
# information, see [Scaling Cooldowns for Amazon EC2 Auto Scaling][1]
|
969
|
+
# `300`. This setting applies when using simple scaling policies, but
|
970
|
+
# not when using other scaling policies or scheduled scaling. For more
|
971
|
+
# information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1]
|
986
972
|
# in the *Amazon EC2 Auto Scaling User Guide*.
|
987
973
|
#
|
988
974
|
#
|
@@ -991,8 +977,9 @@ module Aws::AutoScaling
|
|
991
977
|
# @return [Integer]
|
992
978
|
#
|
993
979
|
# @!attribute [rw] availability_zones
|
994
|
-
#
|
995
|
-
# optional if you specify one
|
980
|
+
# A list of Availability Zones where instances in the Auto Scaling
|
981
|
+
# group can be created. This parameter is optional if you specify one
|
982
|
+
# or more subnets for `VPCZoneIdentifier`.
|
996
983
|
#
|
997
984
|
# Conditional: If your account supports EC2-Classic and VPC, this
|
998
985
|
# parameter is required to launch instances into EC2-Classic.
|
@@ -1001,24 +988,15 @@ module Aws::AutoScaling
|
|
1001
988
|
# @!attribute [rw] load_balancer_names
|
1002
989
|
# A list of Classic Load Balancers associated with this Auto Scaling
|
1003
990
|
# group. For Application Load Balancers and Network Load Balancers,
|
1004
|
-
# specify
|
1005
|
-
# instead.
|
1006
|
-
#
|
1007
|
-
# For more information, see [Using a Load Balancer with an Auto
|
1008
|
-
# Scaling Group][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
1009
|
-
#
|
1010
|
-
#
|
1011
|
-
#
|
1012
|
-
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html
|
991
|
+
# specify `TargetGroupARNs` instead.
|
1013
992
|
# @return [Array<String>]
|
1014
993
|
#
|
1015
994
|
# @!attribute [rw] target_group_arns
|
1016
995
|
# The Amazon Resource Names (ARN) of the target groups to associate
|
1017
996
|
# with the Auto Scaling group. Instances are registered as targets in
|
1018
|
-
# a target group, and traffic is routed to the target group.
|
1019
|
-
#
|
1020
|
-
#
|
1021
|
-
# Scaling Group][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
997
|
+
# a target group, and traffic is routed to the target group. For more
|
998
|
+
# information, see [Elastic Load Balancing and Amazon EC2 Auto
|
999
|
+
# Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
1022
1000
|
#
|
1023
1001
|
#
|
1024
1002
|
#
|
@@ -1027,13 +1005,12 @@ module Aws::AutoScaling
|
|
1027
1005
|
#
|
1028
1006
|
# @!attribute [rw] health_check_type
|
1029
1007
|
# The service to use for the health checks. The valid values are `EC2`
|
1030
|
-
# and `ELB`.
|
1031
|
-
#
|
1008
|
+
# (default) and `ELB`. If you configure an Auto Scaling group to use
|
1009
|
+
# load balancer (ELB) health checks, it considers the instance
|
1032
1010
|
# unhealthy if it fails either the EC2 status checks or the load
|
1033
|
-
# balancer health checks.
|
1034
|
-
#
|
1035
|
-
#
|
1036
|
-
# Instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
1011
|
+
# balancer health checks. For more information, see [Health checks for
|
1012
|
+
# Auto Scaling instances][1] in the *Amazon EC2 Auto Scaling User
|
1013
|
+
# Guide*.
|
1037
1014
|
#
|
1038
1015
|
#
|
1039
1016
|
#
|
@@ -1044,12 +1021,11 @@ module Aws::AutoScaling
|
|
1044
1021
|
# The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
|
1045
1022
|
# before checking the health status of an EC2 instance that has come
|
1046
1023
|
# into service. During this time, any health check failures for the
|
1047
|
-
# instance are ignored. The default value is `0`.
|
1048
|
-
#
|
1049
|
-
#
|
1050
|
-
# *Amazon EC2 Auto Scaling User Guide*.
|
1024
|
+
# instance are ignored. The default value is `0`. For more
|
1025
|
+
# information, see [Health check grace period][1] in the *Amazon EC2
|
1026
|
+
# Auto Scaling User Guide*.
|
1051
1027
|
#
|
1052
|
-
# Required if you are adding an `ELB` health check.
|
1028
|
+
# Conditional: Required if you are adding an `ELB` health check.
|
1053
1029
|
#
|
1054
1030
|
#
|
1055
1031
|
#
|
@@ -1057,11 +1033,12 @@ module Aws::AutoScaling
|
|
1057
1033
|
# @return [Integer]
|
1058
1034
|
#
|
1059
1035
|
# @!attribute [rw] placement_group
|
1060
|
-
# The name of
|
1061
|
-
# if any. A placement group is a logical grouping of
|
1062
|
-
# a single Availability Zone. You cannot specify
|
1063
|
-
# Zones and a placement group. For more
|
1064
|
-
# Groups][1] in the *Amazon EC2 User Guide
|
1036
|
+
# The name of an existing placement group into which to launch your
|
1037
|
+
# instances, if any. A placement group is a logical grouping of
|
1038
|
+
# instances within a single Availability Zone. You cannot specify
|
1039
|
+
# multiple Availability Zones and a placement group. For more
|
1040
|
+
# information, see [Placement Groups][1] in the *Amazon EC2 User Guide
|
1041
|
+
# for Linux Instances*.
|
1065
1042
|
#
|
1066
1043
|
#
|
1067
1044
|
#
|
@@ -1069,10 +1046,9 @@ module Aws::AutoScaling
|
|
1069
1046
|
# @return [String]
|
1070
1047
|
#
|
1071
1048
|
# @!attribute [rw] vpc_zone_identifier
|
1072
|
-
# A comma-separated list of subnet IDs for
|
1073
|
-
# (VPC).
|
1074
|
-
#
|
1075
|
-
# If you specify `VPCZoneIdentifier` with `AvailabilityZones`, the
|
1049
|
+
# A comma-separated list of subnet IDs for a virtual private cloud
|
1050
|
+
# (VPC) where instances in the Auto Scaling group can be created. If
|
1051
|
+
# you specify `VPCZoneIdentifier` with `AvailabilityZones`, the
|
1076
1052
|
# subnets that you specify for this parameter must reside in those
|
1077
1053
|
# Availability Zones.
|
1078
1054
|
#
|
@@ -1081,13 +1057,11 @@ module Aws::AutoScaling
|
|
1081
1057
|
# @return [String]
|
1082
1058
|
#
|
1083
1059
|
# @!attribute [rw] termination_policies
|
1084
|
-
#
|
1085
|
-
# terminate. These policies are executed in the order that
|
1086
|
-
#
|
1087
|
-
#
|
1088
|
-
#
|
1089
|
-
# Terminates During Scale In][1] in the *Amazon EC2 Auto Scaling User
|
1090
|
-
# Guide*.
|
1060
|
+
# A policy or a list of policies that are used to select the instance
|
1061
|
+
# to terminate. These policies are executed in the order that you list
|
1062
|
+
# them. For more information, see [Controlling which Auto Scaling
|
1063
|
+
# instances terminate during scale in][1] in the *Amazon EC2 Auto
|
1064
|
+
# Scaling User Guide*.
|
1091
1065
|
#
|
1092
1066
|
#
|
1093
1067
|
#
|
@@ -1096,10 +1070,9 @@ module Aws::AutoScaling
|
|
1096
1070
|
#
|
1097
1071
|
# @!attribute [rw] new_instances_protected_from_scale_in
|
1098
1072
|
# Indicates whether newly launched instances are protected from
|
1099
|
-
# termination by Amazon EC2 Auto Scaling when scaling in.
|
1100
|
-
#
|
1101
|
-
#
|
1102
|
-
# scale in, see [Instance Protection][1] in the *Amazon EC2 Auto
|
1073
|
+
# termination by Amazon EC2 Auto Scaling when scaling in. For more
|
1074
|
+
# information about preventing instances from terminating on scale in,
|
1075
|
+
# see [Instance scale-in protection][1] in the *Amazon EC2 Auto
|
1103
1076
|
# Scaling User Guide*.
|
1104
1077
|
#
|
1105
1078
|
#
|
@@ -1108,17 +1081,14 @@ module Aws::AutoScaling
|
|
1108
1081
|
# @return [Boolean]
|
1109
1082
|
#
|
1110
1083
|
# @!attribute [rw] capacity_rebalance
|
1111
|
-
# Indicates whether
|
1112
|
-
#
|
1113
|
-
#
|
1114
|
-
#
|
1115
|
-
#
|
1116
|
-
#
|
1117
|
-
#
|
1118
|
-
#
|
1119
|
-
# old instance. For more information, see [Amazon EC2 Auto Scaling
|
1120
|
-
# capacity rebalancing][1] in the *Amazon EC2 Auto Scaling User
|
1121
|
-
# Guide*.
|
1084
|
+
# Indicates whether Capacity Rebalancing is enabled. Otherwise,
|
1085
|
+
# Capacity Rebalancing is disabled. When you turn on Capacity
|
1086
|
+
# Rebalancing, Amazon EC2 Auto Scaling attempts to launch a Spot
|
1087
|
+
# Instance whenever Amazon EC2 notifies that a Spot Instance is at an
|
1088
|
+
# elevated risk of interruption. After launching a new instance, it
|
1089
|
+
# then terminates an old instance. For more information, see [Amazon
|
1090
|
+
# EC2 Auto Scaling Capacity Rebalancing][1] in the *Amazon EC2 Auto
|
1091
|
+
# Scaling User Guide*.
|
1122
1092
|
#
|
1123
1093
|
#
|
1124
1094
|
#
|
@@ -1126,22 +1096,22 @@ module Aws::AutoScaling
|
|
1126
1096
|
# @return [Boolean]
|
1127
1097
|
#
|
1128
1098
|
# @!attribute [rw] lifecycle_hook_specification_list
|
1129
|
-
# One or more lifecycle hooks
|
1099
|
+
# One or more lifecycle hooks for the group, which specify actions to
|
1100
|
+
# perform when Amazon EC2 Auto Scaling launches or terminates
|
1101
|
+
# instances.
|
1130
1102
|
# @return [Array<Types::LifecycleHookSpecification>]
|
1131
1103
|
#
|
1132
1104
|
# @!attribute [rw] tags
|
1133
1105
|
# One or more tags. You can tag your Auto Scaling group and propagate
|
1134
|
-
# the tags to the Amazon EC2 instances it launches.
|
1135
|
-
#
|
1136
|
-
#
|
1137
|
-
#
|
1138
|
-
#
|
1139
|
-
#
|
1140
|
-
#
|
1141
|
-
# the Auto Scaling
|
1142
|
-
#
|
1143
|
-
# For more information, see [Tagging Auto Scaling Groups and
|
1144
|
-
# Instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
1106
|
+
# the tags to the Amazon EC2 instances it launches. Tags are not
|
1107
|
+
# propagated to Amazon EBS volumes. To add tags to Amazon EBS volumes,
|
1108
|
+
# specify the tags in a launch template but use caution. If the launch
|
1109
|
+
# template specifies an instance tag with a key that is also specified
|
1110
|
+
# for the Auto Scaling group, Amazon EC2 Auto Scaling overrides the
|
1111
|
+
# value of that instance tag with the value specified by the Auto
|
1112
|
+
# Scaling group. For more information, see [Tagging Auto Scaling
|
1113
|
+
# groups and instances][1] in the *Amazon EC2 Auto Scaling User
|
1114
|
+
# Guide*.
|
1145
1115
|
#
|
1146
1116
|
#
|
1147
1117
|
#
|
@@ -1153,7 +1123,7 @@ module Aws::AutoScaling
|
|
1153
1123
|
# Auto Scaling group uses to call other AWS services on your behalf.
|
1154
1124
|
# By default, Amazon EC2 Auto Scaling uses a service-linked role named
|
1155
1125
|
# AWSServiceRoleForAutoScaling, which it creates if it does not exist.
|
1156
|
-
# For more information, see [Service-
|
1126
|
+
# For more information, see [Service-linked roles][1] in the *Amazon
|
1157
1127
|
# EC2 Auto Scaling User Guide*.
|
1158
1128
|
#
|
1159
1129
|
#
|
@@ -1163,18 +1133,12 @@ module Aws::AutoScaling
|
|
1163
1133
|
#
|
1164
1134
|
# @!attribute [rw] max_instance_lifetime
|
1165
1135
|
# The maximum amount of time, in seconds, that an instance can be in
|
1166
|
-
# service. The default is null.
|
1167
|
-
#
|
1168
|
-
#
|
1169
|
-
#
|
1170
|
-
# a previously set value, specify a new value of 0.
|
1171
|
-
#
|
1172
|
-
# For more information, see [Replacing Auto Scaling Instances Based on
|
1173
|
-
# Maximum Instance Lifetime][1] in the *Amazon EC2 Auto Scaling User
|
1136
|
+
# service. The default is null. If specified, the value must be either
|
1137
|
+
# 0 or a number equal to or greater than 86,400 seconds (1 day). For
|
1138
|
+
# more information, see [Replacing Auto Scaling instances based on
|
1139
|
+
# maximum instance lifetime][1] in the *Amazon EC2 Auto Scaling User
|
1174
1140
|
# Guide*.
|
1175
1141
|
#
|
1176
|
-
# Valid Range: Minimum value of 0.
|
1177
|
-
#
|
1178
1142
|
#
|
1179
1143
|
#
|
1180
1144
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-max-instance-lifetime.html
|
@@ -1303,7 +1267,7 @@ module Aws::AutoScaling
|
|
1303
1267
|
# The ID of a ClassicLink-enabled VPC to link your EC2-Classic
|
1304
1268
|
# instances to. For more information, see [ClassicLink][1] in the
|
1305
1269
|
# *Amazon EC2 User Guide for Linux Instances* and [Linking EC2-Classic
|
1306
|
-
#
|
1270
|
+
# instances to a VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
|
1307
1271
|
#
|
1308
1272
|
# This parameter can only be used if you are launching EC2-Classic
|
1309
1273
|
# instances.
|
@@ -1318,7 +1282,7 @@ module Aws::AutoScaling
|
|
1318
1282
|
# The IDs of one or more security groups for the specified
|
1319
1283
|
# ClassicLink-enabled VPC. For more information, see [ClassicLink][1]
|
1320
1284
|
# in the *Amazon EC2 User Guide for Linux Instances* and [Linking
|
1321
|
-
# EC2-Classic
|
1285
|
+
# EC2-Classic instances to a VPC][2] in the *Amazon EC2 Auto Scaling
|
1322
1286
|
# User Guide*.
|
1323
1287
|
#
|
1324
1288
|
# If you specify the `ClassicLinkVPCId` parameter, you must specify
|
@@ -1332,8 +1296,8 @@ module Aws::AutoScaling
|
|
1332
1296
|
#
|
1333
1297
|
# @!attribute [rw] user_data
|
1334
1298
|
# The Base64-encoded user data to make available to the launched EC2
|
1335
|
-
# instances. For more information, see [Instance
|
1336
|
-
#
|
1299
|
+
# instances. For more information, see [Instance metadata and user
|
1300
|
+
# data][1] in the *Amazon EC2 User Guide for Linux Instances*.
|
1337
1301
|
#
|
1338
1302
|
#
|
1339
1303
|
#
|
@@ -1349,8 +1313,8 @@ module Aws::AutoScaling
|
|
1349
1313
|
# override any other instance attributes, specify them as part of the
|
1350
1314
|
# same request.
|
1351
1315
|
#
|
1352
|
-
# For more information, see [
|
1353
|
-
# EC2
|
1316
|
+
# For more information, see [Creating a launch configuration using an
|
1317
|
+
# EC2 instance][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
1354
1318
|
#
|
1355
1319
|
# If you do not specify `InstanceId`, you must specify both `ImageId`
|
1356
1320
|
# and `InstanceType`.
|
@@ -1414,8 +1378,8 @@ module Aws::AutoScaling
|
|
1414
1378
|
# The maximum hourly price to be paid for any Spot Instance launched
|
1415
1379
|
# to fulfill the request. Spot Instances are launched when the price
|
1416
1380
|
# you specify exceeds the current Spot price. For more information,
|
1417
|
-
# see [
|
1418
|
-
#
|
1381
|
+
# see [Requesting Spot Instances][1] in the *Amazon EC2 Auto Scaling
|
1382
|
+
# User Guide*.
|
1419
1383
|
#
|
1420
1384
|
# <note markdown="1"> When you change your maximum price by creating a new launch
|
1421
1385
|
# configuration, running instances will continue to run as long as the
|
@@ -1434,8 +1398,8 @@ module Aws::AutoScaling
|
|
1434
1398
|
# associated with the IAM role for the instance. The instance profile
|
1435
1399
|
# contains the IAM role.
|
1436
1400
|
#
|
1437
|
-
# For more information, see [IAM
|
1438
|
-
# Amazon EC2
|
1401
|
+
# For more information, see [IAM role for applications that run on
|
1402
|
+
# Amazon EC2 instances][1] in the *Amazon EC2 Auto Scaling User
|
1439
1403
|
# Guide*.
|
1440
1404
|
#
|
1441
1405
|
#
|
@@ -1466,7 +1430,7 @@ module Aws::AutoScaling
|
|
1466
1430
|
# (VPC), specifies whether to assign a public IP address to the
|
1467
1431
|
# group's instances. If you specify `true`, each instance in the Auto
|
1468
1432
|
# Scaling group receives a unique public IP address. For more
|
1469
|
-
# information, see [Launching Auto Scaling
|
1433
|
+
# information, see [Launching Auto Scaling instances in a VPC][1] in
|
1470
1434
|
# the *Amazon EC2 Auto Scaling User Guide*.
|
1471
1435
|
#
|
1472
1436
|
# If you specify this parameter, you must specify at least one subnet
|
@@ -1498,14 +1462,14 @@ module Aws::AutoScaling
|
|
1498
1462
|
# If you specify `PlacementTenancy`, you must specify at least one
|
1499
1463
|
# subnet for `VPCZoneIdentifier` when you create your group.
|
1500
1464
|
#
|
1501
|
-
# For more information, see [
|
1502
|
-
# *Amazon EC2 Auto Scaling User Guide*.
|
1465
|
+
# For more information, see [Configuring instance tenancy with Amazon
|
1466
|
+
# EC2 Auto Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
1503
1467
|
#
|
1504
1468
|
# Valid Values: `default` \| `dedicated`
|
1505
1469
|
#
|
1506
1470
|
#
|
1507
1471
|
#
|
1508
|
-
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/
|
1472
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling/ec2/userguide/auto-scaling-dedicated-instances.html
|
1509
1473
|
# @return [String]
|
1510
1474
|
#
|
1511
1475
|
# @!attribute [rw] metadata_options
|
@@ -2641,7 +2605,7 @@ module Aws::AutoScaling
|
|
2641
2605
|
#
|
2642
2606
|
# For more information, see [Using Encryption with EBS-Backed AMIs][3]
|
2643
2607
|
# in the *Amazon EC2 User Guide for Linux Instances* and [Required CMK
|
2644
|
-
#
|
2608
|
+
# key policy for use with encrypted volumes][4] in the *Amazon EC2
|
2645
2609
|
# Auto Scaling User Guide*.
|
2646
2610
|
#
|
2647
2611
|
#
|
@@ -2842,7 +2806,7 @@ module Aws::AutoScaling
|
|
2842
2806
|
# period to complete before executing the policy.
|
2843
2807
|
#
|
2844
2808
|
# Valid only if the policy type is `SimpleScaling`. For more
|
2845
|
-
# information, see [Scaling
|
2809
|
+
# information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1]
|
2846
2810
|
# in the *Amazon EC2 Auto Scaling User Guide*.
|
2847
2811
|
#
|
2848
2812
|
#
|
@@ -2948,8 +2912,8 @@ module Aws::AutoScaling
|
|
2948
2912
|
# Describes a filter that is used to return a more specific list of
|
2949
2913
|
# results when describing tags.
|
2950
2914
|
#
|
2951
|
-
# For more information, see [Tagging Auto Scaling
|
2952
|
-
#
|
2915
|
+
# For more information, see [Tagging Auto Scaling groups and
|
2916
|
+
# instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
2953
2917
|
#
|
2954
2918
|
#
|
2955
2919
|
#
|
@@ -3224,7 +3188,7 @@ module Aws::AutoScaling
|
|
3224
3188
|
# The instances distribution specifies the distribution of On-Demand
|
3225
3189
|
# Instances and Spot Instances, the maximum price to pay for Spot
|
3226
3190
|
# Instances, and how the Auto Scaling group allocates instance types to
|
3227
|
-
# fulfill On-Demand and Spot
|
3191
|
+
# fulfill On-Demand and Spot capacities.
|
3228
3192
|
#
|
3229
3193
|
# When you update `SpotAllocationStrategy`, `SpotInstancePools`, or
|
3230
3194
|
# `SpotMaxPrice`, this update action does not deploy any changes across
|
@@ -3249,80 +3213,49 @@ module Aws::AutoScaling
|
|
3249
3213
|
#
|
3250
3214
|
# @!attribute [rw] on_demand_allocation_strategy
|
3251
3215
|
# Indicates how to allocate instance types to fulfill On-Demand
|
3252
|
-
# capacity.
|
3253
|
-
#
|
3254
|
-
#
|
3255
|
-
#
|
3256
|
-
#
|
3257
|
-
#
|
3258
|
-
#
|
3259
|
-
#
|
3260
|
-
# launches the remaining capacity using the second priority instance
|
3261
|
-
# type, and so on.
|
3216
|
+
# capacity. The only valid value is `prioritized`, which is also the
|
3217
|
+
# default value. This strategy uses the order of instance types in the
|
3218
|
+
# overrides to define the launch priority of each instance type. The
|
3219
|
+
# first instance type in the array is prioritized higher than the
|
3220
|
+
# last. If all your On-Demand capacity cannot be fulfilled using your
|
3221
|
+
# highest priority instance, then the Auto Scaling groups launches the
|
3222
|
+
# remaining capacity using the second priority instance type, and so
|
3223
|
+
# on.
|
3262
3224
|
# @return [String]
|
3263
3225
|
#
|
3264
3226
|
# @!attribute [rw] on_demand_base_capacity
|
3265
3227
|
# The minimum amount of the Auto Scaling group's capacity that must
|
3266
3228
|
# be fulfilled by On-Demand Instances. This base portion is
|
3267
|
-
# provisioned first as your group scales.
|
3268
|
-
#
|
3269
|
-
#
|
3270
|
-
#
|
3271
|
-
# desired capacity, per the `OnDemandPercentageAboveBaseCapacity`
|
3272
|
-
# setting.
|
3273
|
-
#
|
3274
|
-
# <note markdown="1"> An update to this setting means a gradual replacement of instances
|
3275
|
-
# to maintain the specified number of On-Demand Instances for your
|
3276
|
-
# base capacity. When replacing instances, Amazon EC2 Auto Scaling
|
3277
|
-
# launches new instances before terminating the old ones.
|
3278
|
-
#
|
3279
|
-
# </note>
|
3229
|
+
# provisioned first as your group scales. Defaults to 0 if not
|
3230
|
+
# specified. If you specify weights for the instance types in the
|
3231
|
+
# overrides, set the value of `OnDemandBaseCapacity` in terms of the
|
3232
|
+
# number of capacity units, and not the number of instances.
|
3280
3233
|
# @return [Integer]
|
3281
3234
|
#
|
3282
3235
|
# @!attribute [rw] on_demand_percentage_above_base_capacity
|
3283
3236
|
# Controls the percentages of On-Demand Instances and Spot Instances
|
3284
3237
|
# for your additional capacity beyond `OnDemandBaseCapacity`.
|
3285
|
-
#
|
3286
|
-
#
|
3287
|
-
#
|
3288
|
-
# Instances.
|
3289
|
-
#
|
3290
|
-
# <note markdown="1"> An update to this setting means a gradual replacement of instances
|
3291
|
-
# to maintain the percentage of On-Demand Instances for your
|
3292
|
-
# additional capacity above the base capacity. When replacing
|
3293
|
-
# instances, Amazon EC2 Auto Scaling launches new instances before
|
3294
|
-
# terminating the old ones.
|
3295
|
-
#
|
3296
|
-
# </note>
|
3297
|
-
#
|
3298
|
-
# Valid Range: Minimum value of 0. Maximum value of 100.
|
3238
|
+
# Expressed as a number (for example, 20 specifies 20% On-Demand
|
3239
|
+
# Instances, 80% Spot Instances). Defaults to 100 if not specified. If
|
3240
|
+
# set to 100, only On-Demand Instances are provisioned.
|
3299
3241
|
# @return [Integer]
|
3300
3242
|
#
|
3301
3243
|
# @!attribute [rw] spot_allocation_strategy
|
3302
|
-
# Indicates how to allocate instances across Spot Instance pools.
|
3303
|
-
#
|
3304
|
-
# If the allocation strategy is `lowest-price`, the Auto Scaling group
|
3244
|
+
# Indicates how to allocate instances across Spot Instance pools. If
|
3245
|
+
# the allocation strategy is `lowest-price`, the Auto Scaling group
|
3305
3246
|
# launches instances using the Spot pools with the lowest price, and
|
3306
3247
|
# evenly allocates your instances across the number of Spot pools that
|
3307
3248
|
# you specify. If the allocation strategy is `capacity-optimized`, the
|
3308
3249
|
# Auto Scaling group launches instances using Spot pools that are
|
3309
|
-
# optimally chosen based on the available Spot capacity.
|
3310
|
-
#
|
3311
|
-
# The default Spot allocation strategy for calls that you make through
|
3312
|
-
# the API, the AWS CLI, or the AWS SDKs is `lowest-price`. The default
|
3313
|
-
# Spot allocation strategy for the AWS Management Console is
|
3314
|
-
# `capacity-optimized`.
|
3315
|
-
#
|
3316
|
-
# Valid values: `lowest-price` \| `capacity-optimized`
|
3250
|
+
# optimally chosen based on the available Spot capacity. Defaults to
|
3251
|
+
# `lowest-price` if not specified.
|
3317
3252
|
# @return [String]
|
3318
3253
|
#
|
3319
3254
|
# @!attribute [rw] spot_instance_pools
|
3320
3255
|
# The number of Spot Instance pools across which to allocate your Spot
|
3321
3256
|
# Instances. The Spot pools are determined from the different instance
|
3322
|
-
# types in the
|
3323
|
-
# is
|
3324
|
-
#
|
3325
|
-
# Used only when the Spot allocation strategy is `lowest-price`.
|
3257
|
+
# types in the overrides. Defaults to 2 if not specified. Valid only
|
3258
|
+
# when the Spot allocation strategy is `lowest-price`.
|
3326
3259
|
#
|
3327
3260
|
# Valid Range: Minimum value of 1. Maximum value of 20.
|
3328
3261
|
# @return [Integer]
|
@@ -3331,10 +3264,8 @@ module Aws::AutoScaling
|
|
3331
3264
|
# The maximum price per unit hour that you are willing to pay for a
|
3332
3265
|
# Spot Instance. If you leave the value of this parameter blank (which
|
3333
3266
|
# is the default), the maximum Spot price is set at the On-Demand
|
3334
|
-
# price.
|
3335
|
-
#
|
3336
|
-
# To remove a value that you previously set, include the parameter but
|
3337
|
-
# leave the value blank.
|
3267
|
+
# price. To remove a value that you previously set, include the
|
3268
|
+
# parameter but leave the value blank.
|
3338
3269
|
# @return [String]
|
3339
3270
|
#
|
3340
3271
|
# @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/InstancesDistribution AWS API Documentation
|
@@ -3375,10 +3306,8 @@ module Aws::AutoScaling
|
|
3375
3306
|
#
|
3376
3307
|
# @!attribute [rw] image_id
|
3377
3308
|
# The ID of the Amazon Machine Image (AMI) to use to launch your EC2
|
3378
|
-
# instances.
|
3379
|
-
#
|
3380
|
-
# For more information, see [Finding an AMI][1] in the *Amazon EC2
|
3381
|
-
# User Guide for Linux Instances*.
|
3309
|
+
# instances. For more information, see [Finding an AMI][1] in the
|
3310
|
+
# *Amazon EC2 User Guide for Linux Instances*.
|
3382
3311
|
#
|
3383
3312
|
#
|
3384
3313
|
#
|
@@ -3398,10 +3327,9 @@ module Aws::AutoScaling
|
|
3398
3327
|
#
|
3399
3328
|
# @!attribute [rw] security_groups
|
3400
3329
|
# A list that contains the security groups to assign to the instances
|
3401
|
-
# in the Auto Scaling group.
|
3402
|
-
#
|
3403
|
-
#
|
3404
|
-
# *Amazon Virtual Private Cloud User Guide*.
|
3330
|
+
# in the Auto Scaling group. For more information, see [Security
|
3331
|
+
# Groups for Your VPC][1] in the *Amazon Virtual Private Cloud User
|
3332
|
+
# Guide*.
|
3405
3333
|
#
|
3406
3334
|
#
|
3407
3335
|
#
|
@@ -3410,11 +3338,9 @@ module Aws::AutoScaling
|
|
3410
3338
|
#
|
3411
3339
|
# @!attribute [rw] classic_link_vpc_id
|
3412
3340
|
# The ID of a ClassicLink-enabled VPC to link your EC2-Classic
|
3413
|
-
# instances to.
|
3414
|
-
#
|
3415
|
-
#
|
3416
|
-
# Guide for Linux Instances* and [Linking EC2-Classic Instances to a
|
3417
|
-
# VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
|
3341
|
+
# instances to. For more information, see [ClassicLink][1] in the
|
3342
|
+
# *Amazon EC2 User Guide for Linux Instances* and [Linking EC2-Classic
|
3343
|
+
# instances to a VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
|
3418
3344
|
#
|
3419
3345
|
#
|
3420
3346
|
#
|
@@ -3427,7 +3353,7 @@ module Aws::AutoScaling
|
|
3427
3353
|
# `ClassicLinkVPCId`.
|
3428
3354
|
#
|
3429
3355
|
# For more information, see [ClassicLink][1] in the *Amazon EC2 User
|
3430
|
-
# Guide for Linux Instances* and [Linking EC2-Classic
|
3356
|
+
# Guide for Linux Instances* and [Linking EC2-Classic instances to a
|
3431
3357
|
# VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
|
3432
3358
|
#
|
3433
3359
|
#
|
@@ -3438,10 +3364,8 @@ module Aws::AutoScaling
|
|
3438
3364
|
#
|
3439
3365
|
# @!attribute [rw] user_data
|
3440
3366
|
# The Base64-encoded user data to make available to the launched EC2
|
3441
|
-
# instances.
|
3442
|
-
#
|
3443
|
-
# For more information, see [Instance Metadata and User Data][1] in
|
3444
|
-
# the *Amazon EC2 User Guide for Linux Instances*.
|
3367
|
+
# instances. For more information, see [Instance metadata and user
|
3368
|
+
# data][1] in the *Amazon EC2 User Guide for Linux Instances*.
|
3445
3369
|
#
|
3446
3370
|
#
|
3447
3371
|
#
|
@@ -3470,10 +3394,8 @@ module Aws::AutoScaling
|
|
3470
3394
|
#
|
3471
3395
|
# @!attribute [rw] block_device_mappings
|
3472
3396
|
# A block device mapping, which specifies the block devices for the
|
3473
|
-
# instance.
|
3474
|
-
#
|
3475
|
-
# For more information, see [Block Device Mapping][1] in the *Amazon
|
3476
|
-
# EC2 User Guide for Linux Instances*.
|
3397
|
+
# instance. For more information, see [Block Device Mapping][1] in the
|
3398
|
+
# *Amazon EC2 User Guide for Linux Instances*.
|
3477
3399
|
#
|
3478
3400
|
#
|
3479
3401
|
#
|
@@ -3495,10 +3417,9 @@ module Aws::AutoScaling
|
|
3495
3417
|
# @!attribute [rw] spot_price
|
3496
3418
|
# The maximum hourly price to be paid for any Spot Instance launched
|
3497
3419
|
# to fulfill the request. Spot Instances are launched when the price
|
3498
|
-
# you specify exceeds the current Spot price.
|
3499
|
-
#
|
3500
|
-
#
|
3501
|
-
# Scaling Group][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
3420
|
+
# you specify exceeds the current Spot price. For more information,
|
3421
|
+
# see [Requesting Spot Instances][1] in the *Amazon EC2 Auto Scaling
|
3422
|
+
# User Guide*.
|
3502
3423
|
#
|
3503
3424
|
#
|
3504
3425
|
#
|
@@ -3508,11 +3429,9 @@ module Aws::AutoScaling
|
|
3508
3429
|
# @!attribute [rw] iam_instance_profile
|
3509
3430
|
# The name or the Amazon Resource Name (ARN) of the instance profile
|
3510
3431
|
# associated with the IAM role for the instance. The instance profile
|
3511
|
-
# contains the IAM role.
|
3512
|
-
#
|
3513
|
-
#
|
3514
|
-
# Amazon EC2 Instances][1] in the *Amazon EC2 Auto Scaling User
|
3515
|
-
# Guide*.
|
3432
|
+
# contains the IAM role. For more information, see [IAM role for
|
3433
|
+
# applications that run on Amazon EC2 instances][1] in the *Amazon EC2
|
3434
|
+
# Auto Scaling User Guide*.
|
3516
3435
|
#
|
3517
3436
|
#
|
3518
3437
|
#
|
@@ -3525,10 +3444,9 @@ module Aws::AutoScaling
|
|
3525
3444
|
#
|
3526
3445
|
# @!attribute [rw] ebs_optimized
|
3527
3446
|
# Specifies whether the launch configuration is optimized for EBS I/O
|
3528
|
-
# (`true`) or not (`false`).
|
3529
|
-
#
|
3530
|
-
#
|
3531
|
-
# *Amazon EC2 User Guide for Linux Instances*.
|
3447
|
+
# (`true`) or not (`false`). For more information, see [Amazon
|
3448
|
+
# EBS-Optimized Instances][1] in the *Amazon EC2 User Guide for Linux
|
3449
|
+
# Instances*.
|
3532
3450
|
#
|
3533
3451
|
#
|
3534
3452
|
#
|
@@ -3537,10 +3455,9 @@ module Aws::AutoScaling
|
|
3537
3455
|
#
|
3538
3456
|
# @!attribute [rw] associate_public_ip_address
|
3539
3457
|
# For Auto Scaling groups that are running in a VPC, specifies whether
|
3540
|
-
# to assign a public IP address to the group's instances.
|
3541
|
-
#
|
3542
|
-
#
|
3543
|
-
# VPC][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
3458
|
+
# to assign a public IP address to the group's instances. For more
|
3459
|
+
# information, see [Launching Auto Scaling instances in a VPC][1] in
|
3460
|
+
# the *Amazon EC2 Auto Scaling User Guide*.
|
3544
3461
|
#
|
3545
3462
|
#
|
3546
3463
|
#
|
@@ -3552,12 +3469,12 @@ module Aws::AutoScaling
|
|
3552
3469
|
# instance with `dedicated` tenancy runs on isolated, single-tenant
|
3553
3470
|
# hardware and can only be launched into a VPC.
|
3554
3471
|
#
|
3555
|
-
# For more information, see [
|
3556
|
-
# *Amazon EC2 Auto Scaling User Guide*.
|
3472
|
+
# For more information, see [Configuring instance tenancy with Amazon
|
3473
|
+
# EC2 Auto Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
3557
3474
|
#
|
3558
3475
|
#
|
3559
3476
|
#
|
3560
|
-
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/
|
3477
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-dedicated-instances.html
|
3561
3478
|
# @return [String]
|
3562
3479
|
#
|
3563
3480
|
# @!attribute [rw] metadata_options
|
@@ -3701,17 +3618,15 @@ module Aws::AutoScaling
|
|
3701
3618
|
# }
|
3702
3619
|
#
|
3703
3620
|
# @!attribute [rw] launch_template_specification
|
3704
|
-
# The launch template to use.
|
3705
|
-
# template ID or launch template name in the request.
|
3621
|
+
# The launch template to use.
|
3706
3622
|
# @return [Types::LaunchTemplateSpecification]
|
3707
3623
|
#
|
3708
3624
|
# @!attribute [rw] overrides
|
3709
3625
|
# Any parameters that you specify override the same parameters in the
|
3710
3626
|
# launch template. Currently, the only supported override is instance
|
3711
|
-
# type. You can specify between 1 and 20 instance types.
|
3712
|
-
#
|
3713
|
-
#
|
3714
|
-
# specified in the launch template to launch instances.
|
3627
|
+
# type. You can specify between 1 and 20 instance types. If not
|
3628
|
+
# provided, Amazon EC2 Auto Scaling will use the instance type
|
3629
|
+
# specified in the launch template when it launches an instance.
|
3715
3630
|
# @return [Array<Types::LaunchTemplateOverrides>]
|
3716
3631
|
#
|
3717
3632
|
# @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/LaunchTemplate AWS API Documentation
|
@@ -3738,11 +3653,11 @@ module Aws::AutoScaling
|
|
3738
3653
|
# }
|
3739
3654
|
#
|
3740
3655
|
# @!attribute [rw] instance_type
|
3741
|
-
# The instance type. You must use an instance
|
3742
|
-
# in your requested Region and Availability
|
3743
|
-
#
|
3744
|
-
#
|
3745
|
-
#
|
3656
|
+
# The instance type, such as `m3.xlarge`. You must use an instance
|
3657
|
+
# type that is supported in your requested Region and Availability
|
3658
|
+
# Zones. For information about available instance types, see
|
3659
|
+
# [Available instance types][1] in the *Amazon Elastic Compute Cloud
|
3660
|
+
# User Guide.*
|
3746
3661
|
#
|
3747
3662
|
#
|
3748
3663
|
#
|
@@ -3750,15 +3665,18 @@ module Aws::AutoScaling
|
|
3750
3665
|
# @return [String]
|
3751
3666
|
#
|
3752
3667
|
# @!attribute [rw] weighted_capacity
|
3753
|
-
# The number of capacity units
|
3754
|
-
#
|
3755
|
-
#
|
3756
|
-
#
|
3757
|
-
# capacity
|
3758
|
-
#
|
3759
|
-
#
|
3760
|
-
#
|
3761
|
-
#
|
3668
|
+
# The number of capacity units provided by the specified instance type
|
3669
|
+
# in terms of virtual CPUs, memory, storage, throughput, or other
|
3670
|
+
# relative performance characteristic. When a Spot or On-Demand
|
3671
|
+
# Instance is provisioned, the capacity units count toward the desired
|
3672
|
+
# capacity. Amazon EC2 Auto Scaling provisions instances until the
|
3673
|
+
# desired capacity is totally fulfilled, even if this results in an
|
3674
|
+
# overage. For example, if there are 2 units remaining to fulfill
|
3675
|
+
# capacity, and Amazon EC2 Auto Scaling can only provision an instance
|
3676
|
+
# with a `WeightedCapacity` of 5 units, the instance is provisioned,
|
3677
|
+
# and the desired capacity is exceeded by 3 units. For more
|
3678
|
+
# information, see [Instance weighting for Amazon EC2 Auto Scaling][1]
|
3679
|
+
# in the *Amazon EC2 Auto Scaling User Guide*.
|
3762
3680
|
#
|
3763
3681
|
# Valid Range: Minimum value of 1. Maximum value of 999.
|
3764
3682
|
#
|
@@ -3781,8 +3699,8 @@ module Aws::AutoScaling
|
|
3781
3699
|
# EC2 instances.
|
3782
3700
|
#
|
3783
3701
|
# The launch template that is specified must be configured for use with
|
3784
|
-
# an Auto Scaling group. For more information, see [Creating a
|
3785
|
-
#
|
3702
|
+
# an Auto Scaling group. For more information, see [Creating a launch
|
3703
|
+
# template for an Auto Scaling group][1] in the *Amazon EC2 Auto Scaling
|
3786
3704
|
# User Guide*.
|
3787
3705
|
#
|
3788
3706
|
#
|
@@ -3802,9 +3720,8 @@ module Aws::AutoScaling
|
|
3802
3720
|
# The ID of the launch template. To get the template ID, use the
|
3803
3721
|
# Amazon EC2 [DescribeLaunchTemplates][1] API operation. New launch
|
3804
3722
|
# templates can be created using the Amazon EC2
|
3805
|
-
# [CreateLaunchTemplate][2] API.
|
3806
|
-
#
|
3807
|
-
# You must specify either a template ID or a template name.
|
3723
|
+
# [CreateLaunchTemplate][2] API. You must specify either a
|
3724
|
+
# `LaunchTemplateId` or a `LaunchTemplateName`.
|
3808
3725
|
#
|
3809
3726
|
#
|
3810
3727
|
#
|
@@ -3816,9 +3733,8 @@ module Aws::AutoScaling
|
|
3816
3733
|
# The name of the launch template. To get the template name, use the
|
3817
3734
|
# Amazon EC2 [DescribeLaunchTemplates][1] API operation. New launch
|
3818
3735
|
# templates can be created using the Amazon EC2
|
3819
|
-
# [CreateLaunchTemplate][2] API.
|
3820
|
-
#
|
3821
|
-
# You must specify either a template ID or a template name.
|
3736
|
+
# [CreateLaunchTemplate][2] API. You must specify either a
|
3737
|
+
# `LaunchTemplateId` or a `LaunchTemplateName`.
|
3822
3738
|
#
|
3823
3739
|
#
|
3824
3740
|
#
|
@@ -3830,13 +3746,12 @@ module Aws::AutoScaling
|
|
3830
3746
|
# The version number, `$Latest`, or `$Default`. To get the version
|
3831
3747
|
# number, use the Amazon EC2 [DescribeLaunchTemplateVersions][1] API
|
3832
3748
|
# operation. New launch template versions can be created using the
|
3833
|
-
# Amazon EC2 [CreateLaunchTemplateVersion][2] API.
|
3834
|
-
#
|
3835
|
-
#
|
3836
|
-
#
|
3837
|
-
# the
|
3838
|
-
#
|
3839
|
-
# value is `$Default`.
|
3749
|
+
# Amazon EC2 [CreateLaunchTemplateVersion][2] API. If the value is
|
3750
|
+
# `$Latest`, Amazon EC2 Auto Scaling selects the latest version of the
|
3751
|
+
# launch template when launching instances. If the value is
|
3752
|
+
# `$Default`, Amazon EC2 Auto Scaling selects the default version of
|
3753
|
+
# the launch template when launching instances. The default value is
|
3754
|
+
# `$Default`.
|
3840
3755
|
#
|
3841
3756
|
#
|
3842
3757
|
#
|
@@ -3956,7 +3871,7 @@ module Aws::AutoScaling
|
|
3956
3871
|
# 5. If you finish before the timeout period ends, complete the
|
3957
3872
|
# lifecycle action.
|
3958
3873
|
#
|
3959
|
-
# For more information, see [Amazon EC2 Auto Scaling
|
3874
|
+
# For more information, see [Amazon EC2 Auto Scaling lifecycle hooks][1]
|
3960
3875
|
# in the *Amazon EC2 Auto Scaling User Guide*.
|
3961
3876
|
#
|
3962
3877
|
#
|
@@ -4240,8 +4155,7 @@ module Aws::AutoScaling
|
|
4240
4155
|
# You can create a mixed instances policy for a new Auto Scaling group,
|
4241
4156
|
# or you can create it for an existing group by updating the group to
|
4242
4157
|
# specify `MixedInstancesPolicy` as the top-level parameter instead of a
|
4243
|
-
# launch configuration or launch template.
|
4244
|
-
# CreateAutoScalingGroup and UpdateAutoScalingGroup.
|
4158
|
+
# launch configuration or launch template.
|
4245
4159
|
#
|
4246
4160
|
#
|
4247
4161
|
#
|
@@ -4275,16 +4189,15 @@ module Aws::AutoScaling
|
|
4275
4189
|
# }
|
4276
4190
|
#
|
4277
4191
|
# @!attribute [rw] launch_template
|
4278
|
-
#
|
4279
|
-
#
|
4280
|
-
# Required when creating a
|
4192
|
+
# Specifies the launch template to use and optionally the instance
|
4193
|
+
# types (overrides) that are used to provision EC2 instances to
|
4194
|
+
# fulfill On-Demand and Spot capacities. Required when creating a
|
4195
|
+
# mixed instances policy.
|
4281
4196
|
# @return [Types::LaunchTemplate]
|
4282
4197
|
#
|
4283
4198
|
# @!attribute [rw] instances_distribution
|
4284
|
-
#
|
4285
|
-
#
|
4286
|
-
# If you leave this parameter unspecified, the value for each
|
4287
|
-
# parameter in `InstancesDistribution` uses a default value.
|
4199
|
+
# Specifies the instances distribution. If not provided, the value for
|
4200
|
+
# each parameter in `InstancesDistribution` uses a default value.
|
4288
4201
|
# @return [Types::InstancesDistribution]
|
4289
4202
|
#
|
4290
4203
|
# @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/MixedInstancesPolicy AWS API Documentation
|
@@ -4441,7 +4354,7 @@ module Aws::AutoScaling
|
|
4441
4354
|
|
4442
4355
|
# Describes a process type.
|
4443
4356
|
#
|
4444
|
-
# For more information, see [Scaling
|
4357
|
+
# For more information, see [Scaling processes][1] in the *Amazon EC2
|
4445
4358
|
# Auto Scaling User Guide*.
|
4446
4359
|
#
|
4447
4360
|
#
|
@@ -4695,7 +4608,7 @@ module Aws::AutoScaling
|
|
4695
4608
|
# `ChangeInCapacity`, `ExactCapacity`, and `PercentChangeInCapacity`.
|
4696
4609
|
#
|
4697
4610
|
# Required if the policy type is `StepScaling` or `SimpleScaling`. For
|
4698
|
-
# more information, see [Scaling
|
4611
|
+
# more information, see [Scaling adjustment types][1] in the *Amazon
|
4699
4612
|
# EC2 Auto Scaling User Guide*.
|
4700
4613
|
#
|
4701
4614
|
#
|
@@ -4718,7 +4631,7 @@ module Aws::AutoScaling
|
|
4718
4631
|
# Amazon EC2 Auto Scaling scales out the group by 2 instances.
|
4719
4632
|
#
|
4720
4633
|
# Valid only if the policy type is `StepScaling` or `SimpleScaling`.
|
4721
|
-
# For more information, see [Scaling
|
4634
|
+
# For more information, see [Scaling adjustment types][1] in the
|
4722
4635
|
# *Amazon EC2 Auto Scaling User Guide*.
|
4723
4636
|
#
|
4724
4637
|
# <note markdown="1"> Some Auto Scaling groups use instance weights. In this case, set the
|
@@ -4748,7 +4661,7 @@ module Aws::AutoScaling
|
|
4748
4661
|
# period defined for the Auto Scaling group.
|
4749
4662
|
#
|
4750
4663
|
# Valid only if the policy type is `SimpleScaling`. For more
|
4751
|
-
# information, see [Scaling
|
4664
|
+
# information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1]
|
4752
4665
|
# in the *Amazon EC2 Auto Scaling User Guide*.
|
4753
4666
|
#
|
4754
4667
|
#
|
@@ -4812,8 +4725,8 @@ module Aws::AutoScaling
|
|
4812
4725
|
#
|
4813
4726
|
# @!attribute [rw] enabled
|
4814
4727
|
# Indicates whether the scaling policy is enabled or disabled. The
|
4815
|
-
# default is enabled. For more information, see [Disabling a
|
4816
|
-
#
|
4728
|
+
# default is enabled. For more information, see [Disabling a scaling
|
4729
|
+
# policy for an Auto Scaling group][1] in the *Amazon EC2 Auto Scaling
|
4817
4730
|
# User Guide*.
|
4818
4731
|
#
|
4819
4732
|
#
|
@@ -5076,8 +4989,8 @@ module Aws::AutoScaling
|
|
5076
4989
|
#
|
5077
4990
|
# * `SimpleScaling` (default)
|
5078
4991
|
#
|
5079
|
-
# For more information, see [Target
|
5080
|
-
# [Step and
|
4992
|
+
# For more information, see [Target tracking scaling policies][1] and
|
4993
|
+
# [Step and simple scaling policies][2] in the *Amazon EC2 Auto
|
5081
4994
|
# Scaling User Guide*.
|
5082
4995
|
#
|
5083
4996
|
#
|
@@ -5488,7 +5401,7 @@ module Aws::AutoScaling
|
|
5488
5401
|
# }
|
5489
5402
|
#
|
5490
5403
|
# @!attribute [rw] instance_ids
|
5491
|
-
# One or more instance IDs.
|
5404
|
+
# One or more instance IDs. You can specify up to 50 instances.
|
5492
5405
|
# @return [Array<String>]
|
5493
5406
|
#
|
5494
5407
|
# @!attribute [rw] auto_scaling_group_name
|
@@ -5605,7 +5518,7 @@ module Aws::AutoScaling
|
|
5605
5518
|
# * The upper and lower bound can't be null in the same step
|
5606
5519
|
# adjustment.
|
5607
5520
|
#
|
5608
|
-
# For more information, see [Step
|
5521
|
+
# For more information, see [Step adjustments][1] in the *Amazon EC2
|
5609
5522
|
# Auto Scaling User Guide*.
|
5610
5523
|
#
|
5611
5524
|
#
|
@@ -5657,9 +5570,9 @@ module Aws::AutoScaling
|
|
5657
5570
|
include Aws::Structure
|
5658
5571
|
end
|
5659
5572
|
|
5660
|
-
# Describes an
|
5573
|
+
# Describes an auto scaling process that has been suspended.
|
5661
5574
|
#
|
5662
|
-
# For more information, see [Scaling
|
5575
|
+
# For more information, see [Scaling processes][1] in the *Amazon EC2
|
5663
5576
|
# Auto Scaling User Guide*.
|
5664
5577
|
#
|
5665
5578
|
#
|
@@ -5937,31 +5850,18 @@ module Aws::AutoScaling
|
|
5937
5850
|
# The launch template and version to use to specify the updates. If
|
5938
5851
|
# you specify `LaunchTemplate` in your update request, you can't
|
5939
5852
|
# specify `LaunchConfigurationName` or `MixedInstancesPolicy`.
|
5940
|
-
#
|
5941
|
-
# For more information, see [LaunchTemplateSpecification][1] in the
|
5942
|
-
# *Amazon EC2 Auto Scaling API Reference*.
|
5943
|
-
#
|
5944
|
-
#
|
5945
|
-
#
|
5946
|
-
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_LaunchTemplateSpecification.html
|
5947
5853
|
# @return [Types::LaunchTemplateSpecification]
|
5948
5854
|
#
|
5949
5855
|
# @!attribute [rw] mixed_instances_policy
|
5950
|
-
# An embedded object that specifies a mixed instances policy.
|
5951
|
-
#
|
5952
|
-
#
|
5953
|
-
#
|
5954
|
-
#
|
5955
|
-
#
|
5956
|
-
# For more information, see [MixedInstancesPolicy][1] in the *Amazon
|
5957
|
-
# EC2 Auto Scaling API Reference* and [Auto Scaling Groups with
|
5958
|
-
# Multiple Instance Types and Purchase Options][2] in the *Amazon EC2
|
5959
|
-
# Auto Scaling User Guide*.
|
5856
|
+
# An embedded object that specifies a mixed instances policy. When you
|
5857
|
+
# make changes to an existing policy, all optional parameters are left
|
5858
|
+
# unchanged if not specified. For more information, see [Auto Scaling
|
5859
|
+
# Groups with Multiple Instance Types and Purchase Options][1] in the
|
5860
|
+
# *Amazon EC2 Auto Scaling User Guide*.
|
5960
5861
|
#
|
5961
5862
|
#
|
5962
5863
|
#
|
5963
|
-
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/
|
5964
|
-
# [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
|
5864
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
|
5965
5865
|
# @return [Types::MixedInstancesPolicy]
|
5966
5866
|
#
|
5967
5867
|
# @!attribute [rw] min_size
|
@@ -5984,20 +5884,17 @@ module Aws::AutoScaling
|
|
5984
5884
|
# @!attribute [rw] desired_capacity
|
5985
5885
|
# The desired capacity is the initial capacity of the Auto Scaling
|
5986
5886
|
# group after this operation completes and the capacity it attempts to
|
5987
|
-
# maintain.
|
5988
|
-
#
|
5989
|
-
#
|
5990
|
-
# group and less than or equal to the maximum size of the group.
|
5887
|
+
# maintain. This number must be greater than or equal to the minimum
|
5888
|
+
# size of the group and less than or equal to the maximum size of the
|
5889
|
+
# group.
|
5991
5890
|
# @return [Integer]
|
5992
5891
|
#
|
5993
5892
|
# @!attribute [rw] default_cooldown
|
5994
5893
|
# The amount of time, in seconds, after a scaling activity completes
|
5995
5894
|
# before another scaling activity can start. The default value is
|
5996
|
-
# `300`.
|
5997
|
-
#
|
5998
|
-
#
|
5999
|
-
# when using other scaling policies or scheduled scaling. For more
|
6000
|
-
# information, see [Scaling Cooldowns for Amazon EC2 Auto Scaling][1]
|
5895
|
+
# `300`. This setting applies when using simple scaling policies, but
|
5896
|
+
# not when using other scaling policies or scheduled scaling. For more
|
5897
|
+
# information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1]
|
6001
5898
|
# in the *Amazon EC2 Auto Scaling User Guide*.
|
6002
5899
|
#
|
6003
5900
|
#
|
@@ -6019,12 +5916,11 @@ module Aws::AutoScaling
|
|
6019
5916
|
# @!attribute [rw] health_check_grace_period
|
6020
5917
|
# The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
|
6021
5918
|
# before checking the health status of an EC2 instance that has come
|
6022
|
-
# into service. The default value is `0`.
|
6023
|
-
#
|
6024
|
-
#
|
6025
|
-
# *Amazon EC2 Auto Scaling User Guide*.
|
5919
|
+
# into service. The default value is `0`. For more information, see
|
5920
|
+
# [Health check grace period][1] in the *Amazon EC2 Auto Scaling User
|
5921
|
+
# Guide*.
|
6026
5922
|
#
|
6027
|
-
# Required if you are adding an `ELB` health check.
|
5923
|
+
# Conditional: Required if you are adding an `ELB` health check.
|
6028
5924
|
#
|
6029
5925
|
#
|
6030
5926
|
#
|
@@ -6032,11 +5928,12 @@ module Aws::AutoScaling
|
|
6032
5928
|
# @return [Integer]
|
6033
5929
|
#
|
6034
5930
|
# @!attribute [rw] placement_group
|
6035
|
-
# The name of
|
6036
|
-
# if any. A placement group is a logical grouping of
|
6037
|
-
# a single Availability Zone. You cannot specify
|
6038
|
-
# Zones and a placement group. For more
|
6039
|
-
# Groups][1] in the *Amazon EC2 User Guide
|
5931
|
+
# The name of an existing placement group into which to launch your
|
5932
|
+
# instances, if any. A placement group is a logical grouping of
|
5933
|
+
# instances within a single Availability Zone. You cannot specify
|
5934
|
+
# multiple Availability Zones and a placement group. For more
|
5935
|
+
# information, see [Placement Groups][1] in the *Amazon EC2 User Guide
|
5936
|
+
# for Linux Instances*.
|
6040
5937
|
#
|
6041
5938
|
#
|
6042
5939
|
#
|
@@ -6044,22 +5941,18 @@ module Aws::AutoScaling
|
|
6044
5941
|
# @return [String]
|
6045
5942
|
#
|
6046
5943
|
# @!attribute [rw] vpc_zone_identifier
|
6047
|
-
# A comma-separated list of subnet IDs for virtual private cloud
|
6048
|
-
# (VPC).
|
6049
|
-
#
|
6050
|
-
# If you specify `VPCZoneIdentifier` with `AvailabilityZones`, the
|
6051
|
-
# subnets that you specify for this parameter must reside in those
|
5944
|
+
# A comma-separated list of subnet IDs for a virtual private cloud
|
5945
|
+
# (VPC). If you specify `VPCZoneIdentifier` with `AvailabilityZones`,
|
5946
|
+
# the subnets that you specify for this parameter must reside in those
|
6052
5947
|
# Availability Zones.
|
6053
5948
|
# @return [String]
|
6054
5949
|
#
|
6055
5950
|
# @!attribute [rw] termination_policies
|
6056
|
-
# A
|
6057
|
-
#
|
6058
|
-
#
|
6059
|
-
#
|
6060
|
-
#
|
6061
|
-
# Terminates During Scale In][1] in the *Amazon EC2 Auto Scaling User
|
6062
|
-
# Guide*.
|
5951
|
+
# A policy or a list of policies that are used to select the instances
|
5952
|
+
# to terminate. The policies are executed in the order that you list
|
5953
|
+
# them. For more information, see [Controlling which Auto Scaling
|
5954
|
+
# instances terminate during scale in][1] in the *Amazon EC2 Auto
|
5955
|
+
# Scaling User Guide*.
|
6063
5956
|
#
|
6064
5957
|
#
|
6065
5958
|
#
|
@@ -6068,10 +5961,9 @@ module Aws::AutoScaling
|
|
6068
5961
|
#
|
6069
5962
|
# @!attribute [rw] new_instances_protected_from_scale_in
|
6070
5963
|
# Indicates whether newly launched instances are protected from
|
6071
|
-
# termination by Amazon EC2 Auto Scaling when scaling in.
|
6072
|
-
#
|
6073
|
-
#
|
6074
|
-
# scale in, see [Instance Protection][1] in the *Amazon EC2 Auto
|
5964
|
+
# termination by Amazon EC2 Auto Scaling when scaling in. For more
|
5965
|
+
# information about preventing instances from terminating on scale in,
|
5966
|
+
# see [Instance scale-in protection][1] in the *Amazon EC2 Auto
|
6075
5967
|
# Scaling User Guide*.
|
6076
5968
|
#
|
6077
5969
|
#
|
@@ -6082,7 +5974,7 @@ module Aws::AutoScaling
|
|
6082
5974
|
# @!attribute [rw] service_linked_role_arn
|
6083
5975
|
# The Amazon Resource Name (ARN) of the service-linked role that the
|
6084
5976
|
# Auto Scaling group uses to call other AWS services on your behalf.
|
6085
|
-
# For more information, see [Service-
|
5977
|
+
# For more information, see [Service-linked roles][1] in the *Amazon
|
6086
5978
|
# EC2 Auto Scaling User Guide*.
|
6087
5979
|
#
|
6088
5980
|
#
|
@@ -6092,17 +5984,11 @@ module Aws::AutoScaling
|
|
6092
5984
|
#
|
6093
5985
|
# @!attribute [rw] max_instance_lifetime
|
6094
5986
|
# The maximum amount of time, in seconds, that an instance can be in
|
6095
|
-
# service. The default is null.
|
6096
|
-
#
|
6097
|
-
#
|
6098
|
-
#
|
6099
|
-
#
|
6100
|
-
#
|
6101
|
-
# For more information, see [Replacing Auto Scaling Instances Based on
|
6102
|
-
# Maximum Instance Lifetime][1] in the *Amazon EC2 Auto Scaling User
|
6103
|
-
# Guide*.
|
6104
|
-
#
|
6105
|
-
# Valid Range: Minimum value of 0.
|
5987
|
+
# service. The default is null. If specified, the value must be either
|
5988
|
+
# 0 or a number equal to or greater than 86,400 seconds (1 day). To
|
5989
|
+
# clear a previously set value, specify a new value of 0. For more
|
5990
|
+
# information, see [Replacing Auto Scaling instances based on maximum
|
5991
|
+
# instance lifetime][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
6106
5992
|
#
|
6107
5993
|
#
|
6108
5994
|
#
|
@@ -6110,16 +5996,9 @@ module Aws::AutoScaling
|
|
6110
5996
|
# @return [Integer]
|
6111
5997
|
#
|
6112
5998
|
# @!attribute [rw] capacity_rebalance
|
6113
|
-
# Enables or disables
|
6114
|
-
#
|
6115
|
-
#
|
6116
|
-
# when using Spot Instances. When you turn on capacity rebalancing,
|
6117
|
-
# Amazon EC2 Auto Scaling attempts to launch a Spot Instance whenever
|
6118
|
-
# Amazon EC2 predicts that a Spot Instance is at an elevated risk of
|
6119
|
-
# interruption. After launching a new instance, it then terminates an
|
6120
|
-
# old instance. For more information, see [Amazon EC2 Auto Scaling
|
6121
|
-
# capacity rebalancing][1] in the *Amazon EC2 Auto Scaling User
|
6122
|
-
# Guide*.
|
5999
|
+
# Enables or disables Capacity Rebalancing. For more information, see
|
6000
|
+
# [Amazon EC2 Auto Scaling Capacity Rebalancing][1] in the *Amazon EC2
|
6001
|
+
# Auto Scaling User Guide*.
|
6123
6002
|
#
|
6124
6003
|
#
|
6125
6004
|
#
|