aws-sdk-autoscaling 1.45.0 → 1.50.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/lib/aws-sdk-autoscaling.rb +2 -1
- data/lib/aws-sdk-autoscaling/auto_scaling_group.rb +60 -65
- data/lib/aws-sdk-autoscaling/client.rb +245 -259
- data/lib/aws-sdk-autoscaling/client_api.rb +5 -0
- data/lib/aws-sdk-autoscaling/launch_configuration.rb +30 -44
- data/lib/aws-sdk-autoscaling/resource.rb +130 -145
- data/lib/aws-sdk-autoscaling/scaling_policy.rb +3 -3
- data/lib/aws-sdk-autoscaling/types.rb +367 -401
- metadata +4 -4
@@ -57,6 +57,7 @@ module Aws::AutoScaling
|
|
57
57
|
BlockDeviceMappings = Shapes::ListShape.new(name: 'BlockDeviceMappings')
|
58
58
|
CancelInstanceRefreshAnswer = Shapes::StructureShape.new(name: 'CancelInstanceRefreshAnswer')
|
59
59
|
CancelInstanceRefreshType = Shapes::StructureShape.new(name: 'CancelInstanceRefreshType')
|
60
|
+
CapacityRebalanceEnabled = Shapes::BooleanShape.new(name: 'CapacityRebalanceEnabled')
|
60
61
|
ClassicLinkVPCSecurityGroups = Shapes::ListShape.new(name: 'ClassicLinkVPCSecurityGroups')
|
61
62
|
CompleteLifecycleActionAnswer = Shapes::StructureShape.new(name: 'CompleteLifecycleActionAnswer')
|
62
63
|
CompleteLifecycleActionType = Shapes::StructureShape.new(name: 'CompleteLifecycleActionType')
|
@@ -358,6 +359,7 @@ module Aws::AutoScaling
|
|
358
359
|
AutoScalingGroup.add_member(:new_instances_protected_from_scale_in, Shapes::ShapeRef.new(shape: InstanceProtected, location_name: "NewInstancesProtectedFromScaleIn"))
|
359
360
|
AutoScalingGroup.add_member(:service_linked_role_arn, Shapes::ShapeRef.new(shape: ResourceName, location_name: "ServiceLinkedRoleARN"))
|
360
361
|
AutoScalingGroup.add_member(:max_instance_lifetime, Shapes::ShapeRef.new(shape: MaxInstanceLifetime, location_name: "MaxInstanceLifetime"))
|
362
|
+
AutoScalingGroup.add_member(:capacity_rebalance, Shapes::ShapeRef.new(shape: CapacityRebalanceEnabled, location_name: "CapacityRebalance"))
|
361
363
|
AutoScalingGroup.struct_class = Types::AutoScalingGroup
|
362
364
|
|
363
365
|
AutoScalingGroupNames.member = Shapes::ShapeRef.new(shape: ResourceName)
|
@@ -452,6 +454,7 @@ module Aws::AutoScaling
|
|
452
454
|
CreateAutoScalingGroupType.add_member(:vpc_zone_identifier, Shapes::ShapeRef.new(shape: XmlStringMaxLen2047, location_name: "VPCZoneIdentifier"))
|
453
455
|
CreateAutoScalingGroupType.add_member(:termination_policies, Shapes::ShapeRef.new(shape: TerminationPolicies, location_name: "TerminationPolicies"))
|
454
456
|
CreateAutoScalingGroupType.add_member(:new_instances_protected_from_scale_in, Shapes::ShapeRef.new(shape: InstanceProtected, location_name: "NewInstancesProtectedFromScaleIn"))
|
457
|
+
CreateAutoScalingGroupType.add_member(:capacity_rebalance, Shapes::ShapeRef.new(shape: CapacityRebalanceEnabled, location_name: "CapacityRebalance"))
|
455
458
|
CreateAutoScalingGroupType.add_member(:lifecycle_hook_specification_list, Shapes::ShapeRef.new(shape: LifecycleHookSpecifications, location_name: "LifecycleHookSpecificationList"))
|
456
459
|
CreateAutoScalingGroupType.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "Tags"))
|
457
460
|
CreateAutoScalingGroupType.add_member(:service_linked_role_arn, Shapes::ShapeRef.new(shape: ResourceName, location_name: "ServiceLinkedRoleARN"))
|
@@ -784,6 +787,7 @@ module Aws::AutoScaling
|
|
784
787
|
|
785
788
|
LaunchTemplateOverrides.add_member(:instance_type, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, location_name: "InstanceType"))
|
786
789
|
LaunchTemplateOverrides.add_member(:weighted_capacity, Shapes::ShapeRef.new(shape: XmlStringMaxLen32, location_name: "WeightedCapacity"))
|
790
|
+
LaunchTemplateOverrides.add_member(:launch_template_specification, Shapes::ShapeRef.new(shape: LaunchTemplateSpecification, location_name: "LaunchTemplateSpecification"))
|
787
791
|
LaunchTemplateOverrides.struct_class = Types::LaunchTemplateOverrides
|
788
792
|
|
789
793
|
LaunchTemplateSpecification.add_member(:launch_template_id, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, location_name: "LaunchTemplateId"))
|
@@ -1105,6 +1109,7 @@ module Aws::AutoScaling
|
|
1105
1109
|
UpdateAutoScalingGroupType.add_member(:new_instances_protected_from_scale_in, Shapes::ShapeRef.new(shape: InstanceProtected, location_name: "NewInstancesProtectedFromScaleIn"))
|
1106
1110
|
UpdateAutoScalingGroupType.add_member(:service_linked_role_arn, Shapes::ShapeRef.new(shape: ResourceName, location_name: "ServiceLinkedRoleARN"))
|
1107
1111
|
UpdateAutoScalingGroupType.add_member(:max_instance_lifetime, Shapes::ShapeRef.new(shape: MaxInstanceLifetime, location_name: "MaxInstanceLifetime"))
|
1112
|
+
UpdateAutoScalingGroupType.add_member(:capacity_rebalance, Shapes::ShapeRef.new(shape: CapacityRebalanceEnabled, location_name: "CapacityRebalance"))
|
1108
1113
|
UpdateAutoScalingGroupType.struct_class = Types::UpdateAutoScalingGroupType
|
1109
1114
|
|
1110
1115
|
Values.member = Shapes::ShapeRef.new(shape: XmlString)
|
@@ -42,10 +42,8 @@ module Aws::AutoScaling
|
|
42
42
|
end
|
43
43
|
|
44
44
|
# The ID of the Amazon Machine Image (AMI) to use to launch your EC2
|
45
|
-
# instances.
|
46
|
-
#
|
47
|
-
# For more information, see [Finding an AMI][1] in the *Amazon EC2 User
|
48
|
-
# Guide for Linux Instances*.
|
45
|
+
# instances. For more information, see [Finding an AMI][1] in the
|
46
|
+
# *Amazon EC2 User Guide for Linux Instances*.
|
49
47
|
#
|
50
48
|
#
|
51
49
|
#
|
@@ -69,10 +67,8 @@ module Aws::AutoScaling
|
|
69
67
|
end
|
70
68
|
|
71
69
|
# A list that contains the security groups to assign to the instances in
|
72
|
-
# the Auto Scaling group.
|
73
|
-
#
|
74
|
-
# For more information, see [Security Groups for Your VPC][1] in the
|
75
|
-
# *Amazon Virtual Private Cloud User Guide*.
|
70
|
+
# the Auto Scaling group. For more information, see [Security Groups for
|
71
|
+
# Your VPC][1] in the *Amazon Virtual Private Cloud User Guide*.
|
76
72
|
#
|
77
73
|
#
|
78
74
|
#
|
@@ -83,10 +79,8 @@ module Aws::AutoScaling
|
|
83
79
|
end
|
84
80
|
|
85
81
|
# The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances
|
86
|
-
# to.
|
87
|
-
#
|
88
|
-
# For more information, see [ClassicLink][1] in the *Amazon EC2 User
|
89
|
-
# Guide for Linux Instances* and [Linking EC2-Classic Instances to a
|
82
|
+
# to. For more information, see [ClassicLink][1] in the *Amazon EC2 User
|
83
|
+
# Guide for Linux Instances* and [Linking EC2-Classic instances to a
|
90
84
|
# VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
|
91
85
|
#
|
92
86
|
#
|
@@ -102,7 +96,7 @@ module Aws::AutoScaling
|
|
102
96
|
# `ClassicLinkVPCId`.
|
103
97
|
#
|
104
98
|
# For more information, see [ClassicLink][1] in the *Amazon EC2 User
|
105
|
-
# Guide for Linux Instances* and [Linking EC2-Classic
|
99
|
+
# Guide for Linux Instances* and [Linking EC2-Classic instances to a
|
106
100
|
# VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
|
107
101
|
#
|
108
102
|
#
|
@@ -115,10 +109,8 @@ module Aws::AutoScaling
|
|
115
109
|
end
|
116
110
|
|
117
111
|
# The Base64-encoded user data to make available to the launched EC2
|
118
|
-
# instances.
|
119
|
-
#
|
120
|
-
# For more information, see [Instance Metadata and User Data][1] in the
|
121
|
-
# *Amazon EC2 User Guide for Linux Instances*.
|
112
|
+
# instances. For more information, see [Instance metadata and user
|
113
|
+
# data][1] in the *Amazon EC2 User Guide for Linux Instances*.
|
122
114
|
#
|
123
115
|
#
|
124
116
|
#
|
@@ -154,10 +146,8 @@ module Aws::AutoScaling
|
|
154
146
|
end
|
155
147
|
|
156
148
|
# A block device mapping, which specifies the block devices for the
|
157
|
-
# instance.
|
158
|
-
#
|
159
|
-
# For more information, see [Block Device Mapping][1] in the *Amazon EC2
|
160
|
-
# User Guide for Linux Instances*.
|
149
|
+
# instance. For more information, see [Block Device Mapping][1] in the
|
150
|
+
# *Amazon EC2 User Guide for Linux Instances*.
|
161
151
|
#
|
162
152
|
#
|
163
153
|
#
|
@@ -175,7 +165,7 @@ module Aws::AutoScaling
|
|
175
165
|
#
|
176
166
|
#
|
177
167
|
#
|
178
|
-
# [1]: https://docs.aws.amazon.com/autoscaling/latest/userguide/
|
168
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/latest/userguide/enable-as-instance-metrics.html
|
179
169
|
# @return [Types::InstanceMonitoring]
|
180
170
|
def instance_monitoring
|
181
171
|
data[:instance_monitoring]
|
@@ -183,10 +173,9 @@ module Aws::AutoScaling
|
|
183
173
|
|
184
174
|
# The maximum hourly price to be paid for any Spot Instance launched to
|
185
175
|
# fulfill the request. Spot Instances are launched when the price you
|
186
|
-
# specify exceeds the current Spot price.
|
187
|
-
#
|
188
|
-
#
|
189
|
-
# Scaling Group][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
176
|
+
# specify exceeds the current Spot price. For more information, see
|
177
|
+
# [Requesting Spot Instances][1] in the *Amazon EC2 Auto Scaling User
|
178
|
+
# Guide*.
|
190
179
|
#
|
191
180
|
#
|
192
181
|
#
|
@@ -198,10 +187,9 @@ module Aws::AutoScaling
|
|
198
187
|
|
199
188
|
# The name or the Amazon Resource Name (ARN) of the instance profile
|
200
189
|
# associated with the IAM role for the instance. The instance profile
|
201
|
-
# contains the IAM role.
|
202
|
-
#
|
203
|
-
#
|
204
|
-
# Amazon EC2 Instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
190
|
+
# contains the IAM role. For more information, see [IAM role for
|
191
|
+
# applications that run on Amazon EC2 instances][1] in the *Amazon EC2
|
192
|
+
# Auto Scaling User Guide*.
|
205
193
|
#
|
206
194
|
#
|
207
195
|
#
|
@@ -218,10 +206,9 @@ module Aws::AutoScaling
|
|
218
206
|
end
|
219
207
|
|
220
208
|
# Specifies whether the launch configuration is optimized for EBS I/O
|
221
|
-
# (`true`) or not (`false`).
|
222
|
-
#
|
223
|
-
#
|
224
|
-
# *Amazon EC2 User Guide for Linux Instances*.
|
209
|
+
# (`true`) or not (`false`). For more information, see [Amazon
|
210
|
+
# EBS-Optimized Instances][1] in the *Amazon EC2 User Guide for Linux
|
211
|
+
# Instances*.
|
225
212
|
#
|
226
213
|
#
|
227
214
|
#
|
@@ -232,10 +219,9 @@ module Aws::AutoScaling
|
|
232
219
|
end
|
233
220
|
|
234
221
|
# For Auto Scaling groups that are running in a VPC, specifies whether
|
235
|
-
# to assign a public IP address to the group's instances.
|
236
|
-
#
|
237
|
-
#
|
238
|
-
# VPC][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
222
|
+
# to assign a public IP address to the group's instances. For more
|
223
|
+
# information, see [Launching Auto Scaling instances in a VPC][1] in the
|
224
|
+
# *Amazon EC2 Auto Scaling User Guide*.
|
239
225
|
#
|
240
226
|
#
|
241
227
|
#
|
@@ -249,24 +235,24 @@ module Aws::AutoScaling
|
|
249
235
|
# instance with `dedicated` tenancy runs on isolated, single-tenant
|
250
236
|
# hardware and can only be launched into a VPC.
|
251
237
|
#
|
252
|
-
# For more information, see [
|
253
|
-
# *Amazon EC2 Auto Scaling User Guide*.
|
238
|
+
# For more information, see [Configuring instance tenancy with Amazon
|
239
|
+
# EC2 Auto Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
254
240
|
#
|
255
241
|
#
|
256
242
|
#
|
257
|
-
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/
|
243
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-dedicated-instances.html
|
258
244
|
# @return [String]
|
259
245
|
def placement_tenancy
|
260
246
|
data[:placement_tenancy]
|
261
247
|
end
|
262
248
|
|
263
249
|
# The metadata options for the instances. For more information, see
|
264
|
-
# [Instance Metadata
|
265
|
-
#
|
250
|
+
# [Configuring the Instance Metadata Options][1] in the *Amazon EC2 Auto
|
251
|
+
# Scaling User Guide*.
|
266
252
|
#
|
267
253
|
#
|
268
254
|
#
|
269
|
-
# [1]: https://docs.aws.amazon.com/
|
255
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-launch-config.html#launch-configurations-imds
|
270
256
|
# @return [Types::InstanceMetadataOptions]
|
271
257
|
def metadata_options
|
272
258
|
data[:metadata_options]
|
@@ -56,6 +56,11 @@ module Aws::AutoScaling
|
|
56
56
|
# {
|
57
57
|
# instance_type: "XmlStringMaxLen255",
|
58
58
|
# weighted_capacity: "XmlStringMaxLen32",
|
59
|
+
# launch_template_specification: {
|
60
|
+
# launch_template_id: "XmlStringMaxLen255",
|
61
|
+
# launch_template_name: "LaunchTemplateName",
|
62
|
+
# version: "XmlStringMaxLen255",
|
63
|
+
# },
|
59
64
|
# },
|
60
65
|
# ],
|
61
66
|
# },
|
@@ -82,6 +87,7 @@ module Aws::AutoScaling
|
|
82
87
|
# vpc_zone_identifier: "XmlStringMaxLen2047",
|
83
88
|
# termination_policies: ["XmlStringMaxLen1600"],
|
84
89
|
# new_instances_protected_from_scale_in: false,
|
90
|
+
# capacity_rebalance: false,
|
85
91
|
# lifecycle_hook_specification_list: [
|
86
92
|
# {
|
87
93
|
# lifecycle_hook_name: "AsciiStringMaxLen255", # required
|
@@ -110,31 +116,30 @@ module Aws::AutoScaling
|
|
110
116
|
# The name of the Auto Scaling group. This name must be unique per
|
111
117
|
# Region per account.
|
112
118
|
# @option options [String] :launch_configuration_name
|
113
|
-
# The name of the launch configuration to use
|
114
|
-
#
|
115
|
-
#
|
116
|
-
#
|
117
|
-
#
|
118
|
-
# You must specify one of the following parameters in your request:
|
119
|
-
# `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
|
120
|
-
# `MixedInstancesPolicy`.
|
119
|
+
# The name of the launch configuration to use to launch instances.
|
120
|
+
#
|
121
|
+
# Conditional: You must specify either a launch template
|
122
|
+
# (`LaunchTemplate` or `MixedInstancesPolicy`) or a launch configuration
|
123
|
+
# (`LaunchConfigurationName` or `InstanceId`).
|
121
124
|
# @option options [Types::LaunchTemplateSpecification] :launch_template
|
122
|
-
# Parameters used to specify the launch template and version to use
|
123
|
-
#
|
125
|
+
# Parameters used to specify the [launch template][1] and version to use
|
126
|
+
# to launch instances.
|
124
127
|
#
|
125
|
-
#
|
126
|
-
#
|
128
|
+
# Conditional: You must specify either a launch template
|
129
|
+
# (`LaunchTemplate` or `MixedInstancesPolicy`) or a launch configuration
|
130
|
+
# (`LaunchConfigurationName` or `InstanceId`).
|
127
131
|
#
|
128
|
-
#
|
129
|
-
# group
|
132
|
+
# <note markdown="1"> The launch template that is specified must be configured for use with
|
133
|
+
# an Auto Scaling group. For more information, see [Creating a launch
|
134
|
+
# template for an Auto Scaling group][2] in the *Amazon EC2 Auto Scaling
|
135
|
+
# User Guide*.
|
130
136
|
#
|
131
|
-
#
|
132
|
-
# `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
|
133
|
-
# `MixedInstancesPolicy`.
|
137
|
+
# </note>
|
134
138
|
#
|
135
139
|
#
|
136
140
|
#
|
137
|
-
# [1]: https://docs.aws.amazon.com/
|
141
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-launchtemplate.html
|
142
|
+
# [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-launch-template.html
|
138
143
|
# @option options [Types::MixedInstancesPolicy] :mixed_instances_policy
|
139
144
|
# An embedded object that specifies a mixed instances policy. The
|
140
145
|
# required parameters must be specified. If optional parameters are
|
@@ -143,40 +148,33 @@ module Aws::AutoScaling
|
|
143
148
|
# The policy includes parameters that not only define the distribution
|
144
149
|
# of On-Demand Instances and Spot Instances, the maximum price to pay
|
145
150
|
# for Spot Instances, and how the Auto Scaling group allocates instance
|
146
|
-
# types to fulfill On-Demand and Spot
|
147
|
-
# that specify the instance configuration information—the
|
148
|
-
# template and instance types.
|
149
|
-
#
|
150
|
-
# For more information, see [
|
151
|
-
#
|
152
|
-
#
|
153
|
-
# Scaling User Guide*.
|
151
|
+
# types to fulfill On-Demand and Spot capacities, but also the
|
152
|
+
# parameters that specify the instance configuration information—the
|
153
|
+
# launch template and instance types. The policy can also include a
|
154
|
+
# weight for each instance type and different launch templates for
|
155
|
+
# individual instance types. For more information, see [Auto Scaling
|
156
|
+
# groups with multiple instance types and purchase options][1] in the
|
157
|
+
# *Amazon EC2 Auto Scaling User Guide*.
|
154
158
|
#
|
155
|
-
# You must specify
|
156
|
-
# `
|
157
|
-
# `
|
159
|
+
# Conditional: You must specify either a launch template
|
160
|
+
# (`LaunchTemplate` or `MixedInstancesPolicy`) or a launch configuration
|
161
|
+
# (`LaunchConfigurationName` or `InstanceId`).
|
158
162
|
#
|
159
163
|
#
|
160
164
|
#
|
161
|
-
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/
|
162
|
-
# [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
|
165
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
|
163
166
|
# @option options [String] :instance_id
|
164
|
-
# The ID of the instance used to
|
165
|
-
#
|
166
|
-
#
|
167
|
-
#
|
168
|
-
#
|
169
|
-
#
|
170
|
-
# launch configuration derives its attributes from the specified
|
171
|
-
# instance, except for the block device mapping.
|
172
|
-
#
|
173
|
-
# You must specify one of the following parameters in your request:
|
174
|
-
# `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
|
175
|
-
# `MixedInstancesPolicy`.
|
167
|
+
# The ID of the instance used to base the launch configuration on. If
|
168
|
+
# specified, Amazon EC2 Auto Scaling uses the configuration values from
|
169
|
+
# the specified instance to create a new launch configuration. To get
|
170
|
+
# the instance ID, use the Amazon EC2 [DescribeInstances][1] API
|
171
|
+
# operation. For more information, see [Creating an Auto Scaling group
|
172
|
+
# using an EC2 instance][2] in the *Amazon EC2 Auto Scaling User Guide*.
|
176
173
|
#
|
177
174
|
#
|
178
175
|
#
|
179
176
|
# [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html
|
177
|
+
# [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-from-instance.html
|
180
178
|
# @option options [required, Integer] :min_size
|
181
179
|
# The minimum size of the group.
|
182
180
|
# @option options [required, Integer] :max_size
|
@@ -193,62 +191,50 @@ module Aws::AutoScaling
|
|
193
191
|
# @option options [Integer] :desired_capacity
|
194
192
|
# The desired capacity is the initial capacity of the Auto Scaling group
|
195
193
|
# at the time of its creation and the capacity it attempts to maintain.
|
196
|
-
# It can scale beyond this capacity if you configure
|
197
|
-
#
|
198
|
-
#
|
199
|
-
#
|
200
|
-
#
|
201
|
-
# the group.
|
194
|
+
# It can scale beyond this capacity if you configure auto scaling. This
|
195
|
+
# number must be greater than or equal to the minimum size of the group
|
196
|
+
# and less than or equal to the maximum size of the group. If you do not
|
197
|
+
# specify a desired capacity, the default is the minimum size of the
|
198
|
+
# group.
|
202
199
|
# @option options [Integer] :default_cooldown
|
203
200
|
# The amount of time, in seconds, after a scaling activity completes
|
204
201
|
# before another scaling activity can start. The default value is `300`.
|
205
|
-
#
|
206
202
|
# This setting applies when using simple scaling policies, but not when
|
207
203
|
# using other scaling policies or scheduled scaling. For more
|
208
|
-
# information, see [Scaling
|
204
|
+
# information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1] in
|
209
205
|
# the *Amazon EC2 Auto Scaling User Guide*.
|
210
206
|
#
|
211
207
|
#
|
212
208
|
#
|
213
209
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/Cooldown.html
|
214
210
|
# @option options [Array<String>] :availability_zones
|
215
|
-
#
|
216
|
-
# optional if you specify one or more
|
211
|
+
# A list of Availability Zones where instances in the Auto Scaling group
|
212
|
+
# can be created. This parameter is optional if you specify one or more
|
213
|
+
# subnets for `VPCZoneIdentifier`.
|
217
214
|
#
|
218
215
|
# Conditional: If your account supports EC2-Classic and VPC, this
|
219
216
|
# parameter is required to launch instances into EC2-Classic.
|
220
217
|
# @option options [Array<String>] :load_balancer_names
|
221
218
|
# A list of Classic Load Balancers associated with this Auto Scaling
|
222
219
|
# group. For Application Load Balancers and Network Load Balancers,
|
223
|
-
# specify
|
224
|
-
# instead.
|
225
|
-
#
|
226
|
-
# For more information, see [Using a Load Balancer with an Auto Scaling
|
227
|
-
# Group][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
228
|
-
#
|
229
|
-
#
|
230
|
-
#
|
231
|
-
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html
|
220
|
+
# specify `TargetGroupARNs` instead.
|
232
221
|
# @option options [Array<String>] :target_group_arns
|
233
222
|
# The Amazon Resource Names (ARN) of the target groups to associate with
|
234
223
|
# the Auto Scaling group. Instances are registered as targets in a
|
235
|
-
# target group, and traffic is routed to the target group.
|
236
|
-
#
|
237
|
-
#
|
238
|
-
# Group][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
224
|
+
# target group, and traffic is routed to the target group. For more
|
225
|
+
# information, see [Elastic Load Balancing and Amazon EC2 Auto
|
226
|
+
# Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
239
227
|
#
|
240
228
|
#
|
241
229
|
#
|
242
230
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html
|
243
231
|
# @option options [String] :health_check_type
|
244
232
|
# The service to use for the health checks. The valid values are `EC2`
|
245
|
-
# and `ELB`.
|
246
|
-
#
|
247
|
-
#
|
248
|
-
#
|
249
|
-
#
|
250
|
-
# For more information, see [Health Checks for Auto Scaling
|
251
|
-
# Instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
233
|
+
# (default) and `ELB`. If you configure an Auto Scaling group to use
|
234
|
+
# load balancer (ELB) health checks, it considers the instance unhealthy
|
235
|
+
# if it fails either the EC2 status checks or the load balancer health
|
236
|
+
# checks. For more information, see [Health checks for Auto Scaling
|
237
|
+
# instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
252
238
|
#
|
253
239
|
#
|
254
240
|
#
|
@@ -257,74 +243,80 @@ module Aws::AutoScaling
|
|
257
243
|
# The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
|
258
244
|
# before checking the health status of an EC2 instance that has come
|
259
245
|
# into service. During this time, any health check failures for the
|
260
|
-
# instance are ignored. The default value is `0`.
|
261
|
-
#
|
262
|
-
#
|
263
|
-
# *Amazon EC2 Auto Scaling User Guide*.
|
246
|
+
# instance are ignored. The default value is `0`. For more information,
|
247
|
+
# see [Health check grace period][1] in the *Amazon EC2 Auto Scaling
|
248
|
+
# User Guide*.
|
264
249
|
#
|
265
|
-
# Required if you are adding an `ELB` health check.
|
250
|
+
# Conditional: Required if you are adding an `ELB` health check.
|
266
251
|
#
|
267
252
|
#
|
268
253
|
#
|
269
254
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html#health-check-grace-period
|
270
255
|
# @option options [String] :placement_group
|
271
|
-
# The name of
|
272
|
-
# if any. A placement group is a logical grouping of
|
273
|
-
# single Availability Zone. You cannot specify
|
274
|
-
# Zones and a placement group. For more
|
275
|
-
# Groups][1] in the *Amazon EC2 User Guide
|
256
|
+
# The name of an existing placement group into which to launch your
|
257
|
+
# instances, if any. A placement group is a logical grouping of
|
258
|
+
# instances within a single Availability Zone. You cannot specify
|
259
|
+
# multiple Availability Zones and a placement group. For more
|
260
|
+
# information, see [Placement Groups][1] in the *Amazon EC2 User Guide
|
261
|
+
# for Linux Instances*.
|
276
262
|
#
|
277
263
|
#
|
278
264
|
#
|
279
265
|
# [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html
|
280
266
|
# @option options [String] :vpc_zone_identifier
|
281
|
-
# A comma-separated list of subnet IDs for
|
282
|
-
#
|
283
|
-
#
|
284
|
-
#
|
285
|
-
#
|
286
|
-
# Availability Zones.
|
267
|
+
# A comma-separated list of subnet IDs for a virtual private cloud (VPC)
|
268
|
+
# where instances in the Auto Scaling group can be created. If you
|
269
|
+
# specify `VPCZoneIdentifier` with `AvailabilityZones`, the subnets that
|
270
|
+
# you specify for this parameter must reside in those Availability
|
271
|
+
# Zones.
|
287
272
|
#
|
288
273
|
# Conditional: If your account supports EC2-Classic and VPC, this
|
289
274
|
# parameter is required to launch instances into a VPC.
|
290
275
|
# @option options [Array<String>] :termination_policies
|
291
|
-
#
|
292
|
-
# terminate. These policies are executed in the order that
|
293
|
-
#
|
294
|
-
#
|
295
|
-
#
|
296
|
-
# Terminates During Scale In][1] in the *Amazon EC2 Auto Scaling User
|
297
|
-
# Guide*.
|
276
|
+
# A policy or a list of policies that are used to select the instance to
|
277
|
+
# terminate. These policies are executed in the order that you list
|
278
|
+
# them. For more information, see [Controlling which Auto Scaling
|
279
|
+
# instances terminate during scale in][1] in the *Amazon EC2 Auto
|
280
|
+
# Scaling User Guide*.
|
298
281
|
#
|
299
282
|
#
|
300
283
|
#
|
301
284
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html
|
302
285
|
# @option options [Boolean] :new_instances_protected_from_scale_in
|
303
286
|
# Indicates whether newly launched instances are protected from
|
304
|
-
# termination by Amazon EC2 Auto Scaling when scaling in.
|
305
|
-
#
|
306
|
-
#
|
307
|
-
# scale in, see [Instance Protection][1] in the *Amazon EC2 Auto Scaling
|
287
|
+
# termination by Amazon EC2 Auto Scaling when scaling in. For more
|
288
|
+
# information about preventing instances from terminating on scale in,
|
289
|
+
# see [Instance scale-in protection][1] in the *Amazon EC2 Auto Scaling
|
308
290
|
# User Guide*.
|
309
291
|
#
|
310
292
|
#
|
311
293
|
#
|
312
294
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html#instance-protection
|
295
|
+
# @option options [Boolean] :capacity_rebalance
|
296
|
+
# Indicates whether Capacity Rebalancing is enabled. Otherwise, Capacity
|
297
|
+
# Rebalancing is disabled. When you turn on Capacity Rebalancing, Amazon
|
298
|
+
# EC2 Auto Scaling attempts to launch a Spot Instance whenever Amazon
|
299
|
+
# EC2 notifies that a Spot Instance is at an elevated risk of
|
300
|
+
# interruption. After launching a new instance, it then terminates an
|
301
|
+
# old instance. For more information, see [Amazon EC2 Auto Scaling
|
302
|
+
# Capacity Rebalancing][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
303
|
+
#
|
304
|
+
#
|
305
|
+
#
|
306
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/capacity-rebalance.html
|
313
307
|
# @option options [Array<Types::LifecycleHookSpecification>] :lifecycle_hook_specification_list
|
314
|
-
# One or more lifecycle hooks
|
308
|
+
# One or more lifecycle hooks for the group, which specify actions to
|
309
|
+
# perform when Amazon EC2 Auto Scaling launches or terminates instances.
|
315
310
|
# @option options [Array<Types::Tag>] :tags
|
316
311
|
# One or more tags. You can tag your Auto Scaling group and propagate
|
317
|
-
# the tags to the Amazon EC2 instances it launches.
|
318
|
-
#
|
319
|
-
#
|
320
|
-
#
|
321
|
-
# the
|
322
|
-
#
|
323
|
-
#
|
324
|
-
# the Auto Scaling
|
325
|
-
#
|
326
|
-
# For more information, see [Tagging Auto Scaling Groups and
|
327
|
-
# Instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
312
|
+
# the tags to the Amazon EC2 instances it launches. Tags are not
|
313
|
+
# propagated to Amazon EBS volumes. To add tags to Amazon EBS volumes,
|
314
|
+
# specify the tags in a launch template but use caution. If the launch
|
315
|
+
# template specifies an instance tag with a key that is also specified
|
316
|
+
# for the Auto Scaling group, Amazon EC2 Auto Scaling overrides the
|
317
|
+
# value of that instance tag with the value specified by the Auto
|
318
|
+
# Scaling group. For more information, see [Tagging Auto Scaling groups
|
319
|
+
# and instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
328
320
|
#
|
329
321
|
#
|
330
322
|
#
|
@@ -334,7 +326,7 @@ module Aws::AutoScaling
|
|
334
326
|
# Auto Scaling group uses to call other AWS services on your behalf. By
|
335
327
|
# default, Amazon EC2 Auto Scaling uses a service-linked role named
|
336
328
|
# AWSServiceRoleForAutoScaling, which it creates if it does not exist.
|
337
|
-
# For more information, see [Service-
|
329
|
+
# For more information, see [Service-linked roles][1] in the *Amazon EC2
|
338
330
|
# Auto Scaling User Guide*.
|
339
331
|
#
|
340
332
|
#
|
@@ -342,17 +334,10 @@ module Aws::AutoScaling
|
|
342
334
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-service-linked-role.html
|
343
335
|
# @option options [Integer] :max_instance_lifetime
|
344
336
|
# The maximum amount of time, in seconds, that an instance can be in
|
345
|
-
# service. The default is null.
|
346
|
-
#
|
347
|
-
#
|
348
|
-
#
|
349
|
-
# previously set value, specify a new value of 0.
|
350
|
-
#
|
351
|
-
# For more information, see [Replacing Auto Scaling Instances Based on
|
352
|
-
# Maximum Instance Lifetime][1] in the *Amazon EC2 Auto Scaling User
|
353
|
-
# Guide*.
|
354
|
-
#
|
355
|
-
# Valid Range: Minimum value of 0.
|
337
|
+
# service. The default is null. If specified, the value must be either 0
|
338
|
+
# or a number equal to or greater than 86,400 seconds (1 day). For more
|
339
|
+
# information, see [Replacing Auto Scaling instances based on maximum
|
340
|
+
# instance lifetime][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
356
341
|
#
|
357
342
|
#
|
358
343
|
#
|
@@ -449,7 +434,7 @@ module Aws::AutoScaling
|
|
449
434
|
# @option options [String] :classic_link_vpc_id
|
450
435
|
# The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances
|
451
436
|
# to. For more information, see [ClassicLink][1] in the *Amazon EC2 User
|
452
|
-
# Guide for Linux Instances* and [Linking EC2-Classic
|
437
|
+
# Guide for Linux Instances* and [Linking EC2-Classic instances to a
|
453
438
|
# VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
|
454
439
|
#
|
455
440
|
# This parameter can only be used if you are launching EC2-Classic
|
@@ -463,7 +448,7 @@ module Aws::AutoScaling
|
|
463
448
|
# The IDs of one or more security groups for the specified
|
464
449
|
# ClassicLink-enabled VPC. For more information, see [ClassicLink][1] in
|
465
450
|
# the *Amazon EC2 User Guide for Linux Instances* and [Linking
|
466
|
-
# EC2-Classic
|
451
|
+
# EC2-Classic instances to a VPC][2] in the *Amazon EC2 Auto Scaling
|
467
452
|
# User Guide*.
|
468
453
|
#
|
469
454
|
# If you specify the `ClassicLinkVPCId` parameter, you must specify this
|
@@ -475,8 +460,8 @@ module Aws::AutoScaling
|
|
475
460
|
# [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-ClassicLink
|
476
461
|
# @option options [String] :user_data
|
477
462
|
# The Base64-encoded user data to make available to the launched EC2
|
478
|
-
# instances. For more information, see [Instance
|
479
|
-
#
|
463
|
+
# instances. For more information, see [Instance metadata and user
|
464
|
+
# data][1] in the *Amazon EC2 User Guide for Linux Instances*.
|
480
465
|
#
|
481
466
|
#
|
482
467
|
#
|
@@ -490,8 +475,8 @@ module Aws::AutoScaling
|
|
490
475
|
# override any other instance attributes, specify them as part of the
|
491
476
|
# same request.
|
492
477
|
#
|
493
|
-
# For more information, see [
|
494
|
-
#
|
478
|
+
# For more information, see [Creating a launch configuration using an
|
479
|
+
# EC2 instance][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
495
480
|
#
|
496
481
|
# If you do not specify `InstanceId`, you must specify both `ImageId`
|
497
482
|
# and `InstanceType`.
|
@@ -537,13 +522,13 @@ module Aws::AutoScaling
|
|
537
522
|
#
|
538
523
|
#
|
539
524
|
#
|
540
|
-
# [1]: https://docs.aws.amazon.com/autoscaling/latest/userguide/
|
525
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/latest/userguide/enable-as-instance-metrics.html
|
541
526
|
# @option options [String] :spot_price
|
542
527
|
# The maximum hourly price to be paid for any Spot Instance launched to
|
543
528
|
# fulfill the request. Spot Instances are launched when the price you
|
544
529
|
# specify exceeds the current Spot price. For more information, see
|
545
|
-
# [
|
546
|
-
#
|
530
|
+
# [Requesting Spot Instances][1] in the *Amazon EC2 Auto Scaling User
|
531
|
+
# Guide*.
|
547
532
|
#
|
548
533
|
# <note markdown="1"> When you change your maximum price by creating a new launch
|
549
534
|
# configuration, running instances will continue to run as long as the
|
@@ -560,8 +545,8 @@ module Aws::AutoScaling
|
|
560
545
|
# associated with the IAM role for the instance. The instance profile
|
561
546
|
# contains the IAM role.
|
562
547
|
#
|
563
|
-
# For more information, see [IAM
|
564
|
-
# Amazon EC2
|
548
|
+
# For more information, see [IAM role for applications that run on
|
549
|
+
# Amazon EC2 instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
565
550
|
#
|
566
551
|
#
|
567
552
|
#
|
@@ -586,7 +571,7 @@ module Aws::AutoScaling
|
|
586
571
|
# (VPC), specifies whether to assign a public IP address to the group's
|
587
572
|
# instances. If you specify `true`, each instance in the Auto Scaling
|
588
573
|
# group receives a unique public IP address. For more information, see
|
589
|
-
# [Launching Auto Scaling
|
574
|
+
# [Launching Auto Scaling instances in a VPC][1] in the *Amazon EC2 Auto
|
590
575
|
# Scaling User Guide*.
|
591
576
|
#
|
592
577
|
# If you specify this parameter, you must specify at least one subnet
|
@@ -616,22 +601,22 @@ module Aws::AutoScaling
|
|
616
601
|
# If you specify `PlacementTenancy`, you must specify at least one
|
617
602
|
# subnet for `VPCZoneIdentifier` when you create your group.
|
618
603
|
#
|
619
|
-
# For more information, see [
|
620
|
-
# *Amazon EC2 Auto Scaling User Guide*.
|
604
|
+
# For more information, see [Configuring instance tenancy with Amazon
|
605
|
+
# EC2 Auto Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
621
606
|
#
|
622
607
|
# Valid Values: `default` \| `dedicated`
|
623
608
|
#
|
624
609
|
#
|
625
610
|
#
|
626
|
-
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/
|
611
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling/ec2/userguide/auto-scaling-dedicated-instances.html
|
627
612
|
# @option options [Types::InstanceMetadataOptions] :metadata_options
|
628
613
|
# The metadata options for the instances. For more information, see
|
629
|
-
# [Instance Metadata
|
630
|
-
#
|
614
|
+
# [Configuring the Instance Metadata Options][1] in the *Amazon EC2 Auto
|
615
|
+
# Scaling User Guide*.
|
631
616
|
#
|
632
617
|
#
|
633
618
|
#
|
634
|
-
# [1]: https://docs.aws.amazon.com/
|
619
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-launch-config.html#launch-configurations-imds
|
635
620
|
# @return [LaunchConfiguration]
|
636
621
|
def create_launch_configuration(options = {})
|
637
622
|
@client.create_launch_configuration(options)
|
@@ -702,9 +687,9 @@ module Aws::AutoScaling
|
|
702
687
|
# })
|
703
688
|
# @param [Hash] options ({})
|
704
689
|
# @option options [Array<String>] :auto_scaling_group_names
|
705
|
-
# The names of the Auto Scaling groups.
|
706
|
-
#
|
707
|
-
#
|
690
|
+
# The names of the Auto Scaling groups. By default, you can only specify
|
691
|
+
# up to 50 names. You can optionally increase this limit using the
|
692
|
+
# `MaxRecords` parameter.
|
708
693
|
#
|
709
694
|
# If you omit this parameter, all Auto Scaling groups are described.
|
710
695
|
# @return [AutoScalingGroup::Collection]
|