aws-sdk-autoscaling 1.45.0 → 1.50.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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 Instances to a
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/as-instance-monitoring.html#enable-as-instance-metrics
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
- # For more information, see [Launching Spot Instances in Your Auto
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
- # For more information, see [IAM Role for Applications That Run on
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
- # For more information, see [Amazon EBS-Optimized Instances][1] in the
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
- # For more information, see [Launching Auto Scaling Instances in a
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 [Instance Placement Tenancy][1] in the
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/asg-in-vpc.html#as-vpc-tenancy
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 and User Data][1] in the *Amazon EC2 User Guide for
265
- # Linux Instances*.
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/AWSEC2/latest/UserGuide/ec2-instance-metadata.html
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 when an instance is
114
- # launched. To get the launch configuration name, use the
115
- # DescribeLaunchConfigurations API operation. New launch configurations
116
- # can be created with the CreateLaunchConfiguration API.
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 when
123
- # an instance is launched.
125
+ # Parameters used to specify the [launch template][1] and version to use
126
+ # to launch instances.
124
127
  #
125
- # For more information, see [LaunchTemplateSpecification][1] in the
126
- # *Amazon EC2 Auto Scaling API Reference*.
128
+ # Conditional: You must specify either a launch template
129
+ # (`LaunchTemplate` or `MixedInstancesPolicy`) or a launch configuration
130
+ # (`LaunchConfigurationName` or `InstanceId`).
127
131
  #
128
- # You can alternatively associate a launch template to the Auto Scaling
129
- # group by using the `MixedInstancesPolicy` parameter.
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
- # You must specify one of the following parameters in your request:
132
- # `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
133
- # `MixedInstancesPolicy`.
137
+ # </note>
134
138
  #
135
139
  #
136
140
  #
137
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_LaunchTemplateSpecification.html
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 capacity, but also the parameters
147
- # that specify the instance configuration information—the launch
148
- # template and instance types.
149
- #
150
- # For more information, see [MixedInstancesPolicy][1] in the *Amazon EC2
151
- # Auto Scaling API Reference* and [Auto Scaling Groups with Multiple
152
- # Instance Types and Purchase Options][2] in the *Amazon EC2 Auto
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 one of the following parameters in your request:
156
- # `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
157
- # `MixedInstancesPolicy`.
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/APIReference/API_MixedInstancesPolicy.html
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 create a launch configuration for the
165
- # group. To get the instance ID, use the Amazon EC2
166
- # [DescribeInstances][1] API operation.
167
- #
168
- # When you specify an ID of an instance, Amazon EC2 Auto Scaling creates
169
- # a new launch configuration and associates it with the group. This
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 automatic scaling.
197
- #
198
- # This number must be greater than or equal to the minimum size of the
199
- # group and less than or equal to the maximum size of the group. If you
200
- # do not specify a desired capacity, the default is the minimum size of
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 Cooldowns for Amazon EC2 Auto Scaling][1] in
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
- # One or more Availability Zones for the group. This parameter is
216
- # optional if you specify one or more subnets for `VPCZoneIdentifier`.
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 a list of target groups using the `TargetGroupARNs` property
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
- # For more information, see [Using a Load Balancer with an Auto Scaling
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`. The default value is `EC2`. If you configure an Auto
246
- # Scaling group to use ELB health checks, it considers the instance
247
- # unhealthy if it fails either the EC2 status checks or the load
248
- # balancer health checks.
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
- # For more information, see [Health Check Grace Period][1] in the
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 the placement group into which to launch your instances,
272
- # if any. A placement group is a logical grouping of instances within a
273
- # single Availability Zone. You cannot specify multiple Availability
274
- # Zones and a placement group. For more information, see [Placement
275
- # Groups][1] in the *Amazon EC2 User Guide for Linux Instances*.
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 your virtual private cloud
282
- # (VPC).
283
- #
284
- # If you specify `VPCZoneIdentifier` with `AvailabilityZones`, the
285
- # subnets that you specify for this parameter must reside in those
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
- # One or more termination policies used to select the instance to
292
- # terminate. These policies are executed in the order that they are
293
- # listed.
294
- #
295
- # For more information, see [Controlling Which Instances Auto Scaling
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
- # For more information about preventing instances from terminating on
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
- # Tags are not propagated to Amazon EBS volumes. To add tags to Amazon
320
- # EBS volumes, specify the tags in a launch template but use caution. If
321
- # the launch template specifies an instance tag with a key that is also
322
- # specified for the Auto Scaling group, Amazon EC2 Auto Scaling
323
- # overrides the value of that instance tag with the value specified by
324
- # the Auto Scaling group.
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-Linked Roles][1] in the *Amazon EC2
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
- # This parameter is optional, but if you specify a value for it, you
348
- # must specify a value of at least 604,800 seconds (7 days). To clear a
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 Instances to a
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 Instances to a VPC][2] in the *Amazon EC2 Auto Scaling
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 Metadata and User
479
- # Data][1] in the *Amazon EC2 User Guide for Linux Instances*.
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 [Create a Launch Configuration Using an EC2
494
- # Instance][1] in the *Amazon EC2 Auto Scaling User Guide*.
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/as-instance-monitoring.html#enable-as-instance-metrics
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
- # [Launching Spot Instances in Your Auto Scaling Group][1] in the
546
- # *Amazon EC2 Auto Scaling User Guide*.
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 Role for Applications That Run on
564
- # Amazon EC2 Instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
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 Instances in a VPC][1] in the *Amazon EC2 Auto
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 [Instance Placement Tenancy][1] in the
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/asg-in-vpc.html#as-vpc-tenancy
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 and User Data][1] in the *Amazon EC2 User Guide for
630
- # Linux Instances*.
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/AWSEC2/latest/UserGuide/ec2-instance-metadata.html
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. Each name can be a maximum of
706
- # 1600 characters. By default, you can only specify up to 50 names. You
707
- # can optionally increase this limit using the `MaxRecords` parameter.
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]