aws-sdk-autoscaling 1.44.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 +3 -2
- data/lib/aws-sdk-autoscaling/auto_scaling_group.rb +55 -65
- data/lib/aws-sdk-autoscaling/client.rb +253 -266
- data/lib/aws-sdk-autoscaling/client_api.rb +4 -0
- data/lib/aws-sdk-autoscaling/launch_configuration.rb +30 -44
- data/lib/aws-sdk-autoscaling/resource.rb +124 -145
- data/lib/aws-sdk-autoscaling/scaling_policy.rb +3 -3
- data/lib/aws-sdk-autoscaling/types.rb +315 -389
- 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"))
|
@@ -1105,6 +1108,7 @@ module Aws::AutoScaling
|
|
1105
1108
|
UpdateAutoScalingGroupType.add_member(:new_instances_protected_from_scale_in, Shapes::ShapeRef.new(shape: InstanceProtected, location_name: "NewInstancesProtectedFromScaleIn"))
|
1106
1109
|
UpdateAutoScalingGroupType.add_member(:service_linked_role_arn, Shapes::ShapeRef.new(shape: ResourceName, location_name: "ServiceLinkedRoleARN"))
|
1107
1110
|
UpdateAutoScalingGroupType.add_member(:max_instance_lifetime, Shapes::ShapeRef.new(shape: MaxInstanceLifetime, location_name: "MaxInstanceLifetime"))
|
1111
|
+
UpdateAutoScalingGroupType.add_member(:capacity_rebalance, Shapes::ShapeRef.new(shape: CapacityRebalanceEnabled, location_name: "CapacityRebalance"))
|
1108
1112
|
UpdateAutoScalingGroupType.struct_class = Types::UpdateAutoScalingGroupType
|
1109
1113
|
|
1110
1114
|
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]
|
@@ -82,6 +82,7 @@ module Aws::AutoScaling
|
|
82
82
|
# vpc_zone_identifier: "XmlStringMaxLen2047",
|
83
83
|
# termination_policies: ["XmlStringMaxLen1600"],
|
84
84
|
# new_instances_protected_from_scale_in: false,
|
85
|
+
# capacity_rebalance: false,
|
85
86
|
# lifecycle_hook_specification_list: [
|
86
87
|
# {
|
87
88
|
# lifecycle_hook_name: "AsciiStringMaxLen255", # required
|
@@ -110,31 +111,30 @@ module Aws::AutoScaling
|
|
110
111
|
# The name of the Auto Scaling group. This name must be unique per
|
111
112
|
# Region per account.
|
112
113
|
# @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`.
|
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`).
|
121
119
|
# @option options [Types::LaunchTemplateSpecification] :launch_template
|
122
|
-
# Parameters used to specify the launch template and version to use
|
123
|
-
#
|
120
|
+
# Parameters used to specify the [launch template][1] and version to use
|
121
|
+
# to launch instances.
|
124
122
|
#
|
125
|
-
#
|
126
|
-
#
|
123
|
+
# Conditional: You must specify either a launch template
|
124
|
+
# (`LaunchTemplate` or `MixedInstancesPolicy`) or a launch configuration
|
125
|
+
# (`LaunchConfigurationName` or `InstanceId`).
|
127
126
|
#
|
128
|
-
#
|
129
|
-
# 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*.
|
130
131
|
#
|
131
|
-
#
|
132
|
-
# `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
|
133
|
-
# `MixedInstancesPolicy`.
|
132
|
+
# </note>
|
134
133
|
#
|
135
134
|
#
|
136
135
|
#
|
137
|
-
# [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
|
138
138
|
# @option options [Types::MixedInstancesPolicy] :mixed_instances_policy
|
139
139
|
# An embedded object that specifies a mixed instances policy. The
|
140
140
|
# required parameters must be specified. If optional parameters are
|
@@ -143,40 +143,32 @@ module Aws::AutoScaling
|
|
143
143
|
# The policy includes parameters that not only define the distribution
|
144
144
|
# of On-Demand Instances and Spot Instances, the maximum price to pay
|
145
145
|
# 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
|
-
#
|
151
|
-
#
|
152
|
-
# Instance Types and Purchase Options][2] in the *Amazon EC2 Auto
|
153
|
-
# 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*.
|
154
152
|
#
|
155
|
-
# You must specify
|
156
|
-
# `
|
157
|
-
# `
|
153
|
+
# Conditional: You must specify either a launch template
|
154
|
+
# (`LaunchTemplate` or `MixedInstancesPolicy`) or a launch configuration
|
155
|
+
# (`LaunchConfigurationName` or `InstanceId`).
|
158
156
|
#
|
159
157
|
#
|
160
158
|
#
|
161
|
-
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/
|
162
|
-
# [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
|
163
160
|
# @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`.
|
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*.
|
176
167
|
#
|
177
168
|
#
|
178
169
|
#
|
179
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
|
180
172
|
# @option options [required, Integer] :min_size
|
181
173
|
# The minimum size of the group.
|
182
174
|
# @option options [required, Integer] :max_size
|
@@ -193,62 +185,50 @@ module Aws::AutoScaling
|
|
193
185
|
# @option options [Integer] :desired_capacity
|
194
186
|
# The desired capacity is the initial capacity of the Auto Scaling group
|
195
187
|
# 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.
|
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.
|
202
193
|
# @option options [Integer] :default_cooldown
|
203
194
|
# The amount of time, in seconds, after a scaling activity completes
|
204
195
|
# before another scaling activity can start. The default value is `300`.
|
205
|
-
#
|
206
196
|
# This setting applies when using simple scaling policies, but not when
|
207
197
|
# using other scaling policies or scheduled scaling. For more
|
208
|
-
# information, see [Scaling
|
198
|
+
# information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1] in
|
209
199
|
# the *Amazon EC2 Auto Scaling User Guide*.
|
210
200
|
#
|
211
201
|
#
|
212
202
|
#
|
213
203
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/Cooldown.html
|
214
204
|
# @option options [Array<String>] :availability_zones
|
215
|
-
#
|
216
|
-
# 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`.
|
217
208
|
#
|
218
209
|
# Conditional: If your account supports EC2-Classic and VPC, this
|
219
210
|
# parameter is required to launch instances into EC2-Classic.
|
220
211
|
# @option options [Array<String>] :load_balancer_names
|
221
212
|
# A list of Classic Load Balancers associated with this Auto Scaling
|
222
213
|
# 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
|
214
|
+
# specify `TargetGroupARNs` instead.
|
232
215
|
# @option options [Array<String>] :target_group_arns
|
233
216
|
# The Amazon Resource Names (ARN) of the target groups to associate with
|
234
217
|
# 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*.
|
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*.
|
239
221
|
#
|
240
222
|
#
|
241
223
|
#
|
242
224
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html
|
243
225
|
# @option options [String] :health_check_type
|
244
226
|
# 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*.
|
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*.
|
252
232
|
#
|
253
233
|
#
|
254
234
|
#
|
@@ -257,74 +237,80 @@ module Aws::AutoScaling
|
|
257
237
|
# The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
|
258
238
|
# before checking the health status of an EC2 instance that has come
|
259
239
|
# 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*.
|
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*.
|
264
243
|
#
|
265
|
-
# Required if you are adding an `ELB` health check.
|
244
|
+
# Conditional: Required if you are adding an `ELB` health check.
|
266
245
|
#
|
267
246
|
#
|
268
247
|
#
|
269
248
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html#health-check-grace-period
|
270
249
|
# @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
|
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*.
|
276
256
|
#
|
277
257
|
#
|
278
258
|
#
|
279
259
|
# [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html
|
280
260
|
# @option options [String] :vpc_zone_identifier
|
281
|
-
# A comma-separated list of subnet IDs for
|
282
|
-
#
|
283
|
-
#
|
284
|
-
#
|
285
|
-
#
|
286
|
-
# 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.
|
287
266
|
#
|
288
267
|
# Conditional: If your account supports EC2-Classic and VPC, this
|
289
268
|
# parameter is required to launch instances into a VPC.
|
290
269
|
# @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*.
|
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*.
|
298
275
|
#
|
299
276
|
#
|
300
277
|
#
|
301
278
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html
|
302
279
|
# @option options [Boolean] :new_instances_protected_from_scale_in
|
303
280
|
# 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
|
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
|
308
284
|
# User Guide*.
|
309
285
|
#
|
310
286
|
#
|
311
287
|
#
|
312
288
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html#instance-protection
|
289
|
+
# @option options [Boolean] :capacity_rebalance
|
290
|
+
# Indicates whether Capacity Rebalancing is enabled. Otherwise, Capacity
|
291
|
+
# Rebalancing is disabled. When you turn on Capacity Rebalancing, Amazon
|
292
|
+
# EC2 Auto Scaling attempts to launch a Spot Instance whenever Amazon
|
293
|
+
# EC2 notifies that a Spot Instance is at an elevated risk of
|
294
|
+
# interruption. After launching a new instance, it then terminates an
|
295
|
+
# old instance. For more information, see [Amazon EC2 Auto Scaling
|
296
|
+
# Capacity Rebalancing][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
297
|
+
#
|
298
|
+
#
|
299
|
+
#
|
300
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/capacity-rebalance.html
|
313
301
|
# @option options [Array<Types::LifecycleHookSpecification>] :lifecycle_hook_specification_list
|
314
|
-
# 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.
|
315
304
|
# @option options [Array<Types::Tag>] :tags
|
316
305
|
# 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*.
|
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*.
|
328
314
|
#
|
329
315
|
#
|
330
316
|
#
|
@@ -334,7 +320,7 @@ module Aws::AutoScaling
|
|
334
320
|
# Auto Scaling group uses to call other AWS services on your behalf. By
|
335
321
|
# default, Amazon EC2 Auto Scaling uses a service-linked role named
|
336
322
|
# AWSServiceRoleForAutoScaling, which it creates if it does not exist.
|
337
|
-
# For more information, see [Service-
|
323
|
+
# For more information, see [Service-linked roles][1] in the *Amazon EC2
|
338
324
|
# Auto Scaling User Guide*.
|
339
325
|
#
|
340
326
|
#
|
@@ -342,17 +328,10 @@ module Aws::AutoScaling
|
|
342
328
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-service-linked-role.html
|
343
329
|
# @option options [Integer] :max_instance_lifetime
|
344
330
|
# 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.
|
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*.
|
356
335
|
#
|
357
336
|
#
|
358
337
|
#
|
@@ -449,7 +428,7 @@ module Aws::AutoScaling
|
|
449
428
|
# @option options [String] :classic_link_vpc_id
|
450
429
|
# The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances
|
451
430
|
# to. For more information, see [ClassicLink][1] in the *Amazon EC2 User
|
452
|
-
# Guide for Linux Instances* and [Linking EC2-Classic
|
431
|
+
# Guide for Linux Instances* and [Linking EC2-Classic instances to a
|
453
432
|
# VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
|
454
433
|
#
|
455
434
|
# This parameter can only be used if you are launching EC2-Classic
|
@@ -463,7 +442,7 @@ module Aws::AutoScaling
|
|
463
442
|
# The IDs of one or more security groups for the specified
|
464
443
|
# ClassicLink-enabled VPC. For more information, see [ClassicLink][1] in
|
465
444
|
# the *Amazon EC2 User Guide for Linux Instances* and [Linking
|
466
|
-
# EC2-Classic
|
445
|
+
# EC2-Classic instances to a VPC][2] in the *Amazon EC2 Auto Scaling
|
467
446
|
# User Guide*.
|
468
447
|
#
|
469
448
|
# If you specify the `ClassicLinkVPCId` parameter, you must specify this
|
@@ -475,8 +454,8 @@ module Aws::AutoScaling
|
|
475
454
|
# [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-ClassicLink
|
476
455
|
# @option options [String] :user_data
|
477
456
|
# The Base64-encoded user data to make available to the launched EC2
|
478
|
-
# instances. For more information, see [Instance
|
479
|
-
#
|
457
|
+
# instances. For more information, see [Instance metadata and user
|
458
|
+
# data][1] in the *Amazon EC2 User Guide for Linux Instances*.
|
480
459
|
#
|
481
460
|
#
|
482
461
|
#
|
@@ -490,8 +469,8 @@ module Aws::AutoScaling
|
|
490
469
|
# override any other instance attributes, specify them as part of the
|
491
470
|
# same request.
|
492
471
|
#
|
493
|
-
# For more information, see [
|
494
|
-
#
|
472
|
+
# For more information, see [Creating a launch configuration using an
|
473
|
+
# EC2 instance][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
495
474
|
#
|
496
475
|
# If you do not specify `InstanceId`, you must specify both `ImageId`
|
497
476
|
# and `InstanceType`.
|
@@ -537,13 +516,13 @@ module Aws::AutoScaling
|
|
537
516
|
#
|
538
517
|
#
|
539
518
|
#
|
540
|
-
# [1]: https://docs.aws.amazon.com/autoscaling/latest/userguide/
|
519
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/latest/userguide/enable-as-instance-metrics.html
|
541
520
|
# @option options [String] :spot_price
|
542
521
|
# The maximum hourly price to be paid for any Spot Instance launched to
|
543
522
|
# fulfill the request. Spot Instances are launched when the price you
|
544
523
|
# specify exceeds the current Spot price. For more information, see
|
545
|
-
# [
|
546
|
-
#
|
524
|
+
# [Requesting Spot Instances][1] in the *Amazon EC2 Auto Scaling User
|
525
|
+
# Guide*.
|
547
526
|
#
|
548
527
|
# <note markdown="1"> When you change your maximum price by creating a new launch
|
549
528
|
# configuration, running instances will continue to run as long as the
|
@@ -560,8 +539,8 @@ module Aws::AutoScaling
|
|
560
539
|
# associated with the IAM role for the instance. The instance profile
|
561
540
|
# contains the IAM role.
|
562
541
|
#
|
563
|
-
# For more information, see [IAM
|
564
|
-
# 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*.
|
565
544
|
#
|
566
545
|
#
|
567
546
|
#
|
@@ -586,7 +565,7 @@ module Aws::AutoScaling
|
|
586
565
|
# (VPC), specifies whether to assign a public IP address to the group's
|
587
566
|
# instances. If you specify `true`, each instance in the Auto Scaling
|
588
567
|
# group receives a unique public IP address. For more information, see
|
589
|
-
# [Launching Auto Scaling
|
568
|
+
# [Launching Auto Scaling instances in a VPC][1] in the *Amazon EC2 Auto
|
590
569
|
# Scaling User Guide*.
|
591
570
|
#
|
592
571
|
# If you specify this parameter, you must specify at least one subnet
|
@@ -616,22 +595,22 @@ module Aws::AutoScaling
|
|
616
595
|
# If you specify `PlacementTenancy`, you must specify at least one
|
617
596
|
# subnet for `VPCZoneIdentifier` when you create your group.
|
618
597
|
#
|
619
|
-
# For more information, see [
|
620
|
-
# *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*.
|
621
600
|
#
|
622
601
|
# Valid Values: `default` \| `dedicated`
|
623
602
|
#
|
624
603
|
#
|
625
604
|
#
|
626
|
-
# [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
|
627
606
|
# @option options [Types::InstanceMetadataOptions] :metadata_options
|
628
607
|
# The metadata options for the instances. For more information, see
|
629
|
-
# [Instance Metadata
|
630
|
-
#
|
608
|
+
# [Configuring the Instance Metadata Options][1] in the *Amazon EC2 Auto
|
609
|
+
# Scaling User Guide*.
|
631
610
|
#
|
632
611
|
#
|
633
612
|
#
|
634
|
-
# [1]: https://docs.aws.amazon.com/
|
613
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-launch-config.html#launch-configurations-imds
|
635
614
|
# @return [LaunchConfiguration]
|
636
615
|
def create_launch_configuration(options = {})
|
637
616
|
@client.create_launch_configuration(options)
|
@@ -702,9 +681,9 @@ module Aws::AutoScaling
|
|
702
681
|
# })
|
703
682
|
# @param [Hash] options ({})
|
704
683
|
# @option options [Array<String>] :auto_scaling_group_names
|
705
|
-
# The names of the Auto Scaling groups.
|
706
|
-
#
|
707
|
-
#
|
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.
|
708
687
|
#
|
709
688
|
# If you omit this parameter, all Auto Scaling groups are described.
|
710
689
|
# @return [AutoScalingGroup::Collection]
|