aws-sdk-autoscaling 1.44.0 → 1.49.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -57,6 +57,7 @@ module Aws::AutoScaling
57
57
  BlockDeviceMappings = Shapes::ListShape.new(name: 'BlockDeviceMappings')
58
58
  CancelInstanceRefreshAnswer = Shapes::StructureShape.new(name: 'CancelInstanceRefreshAnswer')
59
59
  CancelInstanceRefreshType = Shapes::StructureShape.new(name: 'CancelInstanceRefreshType')
60
+ CapacityRebalanceEnabled = Shapes::BooleanShape.new(name: 'CapacityRebalanceEnabled')
60
61
  ClassicLinkVPCSecurityGroups = Shapes::ListShape.new(name: 'ClassicLinkVPCSecurityGroups')
61
62
  CompleteLifecycleActionAnswer = Shapes::StructureShape.new(name: 'CompleteLifecycleActionAnswer')
62
63
  CompleteLifecycleActionType = Shapes::StructureShape.new(name: 'CompleteLifecycleActionType')
@@ -358,6 +359,7 @@ module Aws::AutoScaling
358
359
  AutoScalingGroup.add_member(:new_instances_protected_from_scale_in, Shapes::ShapeRef.new(shape: InstanceProtected, location_name: "NewInstancesProtectedFromScaleIn"))
359
360
  AutoScalingGroup.add_member(:service_linked_role_arn, Shapes::ShapeRef.new(shape: ResourceName, location_name: "ServiceLinkedRoleARN"))
360
361
  AutoScalingGroup.add_member(:max_instance_lifetime, Shapes::ShapeRef.new(shape: MaxInstanceLifetime, location_name: "MaxInstanceLifetime"))
362
+ AutoScalingGroup.add_member(:capacity_rebalance, Shapes::ShapeRef.new(shape: CapacityRebalanceEnabled, location_name: "CapacityRebalance"))
361
363
  AutoScalingGroup.struct_class = Types::AutoScalingGroup
362
364
 
363
365
  AutoScalingGroupNames.member = Shapes::ShapeRef.new(shape: ResourceName)
@@ -452,6 +454,7 @@ module Aws::AutoScaling
452
454
  CreateAutoScalingGroupType.add_member(:vpc_zone_identifier, Shapes::ShapeRef.new(shape: XmlStringMaxLen2047, location_name: "VPCZoneIdentifier"))
453
455
  CreateAutoScalingGroupType.add_member(:termination_policies, Shapes::ShapeRef.new(shape: TerminationPolicies, location_name: "TerminationPolicies"))
454
456
  CreateAutoScalingGroupType.add_member(:new_instances_protected_from_scale_in, Shapes::ShapeRef.new(shape: InstanceProtected, location_name: "NewInstancesProtectedFromScaleIn"))
457
+ CreateAutoScalingGroupType.add_member(:capacity_rebalance, Shapes::ShapeRef.new(shape: CapacityRebalanceEnabled, location_name: "CapacityRebalance"))
455
458
  CreateAutoScalingGroupType.add_member(:lifecycle_hook_specification_list, Shapes::ShapeRef.new(shape: LifecycleHookSpecifications, location_name: "LifecycleHookSpecificationList"))
456
459
  CreateAutoScalingGroupType.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "Tags"))
457
460
  CreateAutoScalingGroupType.add_member(:service_linked_role_arn, Shapes::ShapeRef.new(shape: ResourceName, location_name: "ServiceLinkedRoleARN"))
@@ -1105,6 +1108,7 @@ module Aws::AutoScaling
1105
1108
  UpdateAutoScalingGroupType.add_member(:new_instances_protected_from_scale_in, Shapes::ShapeRef.new(shape: InstanceProtected, location_name: "NewInstancesProtectedFromScaleIn"))
1106
1109
  UpdateAutoScalingGroupType.add_member(:service_linked_role_arn, Shapes::ShapeRef.new(shape: ResourceName, location_name: "ServiceLinkedRoleARN"))
1107
1110
  UpdateAutoScalingGroupType.add_member(:max_instance_lifetime, Shapes::ShapeRef.new(shape: MaxInstanceLifetime, location_name: "MaxInstanceLifetime"))
1111
+ UpdateAutoScalingGroupType.add_member(:capacity_rebalance, Shapes::ShapeRef.new(shape: CapacityRebalanceEnabled, location_name: "CapacityRebalance"))
1108
1112
  UpdateAutoScalingGroupType.struct_class = Types::UpdateAutoScalingGroupType
1109
1113
 
1110
1114
  Values.member = Shapes::ShapeRef.new(shape: XmlString)
@@ -42,10 +42,8 @@ module Aws::AutoScaling
42
42
  end
43
43
 
44
44
  # The ID of the Amazon Machine Image (AMI) to use to launch your EC2
45
- # instances.
46
- #
47
- # For more information, see [Finding an AMI][1] in the *Amazon EC2 User
48
- # Guide for Linux Instances*.
45
+ # instances. For more information, see [Finding an AMI][1] in the
46
+ # *Amazon EC2 User Guide for Linux Instances*.
49
47
  #
50
48
  #
51
49
  #
@@ -69,10 +67,8 @@ module Aws::AutoScaling
69
67
  end
70
68
 
71
69
  # A list that contains the security groups to assign to the instances in
72
- # the Auto Scaling group.
73
- #
74
- # For more information, see [Security Groups for Your VPC][1] in the
75
- # *Amazon Virtual Private Cloud User Guide*.
70
+ # the Auto Scaling group. For more information, see [Security Groups for
71
+ # Your VPC][1] in the *Amazon Virtual Private Cloud User Guide*.
76
72
  #
77
73
  #
78
74
  #
@@ -83,10 +79,8 @@ module Aws::AutoScaling
83
79
  end
84
80
 
85
81
  # The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances
86
- # to.
87
- #
88
- # For more information, see [ClassicLink][1] in the *Amazon EC2 User
89
- # Guide for Linux Instances* and [Linking EC2-Classic Instances to a
82
+ # to. For more information, see [ClassicLink][1] in the *Amazon EC2 User
83
+ # Guide for Linux Instances* and [Linking EC2-Classic instances to a
90
84
  # VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
91
85
  #
92
86
  #
@@ -102,7 +96,7 @@ module Aws::AutoScaling
102
96
  # `ClassicLinkVPCId`.
103
97
  #
104
98
  # For more information, see [ClassicLink][1] in the *Amazon EC2 User
105
- # Guide for Linux Instances* and [Linking EC2-Classic 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]
@@ -82,6 +82,7 @@ module Aws::AutoScaling
82
82
  # vpc_zone_identifier: "XmlStringMaxLen2047",
83
83
  # termination_policies: ["XmlStringMaxLen1600"],
84
84
  # new_instances_protected_from_scale_in: false,
85
+ # capacity_rebalance: false,
85
86
  # lifecycle_hook_specification_list: [
86
87
  # {
87
88
  # lifecycle_hook_name: "AsciiStringMaxLen255", # required
@@ -110,31 +111,30 @@ module Aws::AutoScaling
110
111
  # The name of the Auto Scaling group. This name must be unique per
111
112
  # Region per account.
112
113
  # @option options [String] :launch_configuration_name
113
- # The name of the launch configuration to use 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`.
114
+ # The name of the launch configuration to use to launch instances.
115
+ #
116
+ # Conditional: You must specify either a launch template
117
+ # (`LaunchTemplate` or `MixedInstancesPolicy`) or a launch configuration
118
+ # (`LaunchConfigurationName` or `InstanceId`).
121
119
  # @option options [Types::LaunchTemplateSpecification] :launch_template
122
- # Parameters used to specify the launch template and version to use when
123
- # an instance is launched.
120
+ # Parameters used to specify the [launch template][1] and version to use
121
+ # to launch instances.
124
122
  #
125
- # For more information, see [LaunchTemplateSpecification][1] in the
126
- # *Amazon EC2 Auto Scaling API Reference*.
123
+ # Conditional: You must specify either a launch template
124
+ # (`LaunchTemplate` or `MixedInstancesPolicy`) or a launch configuration
125
+ # (`LaunchConfigurationName` or `InstanceId`).
127
126
  #
128
- # You can alternatively associate a launch template to the Auto Scaling
129
- # group by using the `MixedInstancesPolicy` parameter.
127
+ # <note markdown="1"> The launch template that is specified must be configured for use with
128
+ # an Auto Scaling group. For more information, see [Creating a launch
129
+ # template for an Auto Scaling group][2] in the *Amazon EC2 Auto Scaling
130
+ # User Guide*.
130
131
  #
131
- # You must specify one of the following parameters in your request:
132
- # `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
133
- # `MixedInstancesPolicy`.
132
+ # </note>
134
133
  #
135
134
  #
136
135
  #
137
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_LaunchTemplateSpecification.html
136
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-launchtemplate.html
137
+ # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-launch-template.html
138
138
  # @option options [Types::MixedInstancesPolicy] :mixed_instances_policy
139
139
  # An embedded object that specifies a mixed instances policy. The
140
140
  # required parameters must be specified. If optional parameters are
@@ -143,40 +143,32 @@ module Aws::AutoScaling
143
143
  # The policy includes parameters that not only define the distribution
144
144
  # of On-Demand Instances and Spot Instances, the maximum price to pay
145
145
  # for Spot Instances, and how the Auto Scaling group allocates instance
146
- # types to fulfill On-Demand and Spot 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*.
146
+ # types to fulfill On-Demand and Spot capacities, but also the
147
+ # parameters that specify the instance configuration information—the
148
+ # launch template and instance types. The policy can also include a
149
+ # weight for each instance type. For more information, see [Auto Scaling
150
+ # groups with multiple instance types and purchase options][1] in the
151
+ # *Amazon EC2 Auto Scaling User Guide*.
154
152
  #
155
- # You must specify one of the following parameters in your request:
156
- # `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
157
- # `MixedInstancesPolicy`.
153
+ # Conditional: You must specify either a launch template
154
+ # (`LaunchTemplate` or `MixedInstancesPolicy`) or a launch configuration
155
+ # (`LaunchConfigurationName` or `InstanceId`).
158
156
  #
159
157
  #
160
158
  #
161
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_MixedInstancesPolicy.html
162
- # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
159
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
163
160
  # @option options [String] :instance_id
164
- # The ID of the instance used to 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`.
161
+ # The ID of the instance used to base the launch configuration on. If
162
+ # specified, Amazon EC2 Auto Scaling uses the configuration values from
163
+ # the specified instance to create a new launch configuration. To get
164
+ # the instance ID, use the Amazon EC2 [DescribeInstances][1] API
165
+ # operation. For more information, see [Creating an Auto Scaling group
166
+ # using an EC2 instance][2] in the *Amazon EC2 Auto Scaling User Guide*.
176
167
  #
177
168
  #
178
169
  #
179
170
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html
171
+ # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-from-instance.html
180
172
  # @option options [required, Integer] :min_size
181
173
  # The minimum size of the group.
182
174
  # @option options [required, Integer] :max_size
@@ -193,62 +185,50 @@ module Aws::AutoScaling
193
185
  # @option options [Integer] :desired_capacity
194
186
  # The desired capacity is the initial capacity of the Auto Scaling group
195
187
  # at the time of its creation and the capacity it attempts to maintain.
196
- # It can scale beyond this capacity if you configure 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.
188
+ # It can scale beyond this capacity if you configure auto scaling. This
189
+ # number must be greater than or equal to the minimum size of the group
190
+ # and less than or equal to the maximum size of the group. If you do not
191
+ # specify a desired capacity, the default is the minimum size of the
192
+ # group.
202
193
  # @option options [Integer] :default_cooldown
203
194
  # The amount of time, in seconds, after a scaling activity completes
204
195
  # before another scaling activity can start. The default value is `300`.
205
- #
206
196
  # This setting applies when using simple scaling policies, but not when
207
197
  # using other scaling policies or scheduled scaling. For more
208
- # information, see [Scaling Cooldowns for Amazon EC2 Auto Scaling][1] in
198
+ # information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1] in
209
199
  # the *Amazon EC2 Auto Scaling User Guide*.
210
200
  #
211
201
  #
212
202
  #
213
203
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/Cooldown.html
214
204
  # @option options [Array<String>] :availability_zones
215
- # One or more Availability Zones for the group. This parameter is
216
- # optional if you specify one or more subnets for `VPCZoneIdentifier`.
205
+ # A list of Availability Zones where instances in the Auto Scaling group
206
+ # can be created. This parameter is optional if you specify one or more
207
+ # subnets for `VPCZoneIdentifier`.
217
208
  #
218
209
  # Conditional: If your account supports EC2-Classic and VPC, this
219
210
  # parameter is required to launch instances into EC2-Classic.
220
211
  # @option options [Array<String>] :load_balancer_names
221
212
  # A list of Classic Load Balancers associated with this Auto Scaling
222
213
  # group. For Application Load Balancers and Network Load Balancers,
223
- # specify 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
214
+ # specify `TargetGroupARNs` instead.
232
215
  # @option options [Array<String>] :target_group_arns
233
216
  # The Amazon Resource Names (ARN) of the target groups to associate with
234
217
  # the Auto Scaling group. Instances are registered as targets in a
235
- # target group, and traffic is routed to the target group.
236
- #
237
- # For more information, see [Using a Load Balancer with an Auto Scaling
238
- # Group][1] in the *Amazon EC2 Auto Scaling User Guide*.
218
+ # target group, and traffic is routed to the target group. For more
219
+ # information, see [Elastic Load Balancing and Amazon EC2 Auto
220
+ # Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
239
221
  #
240
222
  #
241
223
  #
242
224
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html
243
225
  # @option options [String] :health_check_type
244
226
  # The service to use for the health checks. The valid values are `EC2`
245
- # and `ELB`. 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*.
227
+ # (default) and `ELB`. If you configure an Auto Scaling group to use
228
+ # load balancer (ELB) health checks, it considers the instance unhealthy
229
+ # if it fails either the EC2 status checks or the load balancer health
230
+ # checks. For more information, see [Health checks for Auto Scaling
231
+ # instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
252
232
  #
253
233
  #
254
234
  #
@@ -257,74 +237,80 @@ module Aws::AutoScaling
257
237
  # The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
258
238
  # before checking the health status of an EC2 instance that has come
259
239
  # into service. During this time, any health check failures for the
260
- # instance are ignored. The default value is `0`.
261
- #
262
- # For more information, see [Health Check Grace Period][1] in the
263
- # *Amazon EC2 Auto Scaling User Guide*.
240
+ # instance are ignored. The default value is `0`. For more information,
241
+ # see [Health check grace period][1] in the *Amazon EC2 Auto Scaling
242
+ # User Guide*.
264
243
  #
265
- # Required if you are adding an `ELB` health check.
244
+ # Conditional: Required if you are adding an `ELB` health check.
266
245
  #
267
246
  #
268
247
  #
269
248
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html#health-check-grace-period
270
249
  # @option options [String] :placement_group
271
- # The name of 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*.
250
+ # The name of an existing placement group into which to launch your
251
+ # instances, if any. A placement group is a logical grouping of
252
+ # instances within a single Availability Zone. You cannot specify
253
+ # multiple Availability Zones and a placement group. For more
254
+ # information, see [Placement Groups][1] in the *Amazon EC2 User Guide
255
+ # for Linux Instances*.
276
256
  #
277
257
  #
278
258
  #
279
259
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html
280
260
  # @option options [String] :vpc_zone_identifier
281
- # A comma-separated list of subnet IDs for 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.
261
+ # A comma-separated list of subnet IDs for a virtual private cloud (VPC)
262
+ # where instances in the Auto Scaling group can be created. If you
263
+ # specify `VPCZoneIdentifier` with `AvailabilityZones`, the subnets that
264
+ # you specify for this parameter must reside in those Availability
265
+ # Zones.
287
266
  #
288
267
  # Conditional: If your account supports EC2-Classic and VPC, this
289
268
  # parameter is required to launch instances into a VPC.
290
269
  # @option options [Array<String>] :termination_policies
291
- # 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*.
270
+ # A policy or a list of policies that are used to select the instance to
271
+ # terminate. These policies are executed in the order that you list
272
+ # them. For more information, see [Controlling which Auto Scaling
273
+ # instances terminate during scale in][1] in the *Amazon EC2 Auto
274
+ # Scaling User Guide*.
298
275
  #
299
276
  #
300
277
  #
301
278
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html
302
279
  # @option options [Boolean] :new_instances_protected_from_scale_in
303
280
  # Indicates whether newly launched instances are protected from
304
- # termination by Amazon EC2 Auto Scaling when scaling in.
305
- #
306
- # For more information about preventing instances from terminating on
307
- # scale in, see [Instance Protection][1] in the *Amazon EC2 Auto Scaling
281
+ # termination by Amazon EC2 Auto Scaling when scaling in. For more
282
+ # information about preventing instances from terminating on scale in,
283
+ # see [Instance scale-in protection][1] in the *Amazon EC2 Auto Scaling
308
284
  # User Guide*.
309
285
  #
310
286
  #
311
287
  #
312
288
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html#instance-protection
289
+ # @option options [Boolean] :capacity_rebalance
290
+ # Indicates whether Capacity Rebalancing is enabled. Otherwise, Capacity
291
+ # Rebalancing is disabled. When you turn on Capacity Rebalancing, Amazon
292
+ # EC2 Auto Scaling attempts to launch a Spot Instance whenever Amazon
293
+ # EC2 notifies that a Spot Instance is at an elevated risk of
294
+ # interruption. After launching a new instance, it then terminates an
295
+ # old instance. For more information, see [Amazon EC2 Auto Scaling
296
+ # Capacity Rebalancing][1] in the *Amazon EC2 Auto Scaling User Guide*.
297
+ #
298
+ #
299
+ #
300
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/capacity-rebalance.html
313
301
  # @option options [Array<Types::LifecycleHookSpecification>] :lifecycle_hook_specification_list
314
- # One or more lifecycle hooks.
302
+ # One or more lifecycle hooks for the group, which specify actions to
303
+ # perform when Amazon EC2 Auto Scaling launches or terminates instances.
315
304
  # @option options [Array<Types::Tag>] :tags
316
305
  # One or more tags. You can tag your Auto Scaling group and propagate
317
- # the tags to the Amazon EC2 instances it launches.
318
- #
319
- # 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*.
306
+ # the tags to the Amazon EC2 instances it launches. Tags are not
307
+ # propagated to Amazon EBS volumes. To add tags to Amazon EBS volumes,
308
+ # specify the tags in a launch template but use caution. If the launch
309
+ # template specifies an instance tag with a key that is also specified
310
+ # for the Auto Scaling group, Amazon EC2 Auto Scaling overrides the
311
+ # value of that instance tag with the value specified by the Auto
312
+ # Scaling group. For more information, see [Tagging Auto Scaling groups
313
+ # and instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
328
314
  #
329
315
  #
330
316
  #
@@ -334,7 +320,7 @@ module Aws::AutoScaling
334
320
  # Auto Scaling group uses to call other AWS services on your behalf. By
335
321
  # default, Amazon EC2 Auto Scaling uses a service-linked role named
336
322
  # AWSServiceRoleForAutoScaling, which it creates if it does not exist.
337
- # For more information, see [Service-Linked Roles][1] in the *Amazon EC2
323
+ # For more information, see [Service-linked roles][1] in the *Amazon EC2
338
324
  # Auto Scaling User Guide*.
339
325
  #
340
326
  #
@@ -342,17 +328,10 @@ module Aws::AutoScaling
342
328
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-service-linked-role.html
343
329
  # @option options [Integer] :max_instance_lifetime
344
330
  # The maximum amount of time, in seconds, that an instance can be in
345
- # service. The default is null.
346
- #
347
- # 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.
331
+ # service. The default is null. If specified, the value must be either 0
332
+ # or a number equal to or greater than 86,400 seconds (1 day). For more
333
+ # information, see [Replacing Auto Scaling instances based on maximum
334
+ # instance lifetime][1] in the *Amazon EC2 Auto Scaling User Guide*.
356
335
  #
357
336
  #
358
337
  #
@@ -449,7 +428,7 @@ module Aws::AutoScaling
449
428
  # @option options [String] :classic_link_vpc_id
450
429
  # The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances
451
430
  # to. For more information, see [ClassicLink][1] in the *Amazon EC2 User
452
- # Guide for Linux Instances* and [Linking EC2-Classic Instances to a
431
+ # Guide for Linux Instances* and [Linking EC2-Classic instances to a
453
432
  # VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
454
433
  #
455
434
  # This parameter can only be used if you are launching EC2-Classic
@@ -463,7 +442,7 @@ module Aws::AutoScaling
463
442
  # The IDs of one or more security groups for the specified
464
443
  # ClassicLink-enabled VPC. For more information, see [ClassicLink][1] in
465
444
  # the *Amazon EC2 User Guide for Linux Instances* and [Linking
466
- # EC2-Classic Instances to a VPC][2] in the *Amazon EC2 Auto Scaling
445
+ # EC2-Classic instances to a VPC][2] in the *Amazon EC2 Auto Scaling
467
446
  # User Guide*.
468
447
  #
469
448
  # If you specify the `ClassicLinkVPCId` parameter, you must specify this
@@ -475,8 +454,8 @@ module Aws::AutoScaling
475
454
  # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-ClassicLink
476
455
  # @option options [String] :user_data
477
456
  # The Base64-encoded user data to make available to the launched EC2
478
- # instances. For more information, see [Instance Metadata and User
479
- # Data][1] in the *Amazon EC2 User Guide for Linux Instances*.
457
+ # instances. For more information, see [Instance metadata and user
458
+ # data][1] in the *Amazon EC2 User Guide for Linux Instances*.
480
459
  #
481
460
  #
482
461
  #
@@ -490,8 +469,8 @@ module Aws::AutoScaling
490
469
  # override any other instance attributes, specify them as part of the
491
470
  # same request.
492
471
  #
493
- # For more information, see [Create a Launch Configuration Using an EC2
494
- # Instance][1] in the *Amazon EC2 Auto Scaling User Guide*.
472
+ # For more information, see [Creating a launch configuration using an
473
+ # EC2 instance][1] in the *Amazon EC2 Auto Scaling User Guide*.
495
474
  #
496
475
  # If you do not specify `InstanceId`, you must specify both `ImageId`
497
476
  # and `InstanceType`.
@@ -537,13 +516,13 @@ module Aws::AutoScaling
537
516
  #
538
517
  #
539
518
  #
540
- # [1]: https://docs.aws.amazon.com/autoscaling/latest/userguide/as-instance-monitoring.html#enable-as-instance-metrics
519
+ # [1]: https://docs.aws.amazon.com/autoscaling/latest/userguide/enable-as-instance-metrics.html
541
520
  # @option options [String] :spot_price
542
521
  # The maximum hourly price to be paid for any Spot Instance launched to
543
522
  # fulfill the request. Spot Instances are launched when the price you
544
523
  # specify exceeds the current Spot price. For more information, see
545
- # [Launching Spot Instances in Your Auto Scaling Group][1] in the
546
- # *Amazon EC2 Auto Scaling User Guide*.
524
+ # [Requesting Spot Instances][1] in the *Amazon EC2 Auto Scaling User
525
+ # Guide*.
547
526
  #
548
527
  # <note markdown="1"> When you change your maximum price by creating a new launch
549
528
  # configuration, running instances will continue to run as long as the
@@ -560,8 +539,8 @@ module Aws::AutoScaling
560
539
  # associated with the IAM role for the instance. The instance profile
561
540
  # contains the IAM role.
562
541
  #
563
- # For more information, see [IAM Role for Applications That Run on
564
- # Amazon EC2 Instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
542
+ # For more information, see [IAM role for applications that run on
543
+ # Amazon EC2 instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
565
544
  #
566
545
  #
567
546
  #
@@ -586,7 +565,7 @@ module Aws::AutoScaling
586
565
  # (VPC), specifies whether to assign a public IP address to the group's
587
566
  # instances. If you specify `true`, each instance in the Auto Scaling
588
567
  # group receives a unique public IP address. For more information, see
589
- # [Launching Auto Scaling Instances in a VPC][1] in the *Amazon EC2 Auto
568
+ # [Launching Auto Scaling instances in a VPC][1] in the *Amazon EC2 Auto
590
569
  # Scaling User Guide*.
591
570
  #
592
571
  # If you specify this parameter, you must specify at least one subnet
@@ -616,22 +595,22 @@ module Aws::AutoScaling
616
595
  # If you specify `PlacementTenancy`, you must specify at least one
617
596
  # subnet for `VPCZoneIdentifier` when you create your group.
618
597
  #
619
- # For more information, see [Instance Placement Tenancy][1] in the
620
- # *Amazon EC2 Auto Scaling User Guide*.
598
+ # For more information, see [Configuring instance tenancy with Amazon
599
+ # EC2 Auto Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
621
600
  #
622
601
  # Valid Values: `default` \| `dedicated`
623
602
  #
624
603
  #
625
604
  #
626
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-vpc-tenancy
605
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling/ec2/userguide/auto-scaling-dedicated-instances.html
627
606
  # @option options [Types::InstanceMetadataOptions] :metadata_options
628
607
  # The metadata options for the instances. For more information, see
629
- # [Instance Metadata and User Data][1] in the *Amazon EC2 User Guide for
630
- # Linux Instances*.
608
+ # [Configuring the Instance Metadata Options][1] in the *Amazon EC2 Auto
609
+ # Scaling User Guide*.
631
610
  #
632
611
  #
633
612
  #
634
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html
613
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-launch-config.html#launch-configurations-imds
635
614
  # @return [LaunchConfiguration]
636
615
  def create_launch_configuration(options = {})
637
616
  @client.create_launch_configuration(options)
@@ -702,9 +681,9 @@ module Aws::AutoScaling
702
681
  # })
703
682
  # @param [Hash] options ({})
704
683
  # @option options [Array<String>] :auto_scaling_group_names
705
- # The names of the Auto Scaling groups. 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.
684
+ # The names of the Auto Scaling groups. By default, you can only specify
685
+ # up to 50 names. You can optionally increase this limit using the
686
+ # `MaxRecords` parameter.
708
687
  #
709
688
  # If you omit this parameter, all Auto Scaling groups are described.
710
689
  # @return [AutoScalingGroup::Collection]