aws-sdk-autoscaling 1.45.0 → 1.50.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 +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]
|