aws-sdk-autoscaling 1.46.0 → 1.51.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,29 @@ 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*.
154
- #
155
- # You must specify one of the following parameters in your request:
156
- # `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
157
- # `MixedInstancesPolicy`.
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*.
158
158
  #
159
159
  #
160
160
  #
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
161
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
163
162
  # @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`.
163
+ # The ID of the instance used to base the launch configuration on. If
164
+ # specified, Amazon EC2 Auto Scaling uses the configuration values from
165
+ # the specified instance to create a new launch configuration. To get
166
+ # the instance ID, use the Amazon EC2 [DescribeInstances][1] API
167
+ # operation. For more information, see [Creating an Auto Scaling group
168
+ # using an EC2 instance][2] in the *Amazon EC2 Auto Scaling User Guide*.
176
169
  #
177
170
  #
178
171
  #
179
172
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html
173
+ # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-from-instance.html
180
174
  # @option options [required, Integer] :min_size
181
175
  # The minimum size of the group.
182
176
  # @option options [required, Integer] :max_size
@@ -193,62 +187,51 @@ module Aws::AutoScaling
193
187
  # @option options [Integer] :desired_capacity
194
188
  # The desired capacity is the initial capacity of the Auto Scaling group
195
189
  # 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.
190
+ # It can scale beyond this capacity if you configure auto scaling. This
191
+ # number must be greater than or equal to the minimum size of the group
192
+ # and less than or equal to the maximum size of the group. If you do not
193
+ # specify a desired capacity, the default is the minimum size of the
194
+ # group.
202
195
  # @option options [Integer] :default_cooldown
203
196
  # The amount of time, in seconds, after a scaling activity completes
204
197
  # before another scaling activity can start. The default value is `300`.
205
- #
206
198
  # This setting applies when using simple scaling policies, but not when
207
199
  # using other scaling policies or scheduled scaling. For more
208
- # information, see [Scaling Cooldowns for Amazon EC2 Auto Scaling][1] in
200
+ # information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1] in
209
201
  # the *Amazon EC2 Auto Scaling User Guide*.
210
202
  #
211
203
  #
212
204
  #
213
205
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/Cooldown.html
214
206
  # @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`.
207
+ # A list of Availability Zones where instances in the Auto Scaling group
208
+ # can be created. This parameter is optional if you specify one or more
209
+ # subnets for `VPCZoneIdentifier`.
217
210
  #
218
211
  # Conditional: If your account supports EC2-Classic and VPC, this
219
212
  # parameter is required to launch instances into EC2-Classic.
220
213
  # @option options [Array<String>] :load_balancer_names
221
214
  # A list of Classic Load Balancers associated with this Auto Scaling
222
- # group. For Application Load Balancers and Network Load Balancers,
223
- # specify a list of target groups using the `TargetGroupARNs` property
215
+ # group. For Application Load Balancers, Network Load Balancers, and
216
+ # Gateway Load Balancers, specify the `TargetGroupARNs` property
224
217
  # 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
232
218
  # @option options [Array<String>] :target_group_arns
233
219
  # The Amazon Resource Names (ARN) of the target groups to associate with
234
220
  # 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*.
221
+ # target group, and traffic is routed to the target group. For more
222
+ # information, see [Elastic Load Balancing and Amazon EC2 Auto
223
+ # Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
239
224
  #
240
225
  #
241
226
  #
242
227
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html
243
228
  # @option options [String] :health_check_type
244
229
  # 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*.
230
+ # (default) and `ELB`. If you configure an Auto Scaling group to use
231
+ # load balancer (ELB) health checks, it considers the instance unhealthy
232
+ # if it fails either the EC2 status checks or the load balancer health
233
+ # checks. For more information, see [Health checks for Auto Scaling
234
+ # instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
252
235
  #
253
236
  #
254
237
  #
@@ -257,74 +240,80 @@ module Aws::AutoScaling
257
240
  # The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
258
241
  # before checking the health status of an EC2 instance that has come
259
242
  # 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*.
243
+ # instance are ignored. The default value is `0`. For more information,
244
+ # see [Health check grace period][1] in the *Amazon EC2 Auto Scaling
245
+ # User Guide*.
264
246
  #
265
- # Required if you are adding an `ELB` health check.
247
+ # Conditional: Required if you are adding an `ELB` health check.
266
248
  #
267
249
  #
268
250
  #
269
251
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html#health-check-grace-period
270
252
  # @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*.
253
+ # The name of an existing placement group into which to launch your
254
+ # instances, if any. A placement group is a logical grouping of
255
+ # instances within a single Availability Zone. You cannot specify
256
+ # multiple Availability Zones and a placement group. For more
257
+ # information, see [Placement Groups][1] in the *Amazon EC2 User Guide
258
+ # for Linux Instances*.
276
259
  #
277
260
  #
278
261
  #
279
262
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html
280
263
  # @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.
264
+ # A comma-separated list of subnet IDs for a virtual private cloud (VPC)
265
+ # where instances in the Auto Scaling group can be created. If you
266
+ # specify `VPCZoneIdentifier` with `AvailabilityZones`, the subnets that
267
+ # you specify for this parameter must reside in those Availability
268
+ # Zones.
287
269
  #
288
270
  # Conditional: If your account supports EC2-Classic and VPC, this
289
271
  # parameter is required to launch instances into a VPC.
290
272
  # @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*.
273
+ # A policy or a list of policies that are used to select the instance to
274
+ # terminate. These policies are executed in the order that you list
275
+ # them. For more information, see [Controlling which Auto Scaling
276
+ # instances terminate during scale in][1] in the *Amazon EC2 Auto
277
+ # Scaling User Guide*.
298
278
  #
299
279
  #
300
280
  #
301
281
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html
302
282
  # @option options [Boolean] :new_instances_protected_from_scale_in
303
283
  # 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
284
+ # termination by Amazon EC2 Auto Scaling when scaling in. For more
285
+ # information about preventing instances from terminating on scale in,
286
+ # see [Instance scale-in protection][1] in the *Amazon EC2 Auto Scaling
308
287
  # User Guide*.
309
288
  #
310
289
  #
311
290
  #
312
291
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html#instance-protection
292
+ # @option options [Boolean] :capacity_rebalance
293
+ # Indicates whether Capacity Rebalancing is enabled. Otherwise, Capacity
294
+ # Rebalancing is disabled. When you turn on Capacity Rebalancing, Amazon
295
+ # EC2 Auto Scaling attempts to launch a Spot Instance whenever Amazon
296
+ # EC2 notifies that a Spot Instance is at an elevated risk of
297
+ # interruption. After launching a new instance, it then terminates an
298
+ # old instance. For more information, see [Amazon EC2 Auto Scaling
299
+ # Capacity Rebalancing][1] in the *Amazon EC2 Auto Scaling User Guide*.
300
+ #
301
+ #
302
+ #
303
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/capacity-rebalance.html
313
304
  # @option options [Array<Types::LifecycleHookSpecification>] :lifecycle_hook_specification_list
314
- # One or more lifecycle hooks.
305
+ # One or more lifecycle hooks for the group, which specify actions to
306
+ # perform when Amazon EC2 Auto Scaling launches or terminates instances.
315
307
  # @option options [Array<Types::Tag>] :tags
316
308
  # 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*.
309
+ # the tags to the Amazon EC2 instances it launches. Tags are not
310
+ # propagated to Amazon EBS volumes. To add tags to Amazon EBS volumes,
311
+ # specify the tags in a launch template but use caution. If the launch
312
+ # template specifies an instance tag with a key that is also specified
313
+ # for the Auto Scaling group, Amazon EC2 Auto Scaling overrides the
314
+ # value of that instance tag with the value specified by the Auto
315
+ # Scaling group. For more information, see [Tagging Auto Scaling groups
316
+ # and instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
328
317
  #
329
318
  #
330
319
  #
@@ -334,7 +323,7 @@ module Aws::AutoScaling
334
323
  # Auto Scaling group uses to call other AWS services on your behalf. By
335
324
  # default, Amazon EC2 Auto Scaling uses a service-linked role named
336
325
  # AWSServiceRoleForAutoScaling, which it creates if it does not exist.
337
- # For more information, see [Service-Linked Roles][1] in the *Amazon EC2
326
+ # For more information, see [Service-linked roles][1] in the *Amazon EC2
338
327
  # Auto Scaling User Guide*.
339
328
  #
340
329
  #
@@ -342,17 +331,10 @@ module Aws::AutoScaling
342
331
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-service-linked-role.html
343
332
  # @option options [Integer] :max_instance_lifetime
344
333
  # 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.
334
+ # service. The default is null. If specified, the value must be either 0
335
+ # or a number equal to or greater than 86,400 seconds (1 day). For more
336
+ # information, see [Replacing Auto Scaling instances based on maximum
337
+ # instance lifetime][1] in the *Amazon EC2 Auto Scaling User Guide*.
356
338
  #
357
339
  #
358
340
  #
@@ -449,7 +431,7 @@ module Aws::AutoScaling
449
431
  # @option options [String] :classic_link_vpc_id
450
432
  # The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances
451
433
  # to. For more information, see [ClassicLink][1] in the *Amazon EC2 User
452
- # Guide for Linux Instances* and [Linking EC2-Classic Instances to a
434
+ # Guide for Linux Instances* and [Linking EC2-Classic instances to a
453
435
  # VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
454
436
  #
455
437
  # This parameter can only be used if you are launching EC2-Classic
@@ -463,7 +445,7 @@ module Aws::AutoScaling
463
445
  # The IDs of one or more security groups for the specified
464
446
  # ClassicLink-enabled VPC. For more information, see [ClassicLink][1] in
465
447
  # the *Amazon EC2 User Guide for Linux Instances* and [Linking
466
- # EC2-Classic Instances to a VPC][2] in the *Amazon EC2 Auto Scaling
448
+ # EC2-Classic instances to a VPC][2] in the *Amazon EC2 Auto Scaling
467
449
  # User Guide*.
468
450
  #
469
451
  # If you specify the `ClassicLinkVPCId` parameter, you must specify this
@@ -475,8 +457,8 @@ module Aws::AutoScaling
475
457
  # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-ClassicLink
476
458
  # @option options [String] :user_data
477
459
  # 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*.
460
+ # instances. For more information, see [Instance metadata and user
461
+ # data][1] in the *Amazon EC2 User Guide for Linux Instances*.
480
462
  #
481
463
  #
482
464
  #
@@ -490,8 +472,8 @@ module Aws::AutoScaling
490
472
  # override any other instance attributes, specify them as part of the
491
473
  # same request.
492
474
  #
493
- # For more information, see [Create a Launch Configuration Using an EC2
494
- # Instance][1] in the *Amazon EC2 Auto Scaling User Guide*.
475
+ # For more information, see [Creating a launch configuration using an
476
+ # EC2 instance][1] in the *Amazon EC2 Auto Scaling User Guide*.
495
477
  #
496
478
  # If you do not specify `InstanceId`, you must specify both `ImageId`
497
479
  # and `InstanceType`.
@@ -537,13 +519,13 @@ module Aws::AutoScaling
537
519
  #
538
520
  #
539
521
  #
540
- # [1]: https://docs.aws.amazon.com/autoscaling/latest/userguide/as-instance-monitoring.html#enable-as-instance-metrics
522
+ # [1]: https://docs.aws.amazon.com/autoscaling/latest/userguide/enable-as-instance-metrics.html
541
523
  # @option options [String] :spot_price
542
524
  # The maximum hourly price to be paid for any Spot Instance launched to
543
525
  # fulfill the request. Spot Instances are launched when the price you
544
526
  # 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*.
527
+ # [Requesting Spot Instances][1] in the *Amazon EC2 Auto Scaling User
528
+ # Guide*.
547
529
  #
548
530
  # <note markdown="1"> When you change your maximum price by creating a new launch
549
531
  # configuration, running instances will continue to run as long as the
@@ -560,8 +542,8 @@ module Aws::AutoScaling
560
542
  # associated with the IAM role for the instance. The instance profile
561
543
  # contains the IAM role.
562
544
  #
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*.
545
+ # For more information, see [IAM role for applications that run on
546
+ # Amazon EC2 instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
565
547
  #
566
548
  #
567
549
  #
@@ -586,7 +568,7 @@ module Aws::AutoScaling
586
568
  # (VPC), specifies whether to assign a public IP address to the group's
587
569
  # instances. If you specify `true`, each instance in the Auto Scaling
588
570
  # 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
571
+ # [Launching Auto Scaling instances in a VPC][1] in the *Amazon EC2 Auto
590
572
  # Scaling User Guide*.
591
573
  #
592
574
  # If you specify this parameter, you must specify at least one subnet
@@ -616,22 +598,22 @@ module Aws::AutoScaling
616
598
  # If you specify `PlacementTenancy`, you must specify at least one
617
599
  # subnet for `VPCZoneIdentifier` when you create your group.
618
600
  #
619
- # For more information, see [Instance Placement Tenancy][1] in the
620
- # *Amazon EC2 Auto Scaling User Guide*.
601
+ # For more information, see [Configuring instance tenancy with Amazon
602
+ # EC2 Auto Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
621
603
  #
622
604
  # Valid Values: `default` \| `dedicated`
623
605
  #
624
606
  #
625
607
  #
626
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-vpc-tenancy
608
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-dedicated-instances.html
627
609
  # @option options [Types::InstanceMetadataOptions] :metadata_options
628
610
  # 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*.
611
+ # [Configuring the Instance Metadata Options][1] in the *Amazon EC2 Auto
612
+ # Scaling User Guide*.
631
613
  #
632
614
  #
633
615
  #
634
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html
616
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-launch-config.html#launch-configurations-imds
635
617
  # @return [LaunchConfiguration]
636
618
  def create_launch_configuration(options = {})
637
619
  @client.create_launch_configuration(options)
@@ -702,9 +684,9 @@ module Aws::AutoScaling
702
684
  # })
703
685
  # @param [Hash] options ({})
704
686
  # @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.
687
+ # The names of the Auto Scaling groups. By default, you can only specify
688
+ # up to 50 names. You can optionally increase this limit using the
689
+ # `MaxRecords` parameter.
708
690
  #
709
691
  # If you omit this parameter, all Auto Scaling groups are described.
710
692
  # @return [AutoScalingGroup::Collection]