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
@@ -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
|
#
|
@@ -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,12 +235,12 @@ 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]
|
@@ -111,31 +111,30 @@ module Aws::AutoScaling
|
|
111
111
|
# The name of the Auto Scaling group. This name must be unique per
|
112
112
|
# Region per account.
|
113
113
|
# @option options [String] :launch_configuration_name
|
114
|
-
# The name of the launch configuration to use
|
115
|
-
#
|
116
|
-
#
|
117
|
-
#
|
118
|
-
#
|
119
|
-
# You must specify one of the following parameters in your request:
|
120
|
-
# `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
|
121
|
-
# `MixedInstancesPolicy`.
|
114
|
+
# The name of the launch configuration to use to launch instances.
|
115
|
+
#
|
116
|
+
# Conditional: You must specify either a launch template
|
117
|
+
# (`LaunchTemplate` or `MixedInstancesPolicy`) or a launch configuration
|
118
|
+
# (`LaunchConfigurationName` or `InstanceId`).
|
122
119
|
# @option options [Types::LaunchTemplateSpecification] :launch_template
|
123
|
-
# Parameters used to specify the launch template and version to use
|
124
|
-
#
|
120
|
+
# Parameters used to specify the [launch template][1] and version to use
|
121
|
+
# to launch instances.
|
125
122
|
#
|
126
|
-
#
|
127
|
-
#
|
123
|
+
# Conditional: You must specify either a launch template
|
124
|
+
# (`LaunchTemplate` or `MixedInstancesPolicy`) or a launch configuration
|
125
|
+
# (`LaunchConfigurationName` or `InstanceId`).
|
128
126
|
#
|
129
|
-
#
|
130
|
-
# group
|
127
|
+
# <note markdown="1"> The launch template that is specified must be configured for use with
|
128
|
+
# an Auto Scaling group. For more information, see [Creating a launch
|
129
|
+
# template for an Auto Scaling group][2] in the *Amazon EC2 Auto Scaling
|
130
|
+
# User Guide*.
|
131
131
|
#
|
132
|
-
#
|
133
|
-
# `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
|
134
|
-
# `MixedInstancesPolicy`.
|
132
|
+
# </note>
|
135
133
|
#
|
136
134
|
#
|
137
135
|
#
|
138
|
-
# [1]: https://docs.aws.amazon.com/
|
136
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-launchtemplate.html
|
137
|
+
# [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-launch-template.html
|
139
138
|
# @option options [Types::MixedInstancesPolicy] :mixed_instances_policy
|
140
139
|
# An embedded object that specifies a mixed instances policy. The
|
141
140
|
# required parameters must be specified. If optional parameters are
|
@@ -144,40 +143,32 @@ module Aws::AutoScaling
|
|
144
143
|
# The policy includes parameters that not only define the distribution
|
145
144
|
# of On-Demand Instances and Spot Instances, the maximum price to pay
|
146
145
|
# for Spot Instances, and how the Auto Scaling group allocates instance
|
147
|
-
# types to fulfill On-Demand and Spot
|
148
|
-
# that specify the instance configuration information—the
|
149
|
-
# template and instance types.
|
150
|
-
#
|
151
|
-
#
|
152
|
-
#
|
153
|
-
# Instance Types and Purchase Options][2] in the *Amazon EC2 Auto
|
154
|
-
# Scaling User Guide*.
|
146
|
+
# types to fulfill On-Demand and Spot capacities, but also the
|
147
|
+
# parameters that specify the instance configuration information—the
|
148
|
+
# launch template and instance types. The policy can also include a
|
149
|
+
# weight for each instance type. For more information, see [Auto Scaling
|
150
|
+
# groups with multiple instance types and purchase options][1] in the
|
151
|
+
# *Amazon EC2 Auto Scaling User Guide*.
|
155
152
|
#
|
156
|
-
# You must specify
|
157
|
-
# `
|
158
|
-
# `
|
153
|
+
# Conditional: You must specify either a launch template
|
154
|
+
# (`LaunchTemplate` or `MixedInstancesPolicy`) or a launch configuration
|
155
|
+
# (`LaunchConfigurationName` or `InstanceId`).
|
159
156
|
#
|
160
157
|
#
|
161
158
|
#
|
162
|
-
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/
|
163
|
-
# [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
|
159
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
|
164
160
|
# @option options [String] :instance_id
|
165
|
-
# The ID of the instance used to
|
166
|
-
#
|
167
|
-
#
|
168
|
-
#
|
169
|
-
#
|
170
|
-
#
|
171
|
-
# launch configuration derives its attributes from the specified
|
172
|
-
# instance, except for the block device mapping.
|
173
|
-
#
|
174
|
-
# You must specify one of the following parameters in your request:
|
175
|
-
# `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
|
176
|
-
# `MixedInstancesPolicy`.
|
161
|
+
# The ID of the instance used to base the launch configuration on. If
|
162
|
+
# specified, Amazon EC2 Auto Scaling uses the configuration values from
|
163
|
+
# the specified instance to create a new launch configuration. To get
|
164
|
+
# the instance ID, use the Amazon EC2 [DescribeInstances][1] API
|
165
|
+
# operation. For more information, see [Creating an Auto Scaling group
|
166
|
+
# using an EC2 instance][2] in the *Amazon EC2 Auto Scaling User Guide*.
|
177
167
|
#
|
178
168
|
#
|
179
169
|
#
|
180
170
|
# [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html
|
171
|
+
# [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-from-instance.html
|
181
172
|
# @option options [required, Integer] :min_size
|
182
173
|
# The minimum size of the group.
|
183
174
|
# @option options [required, Integer] :max_size
|
@@ -194,62 +185,50 @@ module Aws::AutoScaling
|
|
194
185
|
# @option options [Integer] :desired_capacity
|
195
186
|
# The desired capacity is the initial capacity of the Auto Scaling group
|
196
187
|
# at the time of its creation and the capacity it attempts to maintain.
|
197
|
-
# It can scale beyond this capacity if you configure
|
198
|
-
#
|
199
|
-
#
|
200
|
-
#
|
201
|
-
#
|
202
|
-
# the group.
|
188
|
+
# It can scale beyond this capacity if you configure auto scaling. This
|
189
|
+
# number must be greater than or equal to the minimum size of the group
|
190
|
+
# and less than or equal to the maximum size of the group. If you do not
|
191
|
+
# specify a desired capacity, the default is the minimum size of the
|
192
|
+
# group.
|
203
193
|
# @option options [Integer] :default_cooldown
|
204
194
|
# The amount of time, in seconds, after a scaling activity completes
|
205
195
|
# before another scaling activity can start. The default value is `300`.
|
206
|
-
#
|
207
196
|
# This setting applies when using simple scaling policies, but not when
|
208
197
|
# using other scaling policies or scheduled scaling. For more
|
209
|
-
# information, see [Scaling
|
198
|
+
# information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1] in
|
210
199
|
# the *Amazon EC2 Auto Scaling User Guide*.
|
211
200
|
#
|
212
201
|
#
|
213
202
|
#
|
214
203
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/Cooldown.html
|
215
204
|
# @option options [Array<String>] :availability_zones
|
216
|
-
#
|
217
|
-
# optional if you specify one or more
|
205
|
+
# A list of Availability Zones where instances in the Auto Scaling group
|
206
|
+
# can be created. This parameter is optional if you specify one or more
|
207
|
+
# subnets for `VPCZoneIdentifier`.
|
218
208
|
#
|
219
209
|
# Conditional: If your account supports EC2-Classic and VPC, this
|
220
210
|
# parameter is required to launch instances into EC2-Classic.
|
221
211
|
# @option options [Array<String>] :load_balancer_names
|
222
212
|
# A list of Classic Load Balancers associated with this Auto Scaling
|
223
213
|
# group. For Application Load Balancers and Network Load Balancers,
|
224
|
-
# specify
|
225
|
-
# instead.
|
226
|
-
#
|
227
|
-
# For more information, see [Using a Load Balancer with an Auto Scaling
|
228
|
-
# Group][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
229
|
-
#
|
230
|
-
#
|
231
|
-
#
|
232
|
-
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html
|
214
|
+
# specify `TargetGroupARNs` instead.
|
233
215
|
# @option options [Array<String>] :target_group_arns
|
234
216
|
# The Amazon Resource Names (ARN) of the target groups to associate with
|
235
217
|
# the Auto Scaling group. Instances are registered as targets in a
|
236
|
-
# target group, and traffic is routed to the target group.
|
237
|
-
#
|
238
|
-
#
|
239
|
-
# Group][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
218
|
+
# target group, and traffic is routed to the target group. For more
|
219
|
+
# information, see [Elastic Load Balancing and Amazon EC2 Auto
|
220
|
+
# Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
240
221
|
#
|
241
222
|
#
|
242
223
|
#
|
243
224
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html
|
244
225
|
# @option options [String] :health_check_type
|
245
226
|
# The service to use for the health checks. The valid values are `EC2`
|
246
|
-
# and `ELB`.
|
247
|
-
#
|
248
|
-
#
|
249
|
-
#
|
250
|
-
#
|
251
|
-
# For more information, see [Health Checks for Auto Scaling
|
252
|
-
# Instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
227
|
+
# (default) and `ELB`. If you configure an Auto Scaling group to use
|
228
|
+
# load balancer (ELB) health checks, it considers the instance unhealthy
|
229
|
+
# if it fails either the EC2 status checks or the load balancer health
|
230
|
+
# checks. For more information, see [Health checks for Auto Scaling
|
231
|
+
# instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
253
232
|
#
|
254
233
|
#
|
255
234
|
#
|
@@ -258,89 +237,80 @@ module Aws::AutoScaling
|
|
258
237
|
# The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
|
259
238
|
# before checking the health status of an EC2 instance that has come
|
260
239
|
# into service. During this time, any health check failures for the
|
261
|
-
# instance are ignored. The default value is `0`.
|
262
|
-
#
|
263
|
-
#
|
264
|
-
# *Amazon EC2 Auto Scaling User Guide*.
|
240
|
+
# instance are ignored. The default value is `0`. For more information,
|
241
|
+
# see [Health check grace period][1] in the *Amazon EC2 Auto Scaling
|
242
|
+
# User Guide*.
|
265
243
|
#
|
266
|
-
# Required if you are adding an `ELB` health check.
|
244
|
+
# Conditional: Required if you are adding an `ELB` health check.
|
267
245
|
#
|
268
246
|
#
|
269
247
|
#
|
270
248
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html#health-check-grace-period
|
271
249
|
# @option options [String] :placement_group
|
272
|
-
# The name of
|
273
|
-
# if any. A placement group is a logical grouping of
|
274
|
-
# single Availability Zone. You cannot specify
|
275
|
-
# Zones and a placement group. For more
|
276
|
-
# Groups][1] in the *Amazon EC2 User Guide
|
250
|
+
# The name of an existing placement group into which to launch your
|
251
|
+
# instances, if any. A placement group is a logical grouping of
|
252
|
+
# instances within a single Availability Zone. You cannot specify
|
253
|
+
# multiple Availability Zones and a placement group. For more
|
254
|
+
# information, see [Placement Groups][1] in the *Amazon EC2 User Guide
|
255
|
+
# for Linux Instances*.
|
277
256
|
#
|
278
257
|
#
|
279
258
|
#
|
280
259
|
# [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html
|
281
260
|
# @option options [String] :vpc_zone_identifier
|
282
|
-
# A comma-separated list of subnet IDs for
|
283
|
-
#
|
284
|
-
#
|
285
|
-
#
|
286
|
-
#
|
287
|
-
# Availability Zones.
|
261
|
+
# A comma-separated list of subnet IDs for a virtual private cloud (VPC)
|
262
|
+
# where instances in the Auto Scaling group can be created. If you
|
263
|
+
# specify `VPCZoneIdentifier` with `AvailabilityZones`, the subnets that
|
264
|
+
# you specify for this parameter must reside in those Availability
|
265
|
+
# Zones.
|
288
266
|
#
|
289
267
|
# Conditional: If your account supports EC2-Classic and VPC, this
|
290
268
|
# parameter is required to launch instances into a VPC.
|
291
269
|
# @option options [Array<String>] :termination_policies
|
292
|
-
#
|
293
|
-
# terminate. These policies are executed in the order that
|
294
|
-
#
|
295
|
-
#
|
296
|
-
#
|
297
|
-
# Terminates During Scale In][1] in the *Amazon EC2 Auto Scaling User
|
298
|
-
# Guide*.
|
270
|
+
# A policy or a list of policies that are used to select the instance to
|
271
|
+
# terminate. These policies are executed in the order that you list
|
272
|
+
# them. For more information, see [Controlling which Auto Scaling
|
273
|
+
# instances terminate during scale in][1] in the *Amazon EC2 Auto
|
274
|
+
# Scaling User Guide*.
|
299
275
|
#
|
300
276
|
#
|
301
277
|
#
|
302
278
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html
|
303
279
|
# @option options [Boolean] :new_instances_protected_from_scale_in
|
304
280
|
# Indicates whether newly launched instances are protected from
|
305
|
-
# termination by Amazon EC2 Auto Scaling when scaling in.
|
306
|
-
#
|
307
|
-
#
|
308
|
-
# scale in, see [Instance Protection][1] in the *Amazon EC2 Auto Scaling
|
281
|
+
# termination by Amazon EC2 Auto Scaling when scaling in. For more
|
282
|
+
# information about preventing instances from terminating on scale in,
|
283
|
+
# see [Instance scale-in protection][1] in the *Amazon EC2 Auto Scaling
|
309
284
|
# User Guide*.
|
310
285
|
#
|
311
286
|
#
|
312
287
|
#
|
313
288
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html#instance-protection
|
314
289
|
# @option options [Boolean] :capacity_rebalance
|
315
|
-
# Indicates whether
|
316
|
-
#
|
317
|
-
#
|
318
|
-
# You can enable capacity rebalancing for your Auto Scaling groups when
|
319
|
-
# using Spot Instances. When you turn on capacity rebalancing, Amazon
|
290
|
+
# Indicates whether Capacity Rebalancing is enabled. Otherwise, Capacity
|
291
|
+
# Rebalancing is disabled. When you turn on Capacity Rebalancing, Amazon
|
320
292
|
# EC2 Auto Scaling attempts to launch a Spot Instance whenever Amazon
|
321
|
-
# EC2
|
293
|
+
# EC2 notifies that a Spot Instance is at an elevated risk of
|
322
294
|
# interruption. After launching a new instance, it then terminates an
|
323
295
|
# old instance. For more information, see [Amazon EC2 Auto Scaling
|
324
|
-
#
|
296
|
+
# Capacity Rebalancing][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
325
297
|
#
|
326
298
|
#
|
327
299
|
#
|
328
300
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/capacity-rebalance.html
|
329
301
|
# @option options [Array<Types::LifecycleHookSpecification>] :lifecycle_hook_specification_list
|
330
|
-
# One or more lifecycle hooks
|
302
|
+
# One or more lifecycle hooks for the group, which specify actions to
|
303
|
+
# perform when Amazon EC2 Auto Scaling launches or terminates instances.
|
331
304
|
# @option options [Array<Types::Tag>] :tags
|
332
305
|
# One or more tags. You can tag your Auto Scaling group and propagate
|
333
|
-
# the tags to the Amazon EC2 instances it launches.
|
334
|
-
#
|
335
|
-
#
|
336
|
-
#
|
337
|
-
# the
|
338
|
-
#
|
339
|
-
#
|
340
|
-
# the Auto Scaling
|
341
|
-
#
|
342
|
-
# For more information, see [Tagging Auto Scaling Groups and
|
343
|
-
# Instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
306
|
+
# the tags to the Amazon EC2 instances it launches. Tags are not
|
307
|
+
# propagated to Amazon EBS volumes. To add tags to Amazon EBS volumes,
|
308
|
+
# specify the tags in a launch template but use caution. If the launch
|
309
|
+
# template specifies an instance tag with a key that is also specified
|
310
|
+
# for the Auto Scaling group, Amazon EC2 Auto Scaling overrides the
|
311
|
+
# value of that instance tag with the value specified by the Auto
|
312
|
+
# Scaling group. For more information, see [Tagging Auto Scaling groups
|
313
|
+
# and instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
344
314
|
#
|
345
315
|
#
|
346
316
|
#
|
@@ -350,7 +320,7 @@ module Aws::AutoScaling
|
|
350
320
|
# Auto Scaling group uses to call other AWS services on your behalf. By
|
351
321
|
# default, Amazon EC2 Auto Scaling uses a service-linked role named
|
352
322
|
# AWSServiceRoleForAutoScaling, which it creates if it does not exist.
|
353
|
-
# For more information, see [Service-
|
323
|
+
# For more information, see [Service-linked roles][1] in the *Amazon EC2
|
354
324
|
# Auto Scaling User Guide*.
|
355
325
|
#
|
356
326
|
#
|
@@ -358,17 +328,10 @@ module Aws::AutoScaling
|
|
358
328
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-service-linked-role.html
|
359
329
|
# @option options [Integer] :max_instance_lifetime
|
360
330
|
# The maximum amount of time, in seconds, that an instance can be in
|
361
|
-
# service. The default is null.
|
362
|
-
#
|
363
|
-
#
|
364
|
-
#
|
365
|
-
# previously set value, specify a new value of 0.
|
366
|
-
#
|
367
|
-
# For more information, see [Replacing Auto Scaling Instances Based on
|
368
|
-
# Maximum Instance Lifetime][1] in the *Amazon EC2 Auto Scaling User
|
369
|
-
# Guide*.
|
370
|
-
#
|
371
|
-
# Valid Range: Minimum value of 0.
|
331
|
+
# service. The default is null. If specified, the value must be either 0
|
332
|
+
# or a number equal to or greater than 86,400 seconds (1 day). For more
|
333
|
+
# information, see [Replacing Auto Scaling instances based on maximum
|
334
|
+
# instance lifetime][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
372
335
|
#
|
373
336
|
#
|
374
337
|
#
|
@@ -465,7 +428,7 @@ module Aws::AutoScaling
|
|
465
428
|
# @option options [String] :classic_link_vpc_id
|
466
429
|
# The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances
|
467
430
|
# to. For more information, see [ClassicLink][1] in the *Amazon EC2 User
|
468
|
-
# Guide for Linux Instances* and [Linking EC2-Classic
|
431
|
+
# Guide for Linux Instances* and [Linking EC2-Classic instances to a
|
469
432
|
# VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
|
470
433
|
#
|
471
434
|
# This parameter can only be used if you are launching EC2-Classic
|
@@ -479,7 +442,7 @@ module Aws::AutoScaling
|
|
479
442
|
# The IDs of one or more security groups for the specified
|
480
443
|
# ClassicLink-enabled VPC. For more information, see [ClassicLink][1] in
|
481
444
|
# the *Amazon EC2 User Guide for Linux Instances* and [Linking
|
482
|
-
# EC2-Classic
|
445
|
+
# EC2-Classic instances to a VPC][2] in the *Amazon EC2 Auto Scaling
|
483
446
|
# User Guide*.
|
484
447
|
#
|
485
448
|
# If you specify the `ClassicLinkVPCId` parameter, you must specify this
|
@@ -491,8 +454,8 @@ module Aws::AutoScaling
|
|
491
454
|
# [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-ClassicLink
|
492
455
|
# @option options [String] :user_data
|
493
456
|
# The Base64-encoded user data to make available to the launched EC2
|
494
|
-
# instances. For more information, see [Instance
|
495
|
-
#
|
457
|
+
# instances. For more information, see [Instance metadata and user
|
458
|
+
# data][1] in the *Amazon EC2 User Guide for Linux Instances*.
|
496
459
|
#
|
497
460
|
#
|
498
461
|
#
|
@@ -506,8 +469,8 @@ module Aws::AutoScaling
|
|
506
469
|
# override any other instance attributes, specify them as part of the
|
507
470
|
# same request.
|
508
471
|
#
|
509
|
-
# For more information, see [
|
510
|
-
#
|
472
|
+
# For more information, see [Creating a launch configuration using an
|
473
|
+
# EC2 instance][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
511
474
|
#
|
512
475
|
# If you do not specify `InstanceId`, you must specify both `ImageId`
|
513
476
|
# and `InstanceType`.
|
@@ -558,8 +521,8 @@ module Aws::AutoScaling
|
|
558
521
|
# The maximum hourly price to be paid for any Spot Instance launched to
|
559
522
|
# fulfill the request. Spot Instances are launched when the price you
|
560
523
|
# specify exceeds the current Spot price. For more information, see
|
561
|
-
# [
|
562
|
-
#
|
524
|
+
# [Requesting Spot Instances][1] in the *Amazon EC2 Auto Scaling User
|
525
|
+
# Guide*.
|
563
526
|
#
|
564
527
|
# <note markdown="1"> When you change your maximum price by creating a new launch
|
565
528
|
# configuration, running instances will continue to run as long as the
|
@@ -576,8 +539,8 @@ module Aws::AutoScaling
|
|
576
539
|
# associated with the IAM role for the instance. The instance profile
|
577
540
|
# contains the IAM role.
|
578
541
|
#
|
579
|
-
# For more information, see [IAM
|
580
|
-
# Amazon EC2
|
542
|
+
# For more information, see [IAM role for applications that run on
|
543
|
+
# Amazon EC2 instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
581
544
|
#
|
582
545
|
#
|
583
546
|
#
|
@@ -602,7 +565,7 @@ module Aws::AutoScaling
|
|
602
565
|
# (VPC), specifies whether to assign a public IP address to the group's
|
603
566
|
# instances. If you specify `true`, each instance in the Auto Scaling
|
604
567
|
# group receives a unique public IP address. For more information, see
|
605
|
-
# [Launching Auto Scaling
|
568
|
+
# [Launching Auto Scaling instances in a VPC][1] in the *Amazon EC2 Auto
|
606
569
|
# Scaling User Guide*.
|
607
570
|
#
|
608
571
|
# If you specify this parameter, you must specify at least one subnet
|
@@ -632,14 +595,14 @@ module Aws::AutoScaling
|
|
632
595
|
# If you specify `PlacementTenancy`, you must specify at least one
|
633
596
|
# subnet for `VPCZoneIdentifier` when you create your group.
|
634
597
|
#
|
635
|
-
# For more information, see [
|
636
|
-
# *Amazon EC2 Auto Scaling User Guide*.
|
598
|
+
# For more information, see [Configuring instance tenancy with Amazon
|
599
|
+
# EC2 Auto Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
637
600
|
#
|
638
601
|
# Valid Values: `default` \| `dedicated`
|
639
602
|
#
|
640
603
|
#
|
641
604
|
#
|
642
|
-
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/
|
605
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling/ec2/userguide/auto-scaling-dedicated-instances.html
|
643
606
|
# @option options [Types::InstanceMetadataOptions] :metadata_options
|
644
607
|
# The metadata options for the instances. For more information, see
|
645
608
|
# [Configuring the Instance Metadata Options][1] in the *Amazon EC2 Auto
|
@@ -718,9 +681,9 @@ module Aws::AutoScaling
|
|
718
681
|
# })
|
719
682
|
# @param [Hash] options ({})
|
720
683
|
# @option options [Array<String>] :auto_scaling_group_names
|
721
|
-
# The names of the Auto Scaling groups.
|
722
|
-
#
|
723
|
-
#
|
684
|
+
# The names of the Auto Scaling groups. By default, you can only specify
|
685
|
+
# up to 50 names. You can optionally increase this limit using the
|
686
|
+
# `MaxRecords` parameter.
|
724
687
|
#
|
725
688
|
# If you omit this parameter, all Auto Scaling groups are described.
|
726
689
|
# @return [AutoScalingGroup::Collection]
|