aws-sdk-autoscaling 1.48.0 → 1.53.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.
@@ -55,8 +55,8 @@ module Aws::AutoScaling
55
55
  #
56
56
  # * `SimpleScaling` (default)
57
57
  #
58
- # For more information, see [Target Tracking Scaling Policies][1] and
59
- # [Step and Simple Scaling Policies][2] in the *Amazon EC2 Auto Scaling
58
+ # For more information, see [Target tracking scaling policies][1] and
59
+ # [Step and simple scaling policies][2] in the *Amazon EC2 Auto Scaling
60
60
  # User Guide*.
61
61
  #
62
62
  #
@@ -281,7 +281,7 @@ module Aws::AutoScaling
281
281
  # @example Request syntax with placeholder values
282
282
  #
283
283
  # scaling_policy.delete({
284
- # auto_scaling_group_name: "ResourceName",
284
+ # auto_scaling_group_name: "XmlStringMaxLen255",
285
285
  # })
286
286
  # @param [Hash] options ({})
287
287
  # @option options [String] :auto_scaling_group_name
@@ -296,7 +296,7 @@ module Aws::AutoScaling
296
296
  # @example Request syntax with placeholder values
297
297
  #
298
298
  # scaling_policy.execute({
299
- # auto_scaling_group_name: "ResourceName",
299
+ # auto_scaling_group_name: "XmlStringMaxLen255",
300
300
  # honor_cooldown: false,
301
301
  # metric_value: 1.0,
302
302
  # breach_threshold: 1.0,
@@ -309,7 +309,7 @@ module Aws::AutoScaling
309
309
  # period to complete before executing the policy.
310
310
  #
311
311
  # Valid only if the policy type is `SimpleScaling`. For more
312
- # information, see [Scaling Cooldowns for Amazon EC2 Auto Scaling][1] in
312
+ # information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1] in
313
313
  # the *Amazon EC2 Auto Scaling User Guide*.
314
314
  #
315
315
  #
@@ -233,7 +233,7 @@ module Aws::AutoScaling
233
233
  # @example Request syntax with placeholder values
234
234
  #
235
235
  # scheduled_action.delete({
236
- # auto_scaling_group_name: "ResourceName", # required
236
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
237
237
  # })
238
238
  # @param [Hash] options ({})
239
239
  # @option options [required, String] :auto_scaling_group_name
@@ -173,7 +173,7 @@ module Aws::AutoScaling
173
173
  #
174
174
  # {
175
175
  # instance_ids: ["XmlStringMaxLen19"],
176
- # auto_scaling_group_name: "ResourceName", # required
176
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
177
177
  # }
178
178
  #
179
179
  # @!attribute [rw] instance_ids
@@ -201,7 +201,7 @@ module Aws::AutoScaling
201
201
  # data as a hash:
202
202
  #
203
203
  # {
204
- # auto_scaling_group_name: "ResourceName", # required
204
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
205
205
  # target_group_arns: ["XmlStringMaxLen511"], # required
206
206
  # }
207
207
  #
@@ -211,7 +211,13 @@ module Aws::AutoScaling
211
211
  #
212
212
  # @!attribute [rw] target_group_arns
213
213
  # The Amazon Resource Names (ARN) of the target groups. You can
214
- # specify up to 10 target groups.
214
+ # specify up to 10 target groups. To get the ARN of a target group,
215
+ # use the Elastic Load Balancing [DescribeTargetGroups][1] API
216
+ # operation.
217
+ #
218
+ #
219
+ #
220
+ # [1]: https://docs.aws.amazon.com/elasticloadbalancing/latest/APIReference/API_DescribeTargetGroups.html
215
221
  # @return [Array<String>]
216
222
  #
217
223
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/AttachLoadBalancerTargetGroupsType AWS API Documentation
@@ -231,7 +237,7 @@ module Aws::AutoScaling
231
237
  # data as a hash:
232
238
  #
233
239
  # {
234
- # auto_scaling_group_name: "ResourceName", # required
240
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
235
241
  # load_balancer_names: ["XmlStringMaxLen255"], # required
236
242
  # }
237
243
  #
@@ -373,7 +379,7 @@ module Aws::AutoScaling
373
379
  # @return [Integer]
374
380
  #
375
381
  # @!attribute [rw] capacity_rebalance
376
- # Indicates whether capacity rebalance is enabled.
382
+ # Indicates whether Capacity Rebalancing is enabled.
377
383
  # @return [Boolean]
378
384
  #
379
385
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/AutoScalingGroup AWS API Documentation
@@ -414,16 +420,15 @@ module Aws::AutoScaling
414
420
  # data as a hash:
415
421
  #
416
422
  # {
417
- # auto_scaling_group_names: ["ResourceName"],
423
+ # auto_scaling_group_names: ["XmlStringMaxLen255"],
418
424
  # next_token: "XmlString",
419
425
  # max_records: 1,
420
426
  # }
421
427
  #
422
428
  # @!attribute [rw] auto_scaling_group_names
423
- # The names of the Auto Scaling groups. Each name can be a maximum of
424
- # 1600 characters. By default, you can only specify up to 50 names.
425
- # You can optionally increase this limit using the `MaxRecords`
426
- # parameter.
429
+ # The names of the Auto Scaling groups. By default, you can only
430
+ # specify up to 50 names. You can optionally increase this limit using
431
+ # the `MaxRecords` parameter.
427
432
  #
428
433
  # If you omit this parameter, all Auto Scaling groups are described.
429
434
  # @return [Array<String>]
@@ -488,7 +493,18 @@ module Aws::AutoScaling
488
493
  # @return [String]
489
494
  #
490
495
  # @!attribute [rw] lifecycle_state
491
- # The lifecycle state for the instance.
496
+ # The lifecycle state for the instance. The `Quarantined` state is not
497
+ # used. For information about lifecycle states, see [Instance
498
+ # lifecycle][1] in the *Amazon EC2 Auto Scaling User Guide*.
499
+ #
500
+ # Valid Values: `Pending` \| `Pending:Wait` \| `Pending:Proceed` \|
501
+ # `Quarantined` \| `InService` \| `Terminating` \| `Terminating:Wait`
502
+ # \| `Terminating:Proceed` \| `Terminated` \| `Detaching` \|
503
+ # `Detached` \| `EnteringStandby` \| `Standby`
504
+ #
505
+ #
506
+ #
507
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/AutoScalingGroupLifecycle.html
492
508
  # @return [String]
493
509
  #
494
510
  # @!attribute [rw] health_status
@@ -575,8 +591,8 @@ module Aws::AutoScaling
575
591
  # data as a hash:
576
592
  #
577
593
  # {
578
- # auto_scaling_group_name: "ResourceName", # required
579
- # scheduled_action_names: ["ResourceName"], # required
594
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
595
+ # scheduled_action_names: ["XmlStringMaxLen255"], # required
580
596
  # }
581
597
  #
582
598
  # @!attribute [rw] auto_scaling_group_name
@@ -614,7 +630,7 @@ module Aws::AutoScaling
614
630
  # data as a hash:
615
631
  #
616
632
  # {
617
- # auto_scaling_group_name: "ResourceName", # required
633
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
618
634
  # scheduled_update_group_actions: [ # required
619
635
  # {
620
636
  # scheduled_action_name: "XmlStringMaxLen255", # required
@@ -796,7 +812,7 @@ module Aws::AutoScaling
796
812
  #
797
813
  # {
798
814
  # auto_scaling_group_name: "XmlStringMaxLen255", # required
799
- # launch_configuration_name: "ResourceName",
815
+ # launch_configuration_name: "XmlStringMaxLen255",
800
816
  # launch_template: {
801
817
  # launch_template_id: "XmlStringMaxLen255",
802
818
  # launch_template_name: "LaunchTemplateName",
@@ -813,6 +829,11 @@ module Aws::AutoScaling
813
829
  # {
814
830
  # instance_type: "XmlStringMaxLen255",
815
831
  # weighted_capacity: "XmlStringMaxLen32",
832
+ # launch_template_specification: {
833
+ # launch_template_id: "XmlStringMaxLen255",
834
+ # launch_template_name: "LaunchTemplateName",
835
+ # version: "XmlStringMaxLen255",
836
+ # },
816
837
  # },
817
838
  # ],
818
839
  # },
@@ -848,7 +869,7 @@ module Aws::AutoScaling
848
869
  # heartbeat_timeout: 1,
849
870
  # default_result: "LifecycleActionResult",
850
871
  # notification_target_arn: "NotificationTargetResourceName",
851
- # role_arn: "ResourceName",
872
+ # role_arn: "XmlStringMaxLen255",
852
873
  # },
853
874
  # ],
854
875
  # tags: [
@@ -870,34 +891,31 @@ module Aws::AutoScaling
870
891
  # @return [String]
871
892
  #
872
893
  # @!attribute [rw] launch_configuration_name
873
- # The name of the launch configuration to use when an instance is
874
- # launched. To get the launch configuration name, use the
875
- # DescribeLaunchConfigurations API operation. New launch
876
- # configurations can be created with the CreateLaunchConfiguration
877
- # API.
894
+ # The name of the launch configuration to use to launch instances.
878
895
  #
879
- # You must specify one of the following parameters in your request:
880
- # `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
881
- # `MixedInstancesPolicy`.
896
+ # Conditional: You must specify either a launch template
897
+ # (`LaunchTemplate` or `MixedInstancesPolicy`) or a launch
898
+ # configuration (`LaunchConfigurationName` or `InstanceId`).
882
899
  # @return [String]
883
900
  #
884
901
  # @!attribute [rw] launch_template
885
- # Parameters used to specify the launch template and version to use
886
- # when an instance is launched.
902
+ # Parameters used to specify the launch template and version to use to
903
+ # launch instances.
887
904
  #
888
- # For more information, see [LaunchTemplateSpecification][1] in the
889
- # *Amazon EC2 Auto Scaling API Reference*.
905
+ # Conditional: You must specify either a launch template
906
+ # (`LaunchTemplate` or `MixedInstancesPolicy`) or a launch
907
+ # configuration (`LaunchConfigurationName` or `InstanceId`).
890
908
  #
891
- # You can alternatively associate a launch template to the Auto
892
- # Scaling group by using the `MixedInstancesPolicy` parameter.
909
+ # <note markdown="1"> The launch template that is specified must be configured for use
910
+ # with an Auto Scaling group. For more information, see [Creating a
911
+ # launch template for an Auto Scaling group][1] in the *Amazon EC2
912
+ # Auto Scaling User Guide*.
893
913
  #
894
- # You must specify one of the following parameters in your request:
895
- # `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
896
- # `MixedInstancesPolicy`.
914
+ # </note>
897
915
  #
898
916
  #
899
917
  #
900
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_LaunchTemplateSpecification.html
918
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-launch-template.html
901
919
  # @return [Types::LaunchTemplateSpecification]
902
920
  #
903
921
  # @!attribute [rw] mixed_instances_policy
@@ -908,42 +926,32 @@ module Aws::AutoScaling
908
926
  # The policy includes parameters that not only define the distribution
909
927
  # of On-Demand Instances and Spot Instances, the maximum price to pay
910
928
  # for Spot Instances, and how the Auto Scaling group allocates
911
- # instance types to fulfill On-Demand and Spot capacity, but also the
912
- # parameters that specify the instance configuration information—the
913
- # launch template and instance types.
914
- #
915
- # For more information, see [MixedInstancesPolicy][1] in the *Amazon
916
- # EC2 Auto Scaling API Reference* and [Auto Scaling Groups with
917
- # Multiple Instance Types and Purchase Options][2] in the *Amazon EC2
918
- # Auto Scaling User Guide*.
919
- #
920
- # You must specify one of the following parameters in your request:
921
- # `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
922
- # `MixedInstancesPolicy`.
929
+ # instance types to fulfill On-Demand and Spot capacities, but also
930
+ # the parameters that specify the instance configuration
931
+ # information—the launch template and instance types. The policy can
932
+ # also include a weight for each instance type and different launch
933
+ # templates for individual instance types. For more information, see
934
+ # [Auto Scaling groups with multiple instance types and purchase
935
+ # options][1] in the *Amazon EC2 Auto Scaling User Guide*.
923
936
  #
924
937
  #
925
938
  #
926
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_MixedInstancesPolicy.html
927
- # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
939
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
928
940
  # @return [Types::MixedInstancesPolicy]
929
941
  #
930
942
  # @!attribute [rw] instance_id
931
- # The ID of the instance used to create a launch configuration for the
932
- # group. To get the instance ID, use the Amazon EC2
933
- # [DescribeInstances][1] API operation.
934
- #
935
- # When you specify an ID of an instance, Amazon EC2 Auto Scaling
936
- # creates a new launch configuration and associates it with the group.
937
- # This launch configuration derives its attributes from the specified
938
- # instance, except for the block device mapping.
939
- #
940
- # You must specify one of the following parameters in your request:
941
- # `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
942
- # `MixedInstancesPolicy`.
943
+ # The ID of the instance used to base the launch configuration on. If
944
+ # specified, Amazon EC2 Auto Scaling uses the configuration values
945
+ # from the specified instance to create a new launch configuration. To
946
+ # get the instance ID, use the Amazon EC2 [DescribeInstances][1] API
947
+ # operation. For more information, see [Creating an Auto Scaling group
948
+ # using an EC2 instance][2] in the *Amazon EC2 Auto Scaling User
949
+ # Guide*.
943
950
  #
944
951
  #
945
952
  #
946
953
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html
954
+ # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-from-instance.html
947
955
  # @return [String]
948
956
  #
949
957
  # @!attribute [rw] min_size
@@ -966,23 +974,19 @@ module Aws::AutoScaling
966
974
  # @!attribute [rw] desired_capacity
967
975
  # The desired capacity is the initial capacity of the Auto Scaling
968
976
  # group at the time of its creation and the capacity it attempts to
969
- # maintain. It can scale beyond this capacity if you configure
970
- # automatic scaling.
971
- #
972
- # This number must be greater than or equal to the minimum size of the
973
- # group and less than or equal to the maximum size of the group. If
974
- # you do not specify a desired capacity, the default is the minimum
975
- # size of the group.
977
+ # maintain. It can scale beyond this capacity if you configure auto
978
+ # scaling. This number must be greater than or equal to the minimum
979
+ # size of the group and less than or equal to the maximum size of the
980
+ # group. If you do not specify a desired capacity, the default is the
981
+ # minimum size of the group.
976
982
  # @return [Integer]
977
983
  #
978
984
  # @!attribute [rw] default_cooldown
979
985
  # The amount of time, in seconds, after a scaling activity completes
980
986
  # before another scaling activity can start. The default value is
981
- # `300`.
982
- #
983
- # This setting applies when using simple scaling policies, but not
984
- # when using other scaling policies or scheduled scaling. For more
985
- # information, see [Scaling Cooldowns for Amazon EC2 Auto Scaling][1]
987
+ # `300`. This setting applies when using simple scaling policies, but
988
+ # not when using other scaling policies or scheduled scaling. For more
989
+ # information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1]
986
990
  # in the *Amazon EC2 Auto Scaling User Guide*.
987
991
  #
988
992
  #
@@ -991,8 +995,9 @@ module Aws::AutoScaling
991
995
  # @return [Integer]
992
996
  #
993
997
  # @!attribute [rw] availability_zones
994
- # One or more Availability Zones for the group. This parameter is
995
- # optional if you specify one or more subnets for `VPCZoneIdentifier`.
998
+ # A list of Availability Zones where instances in the Auto Scaling
999
+ # group can be created. This parameter is optional if you specify one
1000
+ # or more subnets for `VPCZoneIdentifier`.
996
1001
  #
997
1002
  # Conditional: If your account supports EC2-Classic and VPC, this
998
1003
  # parameter is required to launch instances into EC2-Classic.
@@ -1000,25 +1005,17 @@ module Aws::AutoScaling
1000
1005
  #
1001
1006
  # @!attribute [rw] load_balancer_names
1002
1007
  # A list of Classic Load Balancers associated with this Auto Scaling
1003
- # group. For Application Load Balancers and Network Load Balancers,
1004
- # specify a list of target groups using the `TargetGroupARNs` property
1008
+ # group. For Application Load Balancers, Network Load Balancers, and
1009
+ # Gateway Load Balancers, specify the `TargetGroupARNs` property
1005
1010
  # instead.
1006
- #
1007
- # For more information, see [Using a Load Balancer with an Auto
1008
- # Scaling Group][1] in the *Amazon EC2 Auto Scaling User Guide*.
1009
- #
1010
- #
1011
- #
1012
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html
1013
1011
  # @return [Array<String>]
1014
1012
  #
1015
1013
  # @!attribute [rw] target_group_arns
1016
1014
  # The Amazon Resource Names (ARN) of the target groups to associate
1017
1015
  # with the Auto Scaling group. Instances are registered as targets in
1018
- # a target group, and traffic is routed to the target group.
1019
- #
1020
- # For more information, see [Using a Load Balancer with an Auto
1021
- # Scaling Group][1] in the *Amazon EC2 Auto Scaling User Guide*.
1016
+ # a target group, and traffic is routed to the target group. For more
1017
+ # information, see [Elastic Load Balancing and Amazon EC2 Auto
1018
+ # Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
1022
1019
  #
1023
1020
  #
1024
1021
  #
@@ -1027,13 +1024,12 @@ module Aws::AutoScaling
1027
1024
  #
1028
1025
  # @!attribute [rw] health_check_type
1029
1026
  # The service to use for the health checks. The valid values are `EC2`
1030
- # and `ELB`. The default value is `EC2`. If you configure an Auto
1031
- # Scaling group to use ELB health checks, it considers the instance
1027
+ # (default) and `ELB`. If you configure an Auto Scaling group to use
1028
+ # load balancer (ELB) health checks, it considers the instance
1032
1029
  # unhealthy if it fails either the EC2 status checks or the load
1033
- # balancer health checks.
1034
- #
1035
- # For more information, see [Health Checks for Auto Scaling
1036
- # Instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
1030
+ # balancer health checks. For more information, see [Health checks for
1031
+ # Auto Scaling instances][1] in the *Amazon EC2 Auto Scaling User
1032
+ # Guide*.
1037
1033
  #
1038
1034
  #
1039
1035
  #
@@ -1044,12 +1040,11 @@ module Aws::AutoScaling
1044
1040
  # The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
1045
1041
  # before checking the health status of an EC2 instance that has come
1046
1042
  # into service. During this time, any health check failures for the
1047
- # instance are ignored. The default value is `0`.
1048
- #
1049
- # For more information, see [Health Check Grace Period][1] in the
1050
- # *Amazon EC2 Auto Scaling User Guide*.
1043
+ # instance are ignored. The default value is `0`. For more
1044
+ # information, see [Health check grace period][1] in the *Amazon EC2
1045
+ # Auto Scaling User Guide*.
1051
1046
  #
1052
- # Required if you are adding an `ELB` health check.
1047
+ # Conditional: Required if you are adding an `ELB` health check.
1053
1048
  #
1054
1049
  #
1055
1050
  #
@@ -1057,11 +1052,12 @@ module Aws::AutoScaling
1057
1052
  # @return [Integer]
1058
1053
  #
1059
1054
  # @!attribute [rw] placement_group
1060
- # The name of the placement group into which to launch your instances,
1061
- # if any. A placement group is a logical grouping of instances within
1062
- # a single Availability Zone. You cannot specify multiple Availability
1063
- # Zones and a placement group. For more information, see [Placement
1064
- # Groups][1] in the *Amazon EC2 User Guide for Linux Instances*.
1055
+ # The name of an existing placement group into which to launch your
1056
+ # instances, if any. A placement group is a logical grouping of
1057
+ # instances within a single Availability Zone. You cannot specify
1058
+ # multiple Availability Zones and a placement group. For more
1059
+ # information, see [Placement Groups][1] in the *Amazon EC2 User Guide
1060
+ # for Linux Instances*.
1065
1061
  #
1066
1062
  #
1067
1063
  #
@@ -1069,10 +1065,9 @@ module Aws::AutoScaling
1069
1065
  # @return [String]
1070
1066
  #
1071
1067
  # @!attribute [rw] vpc_zone_identifier
1072
- # A comma-separated list of subnet IDs for your virtual private cloud
1073
- # (VPC).
1074
- #
1075
- # If you specify `VPCZoneIdentifier` with `AvailabilityZones`, the
1068
+ # A comma-separated list of subnet IDs for a virtual private cloud
1069
+ # (VPC) where instances in the Auto Scaling group can be created. If
1070
+ # you specify `VPCZoneIdentifier` with `AvailabilityZones`, the
1076
1071
  # subnets that you specify for this parameter must reside in those
1077
1072
  # Availability Zones.
1078
1073
  #
@@ -1081,13 +1076,11 @@ module Aws::AutoScaling
1081
1076
  # @return [String]
1082
1077
  #
1083
1078
  # @!attribute [rw] termination_policies
1084
- # One or more termination policies used to select the instance to
1085
- # terminate. These policies are executed in the order that they are
1086
- # listed.
1087
- #
1088
- # For more information, see [Controlling Which Instances Auto Scaling
1089
- # Terminates During Scale In][1] in the *Amazon EC2 Auto Scaling User
1090
- # Guide*.
1079
+ # A policy or a list of policies that are used to select the instance
1080
+ # to terminate. These policies are executed in the order that you list
1081
+ # them. For more information, see [Controlling which Auto Scaling
1082
+ # instances terminate during scale in][1] in the *Amazon EC2 Auto
1083
+ # Scaling User Guide*.
1091
1084
  #
1092
1085
  #
1093
1086
  #
@@ -1096,10 +1089,9 @@ module Aws::AutoScaling
1096
1089
  #
1097
1090
  # @!attribute [rw] new_instances_protected_from_scale_in
1098
1091
  # Indicates whether newly launched instances are protected from
1099
- # termination by Amazon EC2 Auto Scaling when scaling in.
1100
- #
1101
- # For more information about preventing instances from terminating on
1102
- # scale in, see [Instance Protection][1] in the *Amazon EC2 Auto
1092
+ # termination by Amazon EC2 Auto Scaling when scaling in. For more
1093
+ # information about preventing instances from terminating on scale in,
1094
+ # see [Instance scale-in protection][1] in the *Amazon EC2 Auto
1103
1095
  # Scaling User Guide*.
1104
1096
  #
1105
1097
  #
@@ -1108,17 +1100,14 @@ module Aws::AutoScaling
1108
1100
  # @return [Boolean]
1109
1101
  #
1110
1102
  # @!attribute [rw] capacity_rebalance
1111
- # Indicates whether capacity rebalance is enabled. Otherwise, capacity
1112
- # rebalance is disabled.
1113
- #
1114
- # You can enable capacity rebalancing for your Auto Scaling groups
1115
- # when using Spot Instances. When you turn on capacity rebalancing,
1116
- # Amazon EC2 Auto Scaling attempts to launch a Spot Instance whenever
1117
- # Amazon EC2 predicts that a Spot Instance is at an elevated risk of
1118
- # interruption. After launching a new instance, it then terminates an
1119
- # old instance. For more information, see [Amazon EC2 Auto Scaling
1120
- # capacity rebalancing][1] in the *Amazon EC2 Auto Scaling User
1121
- # Guide*.
1103
+ # Indicates whether Capacity Rebalancing is enabled. Otherwise,
1104
+ # Capacity Rebalancing is disabled. When you turn on Capacity
1105
+ # Rebalancing, Amazon EC2 Auto Scaling attempts to launch a Spot
1106
+ # Instance whenever Amazon EC2 notifies that a Spot Instance is at an
1107
+ # elevated risk of interruption. After launching a new instance, it
1108
+ # then terminates an old instance. For more information, see [Amazon
1109
+ # EC2 Auto Scaling Capacity Rebalancing][1] in the *Amazon EC2 Auto
1110
+ # Scaling User Guide*.
1122
1111
  #
1123
1112
  #
1124
1113
  #
@@ -1126,22 +1115,22 @@ module Aws::AutoScaling
1126
1115
  # @return [Boolean]
1127
1116
  #
1128
1117
  # @!attribute [rw] lifecycle_hook_specification_list
1129
- # One or more lifecycle hooks.
1118
+ # One or more lifecycle hooks for the group, which specify actions to
1119
+ # perform when Amazon EC2 Auto Scaling launches or terminates
1120
+ # instances.
1130
1121
  # @return [Array<Types::LifecycleHookSpecification>]
1131
1122
  #
1132
1123
  # @!attribute [rw] tags
1133
1124
  # One or more tags. You can tag your Auto Scaling group and propagate
1134
- # the tags to the Amazon EC2 instances it launches.
1135
- #
1136
- # Tags are not propagated to Amazon EBS volumes. To add tags to Amazon
1137
- # EBS volumes, specify the tags in a launch template but use caution.
1138
- # If the launch template specifies an instance tag with a key that is
1139
- # also specified for the Auto Scaling group, Amazon EC2 Auto Scaling
1140
- # overrides the value of that instance tag with the value specified by
1141
- # the Auto Scaling group.
1142
- #
1143
- # For more information, see [Tagging Auto Scaling Groups and
1144
- # Instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
1125
+ # the tags to the Amazon EC2 instances it launches. Tags are not
1126
+ # propagated to Amazon EBS volumes. To add tags to Amazon EBS volumes,
1127
+ # specify the tags in a launch template but use caution. If the launch
1128
+ # template specifies an instance tag with a key that is also specified
1129
+ # for the Auto Scaling group, Amazon EC2 Auto Scaling overrides the
1130
+ # value of that instance tag with the value specified by the Auto
1131
+ # Scaling group. For more information, see [Tagging Auto Scaling
1132
+ # groups and instances][1] in the *Amazon EC2 Auto Scaling User
1133
+ # Guide*.
1145
1134
  #
1146
1135
  #
1147
1136
  #
@@ -1153,7 +1142,7 @@ module Aws::AutoScaling
1153
1142
  # Auto Scaling group uses to call other AWS services on your behalf.
1154
1143
  # By default, Amazon EC2 Auto Scaling uses a service-linked role named
1155
1144
  # AWSServiceRoleForAutoScaling, which it creates if it does not exist.
1156
- # For more information, see [Service-Linked Roles][1] in the *Amazon
1145
+ # For more information, see [Service-linked roles][1] in the *Amazon
1157
1146
  # EC2 Auto Scaling User Guide*.
1158
1147
  #
1159
1148
  #
@@ -1163,18 +1152,12 @@ module Aws::AutoScaling
1163
1152
  #
1164
1153
  # @!attribute [rw] max_instance_lifetime
1165
1154
  # The maximum amount of time, in seconds, that an instance can be in
1166
- # service. The default is null.
1167
- #
1168
- # This parameter is optional, but if you specify a value for it, you
1169
- # must specify a value of at least 604,800 seconds (7 days). To clear
1170
- # a previously set value, specify a new value of 0.
1171
- #
1172
- # For more information, see [Replacing Auto Scaling Instances Based on
1173
- # Maximum Instance Lifetime][1] in the *Amazon EC2 Auto Scaling User
1155
+ # service. The default is null. If specified, the value must be either
1156
+ # 0 or a number equal to or greater than 86,400 seconds (1 day). For
1157
+ # more information, see [Replacing Auto Scaling instances based on
1158
+ # maximum instance lifetime][1] in the *Amazon EC2 Auto Scaling User
1174
1159
  # Guide*.
1175
1160
  #
1176
- # Valid Range: Minimum value of 0.
1177
- #
1178
1161
  #
1179
1162
  #
1180
1163
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-max-instance-lifetime.html
@@ -1303,7 +1286,7 @@ module Aws::AutoScaling
1303
1286
  # The ID of a ClassicLink-enabled VPC to link your EC2-Classic
1304
1287
  # instances to. For more information, see [ClassicLink][1] in the
1305
1288
  # *Amazon EC2 User Guide for Linux Instances* and [Linking EC2-Classic
1306
- # Instances to a VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
1289
+ # instances to a VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
1307
1290
  #
1308
1291
  # This parameter can only be used if you are launching EC2-Classic
1309
1292
  # instances.
@@ -1318,7 +1301,7 @@ module Aws::AutoScaling
1318
1301
  # The IDs of one or more security groups for the specified
1319
1302
  # ClassicLink-enabled VPC. For more information, see [ClassicLink][1]
1320
1303
  # in the *Amazon EC2 User Guide for Linux Instances* and [Linking
1321
- # EC2-Classic Instances to a VPC][2] in the *Amazon EC2 Auto Scaling
1304
+ # EC2-Classic instances to a VPC][2] in the *Amazon EC2 Auto Scaling
1322
1305
  # User Guide*.
1323
1306
  #
1324
1307
  # If you specify the `ClassicLinkVPCId` parameter, you must specify
@@ -1331,13 +1314,17 @@ module Aws::AutoScaling
1331
1314
  # @return [Array<String>]
1332
1315
  #
1333
1316
  # @!attribute [rw] user_data
1334
- # The Base64-encoded user data to make available to the launched EC2
1335
- # instances. For more information, see [Instance Metadata and User
1336
- # Data][1] in the *Amazon EC2 User Guide for Linux Instances*.
1317
+ # The user data to make available to the launched EC2 instances. For
1318
+ # more information, see [Instance metadata and user data][1] (Linux)
1319
+ # and [Instance metadata and user data][2] (Windows). If you are using
1320
+ # a command line tool, base64-encoding is performed for you, and you
1321
+ # can load the text from a file. Otherwise, you must provide
1322
+ # base64-encoded text. User data is limited to 16 KB.
1337
1323
  #
1338
1324
  #
1339
1325
  #
1340
1326
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html
1327
+ # [2]: https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2-instance-metadata.html
1341
1328
  # @return [String]
1342
1329
  #
1343
1330
  # @!attribute [rw] instance_id
@@ -1349,8 +1336,8 @@ module Aws::AutoScaling
1349
1336
  # override any other instance attributes, specify them as part of the
1350
1337
  # same request.
1351
1338
  #
1352
- # For more information, see [Create a Launch Configuration Using an
1353
- # EC2 Instance][1] in the *Amazon EC2 Auto Scaling User Guide*.
1339
+ # For more information, see [Creating a launch configuration using an
1340
+ # EC2 instance][1] in the *Amazon EC2 Auto Scaling User Guide*.
1354
1341
  #
1355
1342
  # If you do not specify `InstanceId`, you must specify both `ImageId`
1356
1343
  # and `InstanceType`.
@@ -1365,7 +1352,7 @@ module Aws::AutoScaling
1365
1352
  #
1366
1353
  # For information about available instance types, see [Available
1367
1354
  # Instance Types][1] in the *Amazon EC2 User Guide for Linux
1368
- # Instances.*
1355
+ # Instances*.
1369
1356
  #
1370
1357
  # If you do not specify `InstanceId`, you must specify `InstanceType`.
1371
1358
  #
@@ -1414,8 +1401,8 @@ module Aws::AutoScaling
1414
1401
  # The maximum hourly price to be paid for any Spot Instance launched
1415
1402
  # to fulfill the request. Spot Instances are launched when the price
1416
1403
  # you specify exceeds the current Spot price. For more information,
1417
- # see [Launching Spot Instances in Your Auto Scaling Group][1] in the
1418
- # *Amazon EC2 Auto Scaling User Guide*.
1404
+ # see [Requesting Spot Instances][1] in the *Amazon EC2 Auto Scaling
1405
+ # User Guide*.
1419
1406
  #
1420
1407
  # <note markdown="1"> When you change your maximum price by creating a new launch
1421
1408
  # configuration, running instances will continue to run as long as the
@@ -1434,8 +1421,8 @@ module Aws::AutoScaling
1434
1421
  # associated with the IAM role for the instance. The instance profile
1435
1422
  # contains the IAM role.
1436
1423
  #
1437
- # For more information, see [IAM Role for Applications That Run on
1438
- # Amazon EC2 Instances][1] in the *Amazon EC2 Auto Scaling User
1424
+ # For more information, see [IAM role for applications that run on
1425
+ # Amazon EC2 instances][1] in the *Amazon EC2 Auto Scaling User
1439
1426
  # Guide*.
1440
1427
  #
1441
1428
  #
@@ -1466,7 +1453,7 @@ module Aws::AutoScaling
1466
1453
  # (VPC), specifies whether to assign a public IP address to the
1467
1454
  # group's instances. If you specify `true`, each instance in the Auto
1468
1455
  # Scaling group receives a unique public IP address. For more
1469
- # information, see [Launching Auto Scaling Instances in a VPC][1] in
1456
+ # information, see [Launching Auto Scaling instances in a VPC][1] in
1470
1457
  # the *Amazon EC2 Auto Scaling User Guide*.
1471
1458
  #
1472
1459
  # If you specify this parameter, you must specify at least one subnet
@@ -1498,14 +1485,14 @@ module Aws::AutoScaling
1498
1485
  # If you specify `PlacementTenancy`, you must specify at least one
1499
1486
  # subnet for `VPCZoneIdentifier` when you create your group.
1500
1487
  #
1501
- # For more information, see [Instance Placement Tenancy][1] in the
1502
- # *Amazon EC2 Auto Scaling User Guide*.
1488
+ # For more information, see [Configuring instance tenancy with Amazon
1489
+ # EC2 Auto Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
1503
1490
  #
1504
1491
  # Valid Values: `default` \| `dedicated`
1505
1492
  #
1506
1493
  #
1507
1494
  #
1508
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-vpc-tenancy
1495
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-dedicated-instances.html
1509
1496
  # @return [String]
1510
1497
  #
1511
1498
  # @!attribute [rw] metadata_options
@@ -1650,7 +1637,7 @@ module Aws::AutoScaling
1650
1637
  # data as a hash:
1651
1638
  #
1652
1639
  # {
1653
- # auto_scaling_group_name: "ResourceName", # required
1640
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
1654
1641
  # force_delete: false,
1655
1642
  # }
1656
1643
  #
@@ -1683,7 +1670,7 @@ module Aws::AutoScaling
1683
1670
  #
1684
1671
  # {
1685
1672
  # lifecycle_hook_name: "AsciiStringMaxLen255", # required
1686
- # auto_scaling_group_name: "ResourceName", # required
1673
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
1687
1674
  # }
1688
1675
  #
1689
1676
  # @!attribute [rw] lifecycle_hook_name
@@ -1707,8 +1694,8 @@ module Aws::AutoScaling
1707
1694
  # data as a hash:
1708
1695
  #
1709
1696
  # {
1710
- # auto_scaling_group_name: "ResourceName", # required
1711
- # topic_arn: "ResourceName", # required
1697
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
1698
+ # topic_arn: "XmlStringMaxLen255", # required
1712
1699
  # }
1713
1700
  #
1714
1701
  # @!attribute [rw] auto_scaling_group_name
@@ -1733,7 +1720,7 @@ module Aws::AutoScaling
1733
1720
  # data as a hash:
1734
1721
  #
1735
1722
  # {
1736
- # auto_scaling_group_name: "ResourceName",
1723
+ # auto_scaling_group_name: "XmlStringMaxLen255",
1737
1724
  # policy_name: "ResourceName", # required
1738
1725
  # }
1739
1726
  #
@@ -1758,8 +1745,8 @@ module Aws::AutoScaling
1758
1745
  # data as a hash:
1759
1746
  #
1760
1747
  # {
1761
- # auto_scaling_group_name: "ResourceName", # required
1762
- # scheduled_action_name: "ResourceName", # required
1748
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
1749
+ # scheduled_action_name: "XmlStringMaxLen255", # required
1763
1750
  # }
1764
1751
  #
1765
1752
  # @!attribute [rw] auto_scaling_group_name
@@ -1983,7 +1970,7 @@ module Aws::AutoScaling
1983
1970
  # data as a hash:
1984
1971
  #
1985
1972
  # {
1986
- # auto_scaling_group_name: "ResourceName", # required
1973
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
1987
1974
  # lifecycle_hook_names: ["AsciiStringMaxLen255"],
1988
1975
  # }
1989
1976
  #
@@ -2009,7 +1996,7 @@ module Aws::AutoScaling
2009
1996
  # data as a hash:
2010
1997
  #
2011
1998
  # {
2012
- # auto_scaling_group_name: "ResourceName", # required
1999
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
2013
2000
  # next_token: "XmlString",
2014
2001
  # max_records: 1,
2015
2002
  # }
@@ -2063,7 +2050,7 @@ module Aws::AutoScaling
2063
2050
  # data as a hash:
2064
2051
  #
2065
2052
  # {
2066
- # auto_scaling_group_name: "ResourceName", # required
2053
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
2067
2054
  # next_token: "XmlString",
2068
2055
  # max_records: 1,
2069
2056
  # }
@@ -2155,7 +2142,7 @@ module Aws::AutoScaling
2155
2142
  # data as a hash:
2156
2143
  #
2157
2144
  # {
2158
- # auto_scaling_group_names: ["ResourceName"],
2145
+ # auto_scaling_group_names: ["XmlStringMaxLen255"],
2159
2146
  # next_token: "XmlString",
2160
2147
  # max_records: 1,
2161
2148
  # }
@@ -2188,7 +2175,7 @@ module Aws::AutoScaling
2188
2175
  # data as a hash:
2189
2176
  #
2190
2177
  # {
2191
- # auto_scaling_group_name: "ResourceName",
2178
+ # auto_scaling_group_name: "XmlStringMaxLen255",
2192
2179
  # policy_names: ["ResourceName"],
2193
2180
  # policy_types: ["XmlStringMaxLen64"],
2194
2181
  # next_token: "XmlString",
@@ -2238,7 +2225,7 @@ module Aws::AutoScaling
2238
2225
  #
2239
2226
  # {
2240
2227
  # activity_ids: ["XmlString"],
2241
- # auto_scaling_group_name: "ResourceName",
2228
+ # auto_scaling_group_name: "XmlStringMaxLen255",
2242
2229
  # max_records: 1,
2243
2230
  # next_token: "XmlString",
2244
2231
  # }
@@ -2280,8 +2267,8 @@ module Aws::AutoScaling
2280
2267
  # data as a hash:
2281
2268
  #
2282
2269
  # {
2283
- # auto_scaling_group_name: "ResourceName",
2284
- # scheduled_action_names: ["ResourceName"],
2270
+ # auto_scaling_group_name: "XmlStringMaxLen255",
2271
+ # scheduled_action_names: ["XmlStringMaxLen255"],
2285
2272
  # start_time: Time.now,
2286
2273
  # end_time: Time.now,
2287
2274
  # next_token: "XmlString",
@@ -2405,7 +2392,7 @@ module Aws::AutoScaling
2405
2392
  #
2406
2393
  # {
2407
2394
  # instance_ids: ["XmlStringMaxLen19"],
2408
- # auto_scaling_group_name: "ResourceName", # required
2395
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
2409
2396
  # should_decrement_desired_capacity: false, # required
2410
2397
  # }
2411
2398
  #
@@ -2440,7 +2427,7 @@ module Aws::AutoScaling
2440
2427
  # data as a hash:
2441
2428
  #
2442
2429
  # {
2443
- # auto_scaling_group_name: "ResourceName", # required
2430
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
2444
2431
  # target_group_arns: ["XmlStringMaxLen511"], # required
2445
2432
  # }
2446
2433
  #
@@ -2470,7 +2457,7 @@ module Aws::AutoScaling
2470
2457
  # data as a hash:
2471
2458
  #
2472
2459
  # {
2473
- # auto_scaling_group_name: "ResourceName", # required
2460
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
2474
2461
  # load_balancer_names: ["XmlStringMaxLen255"], # required
2475
2462
  # }
2476
2463
  #
@@ -2496,7 +2483,7 @@ module Aws::AutoScaling
2496
2483
  # data as a hash:
2497
2484
  #
2498
2485
  # {
2499
- # auto_scaling_group_name: "ResourceName", # required
2486
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
2500
2487
  # metrics: ["XmlStringMaxLen255"],
2501
2488
  # }
2502
2489
  #
@@ -2641,7 +2628,7 @@ module Aws::AutoScaling
2641
2628
  #
2642
2629
  # For more information, see [Using Encryption with EBS-Backed AMIs][3]
2643
2630
  # in the *Amazon EC2 User Guide for Linux Instances* and [Required CMK
2644
- # Key Policy for Use with Encrypted Volumes][4] in the *Amazon EC2
2631
+ # key policy for use with encrypted volumes][4] in the *Amazon EC2
2645
2632
  # Auto Scaling User Guide*.
2646
2633
  #
2647
2634
  #
@@ -2669,7 +2656,7 @@ module Aws::AutoScaling
2669
2656
  # data as a hash:
2670
2657
  #
2671
2658
  # {
2672
- # auto_scaling_group_name: "ResourceName", # required
2659
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
2673
2660
  # metrics: ["XmlStringMaxLen255"],
2674
2661
  # granularity: "XmlStringMaxLen255", # required
2675
2662
  # }
@@ -2791,7 +2778,7 @@ module Aws::AutoScaling
2791
2778
  #
2792
2779
  # {
2793
2780
  # instance_ids: ["XmlStringMaxLen19"],
2794
- # auto_scaling_group_name: "ResourceName", # required
2781
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
2795
2782
  # should_decrement_desired_capacity: false, # required
2796
2783
  # }
2797
2784
  #
@@ -2822,7 +2809,7 @@ module Aws::AutoScaling
2822
2809
  # data as a hash:
2823
2810
  #
2824
2811
  # {
2825
- # auto_scaling_group_name: "ResourceName",
2812
+ # auto_scaling_group_name: "XmlStringMaxLen255",
2826
2813
  # policy_name: "ResourceName", # required
2827
2814
  # honor_cooldown: false,
2828
2815
  # metric_value: 1.0,
@@ -2842,7 +2829,7 @@ module Aws::AutoScaling
2842
2829
  # period to complete before executing the policy.
2843
2830
  #
2844
2831
  # Valid only if the policy type is `SimpleScaling`. For more
2845
- # information, see [Scaling Cooldowns for Amazon EC2 Auto Scaling][1]
2832
+ # information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1]
2846
2833
  # in the *Amazon EC2 Auto Scaling User Guide*.
2847
2834
  #
2848
2835
  #
@@ -2900,7 +2887,7 @@ module Aws::AutoScaling
2900
2887
  #
2901
2888
  # {
2902
2889
  # instance_ids: ["XmlStringMaxLen19"],
2903
- # auto_scaling_group_name: "ResourceName", # required
2890
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
2904
2891
  # }
2905
2892
  #
2906
2893
  # @!attribute [rw] instance_ids
@@ -2948,8 +2935,8 @@ module Aws::AutoScaling
2948
2935
  # Describes a filter that is used to return a more specific list of
2949
2936
  # results when describing tags.
2950
2937
  #
2951
- # For more information, see [Tagging Auto Scaling Groups and
2952
- # Instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
2938
+ # For more information, see [Tagging Auto Scaling groups and
2939
+ # instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
2953
2940
  #
2954
2941
  #
2955
2942
  #
@@ -2997,7 +2984,12 @@ module Aws::AutoScaling
2997
2984
  #
2998
2985
  # @!attribute [rw] lifecycle_state
2999
2986
  # A description of the current lifecycle state. The `Quarantined`
3000
- # state is not used.
2987
+ # state is not used. For information about lifecycle states, see
2988
+ # [Instance lifecycle][1] in the *Amazon EC2 Auto Scaling User Guide*.
2989
+ #
2990
+ #
2991
+ #
2992
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/AutoScalingGroupLifecycle.html
3001
2993
  # @return [String]
3002
2994
  #
3003
2995
  # @!attribute [rw] health_status
@@ -3084,8 +3076,6 @@ module Aws::AutoScaling
3084
3076
  # requests can travel.
3085
3077
  #
3086
3078
  # Default: 1
3087
- #
3088
- # Possible values: Integers from 1 to 64
3089
3079
  # @return [Integer]
3090
3080
  #
3091
3081
  # @!attribute [rw] http_endpoint
@@ -3224,7 +3214,7 @@ module Aws::AutoScaling
3224
3214
  # The instances distribution specifies the distribution of On-Demand
3225
3215
  # Instances and Spot Instances, the maximum price to pay for Spot
3226
3216
  # Instances, and how the Auto Scaling group allocates instance types to
3227
- # fulfill On-Demand and Spot capacity.
3217
+ # fulfill On-Demand and Spot capacities.
3228
3218
  #
3229
3219
  # When you update `SpotAllocationStrategy`, `SpotInstancePools`, or
3230
3220
  # `SpotMaxPrice`, this update action does not deploy any changes across
@@ -3249,92 +3239,58 @@ module Aws::AutoScaling
3249
3239
  #
3250
3240
  # @!attribute [rw] on_demand_allocation_strategy
3251
3241
  # Indicates how to allocate instance types to fulfill On-Demand
3252
- # capacity.
3253
- #
3254
- # The only valid value is `prioritized`, which is also the default
3255
- # value. This strategy uses the order of instance type overrides for
3256
- # the LaunchTemplate to define the launch priority of each instance
3257
- # type. The first instance type in the array is prioritized higher
3258
- # than the last. If all your On-Demand capacity cannot be fulfilled
3259
- # using your highest priority instance, then the Auto Scaling groups
3260
- # launches the remaining capacity using the second priority instance
3261
- # type, and so on.
3242
+ # capacity. The only valid value is `prioritized`, which is also the
3243
+ # default value. This strategy uses the order of instance types in the
3244
+ # overrides to define the launch priority of each instance type. The
3245
+ # first instance type in the array is prioritized higher than the
3246
+ # last. If all your On-Demand capacity cannot be fulfilled using your
3247
+ # highest priority instance, then the Auto Scaling groups launches the
3248
+ # remaining capacity using the second priority instance type, and so
3249
+ # on.
3262
3250
  # @return [String]
3263
3251
  #
3264
3252
  # @!attribute [rw] on_demand_base_capacity
3265
3253
  # The minimum amount of the Auto Scaling group's capacity that must
3266
3254
  # be fulfilled by On-Demand Instances. This base portion is
3267
- # provisioned first as your group scales.
3268
- #
3269
- # Default if not set is 0. If you leave it set to 0, On-Demand
3270
- # Instances are launched as a percentage of the Auto Scaling group's
3271
- # desired capacity, per the `OnDemandPercentageAboveBaseCapacity`
3272
- # setting.
3273
- #
3274
- # <note markdown="1"> An update to this setting means a gradual replacement of instances
3275
- # to maintain the specified number of On-Demand Instances for your
3276
- # base capacity. When replacing instances, Amazon EC2 Auto Scaling
3277
- # launches new instances before terminating the old ones.
3278
- #
3279
- # </note>
3255
+ # provisioned first as your group scales. Defaults to 0 if not
3256
+ # specified. If you specify weights for the instance types in the
3257
+ # overrides, set the value of `OnDemandBaseCapacity` in terms of the
3258
+ # number of capacity units, and not the number of instances.
3280
3259
  # @return [Integer]
3281
3260
  #
3282
3261
  # @!attribute [rw] on_demand_percentage_above_base_capacity
3283
3262
  # Controls the percentages of On-Demand Instances and Spot Instances
3284
3263
  # for your additional capacity beyond `OnDemandBaseCapacity`.
3285
- #
3286
- # Default if not set is 100. If you leave it set to 100, the
3287
- # percentages are 100% for On-Demand Instances and 0% for Spot
3288
- # Instances.
3289
- #
3290
- # <note markdown="1"> An update to this setting means a gradual replacement of instances
3291
- # to maintain the percentage of On-Demand Instances for your
3292
- # additional capacity above the base capacity. When replacing
3293
- # instances, Amazon EC2 Auto Scaling launches new instances before
3294
- # terminating the old ones.
3295
- #
3296
- # </note>
3297
- #
3298
- # Valid Range: Minimum value of 0. Maximum value of 100.
3264
+ # Expressed as a number (for example, 20 specifies 20% On-Demand
3265
+ # Instances, 80% Spot Instances). Defaults to 100 if not specified. If
3266
+ # set to 100, only On-Demand Instances are provisioned.
3299
3267
  # @return [Integer]
3300
3268
  #
3301
3269
  # @!attribute [rw] spot_allocation_strategy
3302
- # Indicates how to allocate instances across Spot Instance pools.
3303
- #
3304
- # If the allocation strategy is `lowest-price`, the Auto Scaling group
3270
+ # Indicates how to allocate instances across Spot Instance pools. If
3271
+ # the allocation strategy is `capacity-optimized` (recommended), the
3272
+ # Auto Scaling group launches instances using Spot pools that are
3273
+ # optimally chosen based on the available Spot capacity. If the
3274
+ # allocation strategy is `lowest-price`, the Auto Scaling group
3305
3275
  # launches instances using the Spot pools with the lowest price, and
3306
3276
  # evenly allocates your instances across the number of Spot pools that
3307
- # you specify. If the allocation strategy is `capacity-optimized`, the
3308
- # Auto Scaling group launches instances using Spot pools that are
3309
- # optimally chosen based on the available Spot capacity.
3310
- #
3311
- # The default Spot allocation strategy for calls that you make through
3312
- # the API, the AWS CLI, or the AWS SDKs is `lowest-price`. The default
3313
- # Spot allocation strategy for the AWS Management Console is
3314
- # `capacity-optimized`.
3315
- #
3316
- # Valid values: `lowest-price` \| `capacity-optimized`
3277
+ # you specify. Defaults to `lowest-price` if not specified.
3317
3278
  # @return [String]
3318
3279
  #
3319
3280
  # @!attribute [rw] spot_instance_pools
3320
3281
  # The number of Spot Instance pools across which to allocate your Spot
3321
3282
  # Instances. The Spot pools are determined from the different instance
3322
- # types in the Overrides array of LaunchTemplate. Default if not set
3323
- # is 2.
3324
- #
3325
- # Used only when the Spot allocation strategy is `lowest-price`.
3326
- #
3327
- # Valid Range: Minimum value of 1. Maximum value of 20.
3283
+ # types in the overrides. Valid only when the Spot allocation strategy
3284
+ # is `lowest-price`. Value must be in the range of 1 to 20. Defaults
3285
+ # to 2 if not specified.
3328
3286
  # @return [Integer]
3329
3287
  #
3330
3288
  # @!attribute [rw] spot_max_price
3331
3289
  # The maximum price per unit hour that you are willing to pay for a
3332
- # Spot Instance. If you leave the value of this parameter blank (which
3333
- # is the default), the maximum Spot price is set at the On-Demand
3334
- # price.
3335
- #
3336
- # To remove a value that you previously set, include the parameter but
3337
- # leave the value blank.
3290
+ # Spot Instance. If you leave the value at its default (empty), Amazon
3291
+ # EC2 Auto Scaling uses the On-Demand price as the maximum Spot price.
3292
+ # To remove a value that you previously set, include the property but
3293
+ # specify an empty string ("") for the value.
3338
3294
  # @return [String]
3339
3295
  #
3340
3296
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/InstancesDistribution AWS API Documentation
@@ -3375,10 +3331,8 @@ module Aws::AutoScaling
3375
3331
  #
3376
3332
  # @!attribute [rw] image_id
3377
3333
  # The ID of the Amazon Machine Image (AMI) to use to launch your EC2
3378
- # instances.
3379
- #
3380
- # For more information, see [Finding an AMI][1] in the *Amazon EC2
3381
- # User Guide for Linux Instances*.
3334
+ # instances. For more information, see [Finding an AMI][1] in the
3335
+ # *Amazon EC2 User Guide for Linux Instances*.
3382
3336
  #
3383
3337
  #
3384
3338
  #
@@ -3398,10 +3352,9 @@ module Aws::AutoScaling
3398
3352
  #
3399
3353
  # @!attribute [rw] security_groups
3400
3354
  # A list that contains the security groups to assign to the instances
3401
- # in the Auto Scaling group.
3402
- #
3403
- # For more information, see [Security Groups for Your VPC][1] in the
3404
- # *Amazon Virtual Private Cloud User Guide*.
3355
+ # in the Auto Scaling group. For more information, see [Security
3356
+ # Groups for Your VPC][1] in the *Amazon Virtual Private Cloud User
3357
+ # Guide*.
3405
3358
  #
3406
3359
  #
3407
3360
  #
@@ -3410,11 +3363,9 @@ module Aws::AutoScaling
3410
3363
  #
3411
3364
  # @!attribute [rw] classic_link_vpc_id
3412
3365
  # The ID of a ClassicLink-enabled VPC to link your EC2-Classic
3413
- # instances to.
3414
- #
3415
- # For more information, see [ClassicLink][1] in the *Amazon EC2 User
3416
- # Guide for Linux Instances* and [Linking EC2-Classic Instances to a
3417
- # VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
3366
+ # instances to. For more information, see [ClassicLink][1] in the
3367
+ # *Amazon EC2 User Guide for Linux Instances* and [Linking EC2-Classic
3368
+ # instances to a VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
3418
3369
  #
3419
3370
  #
3420
3371
  #
@@ -3427,7 +3378,7 @@ module Aws::AutoScaling
3427
3378
  # `ClassicLinkVPCId`.
3428
3379
  #
3429
3380
  # For more information, see [ClassicLink][1] in the *Amazon EC2 User
3430
- # Guide for Linux Instances* and [Linking EC2-Classic Instances to a
3381
+ # Guide for Linux Instances* and [Linking EC2-Classic instances to a
3431
3382
  # VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
3432
3383
  #
3433
3384
  #
@@ -3437,15 +3388,17 @@ module Aws::AutoScaling
3437
3388
  # @return [Array<String>]
3438
3389
  #
3439
3390
  # @!attribute [rw] user_data
3440
- # The Base64-encoded user data to make available to the launched EC2
3441
- # instances.
3442
- #
3443
- # For more information, see [Instance Metadata and User Data][1] in
3444
- # the *Amazon EC2 User Guide for Linux Instances*.
3391
+ # The user data to make available to the launched EC2 instances. For
3392
+ # more information, see [Instance metadata and user data][1] (Linux)
3393
+ # and [Instance metadata and user data][2] (Windows). If you are using
3394
+ # a command line tool, base64-encoding is performed for you, and you
3395
+ # can load the text from a file. Otherwise, you must provide
3396
+ # base64-encoded text. User data is limited to 16 KB.
3445
3397
  #
3446
3398
  #
3447
3399
  #
3448
3400
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html
3401
+ # [2]: https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2-instance-metadata.html
3449
3402
  # @return [String]
3450
3403
  #
3451
3404
  # @!attribute [rw] instance_type
@@ -3453,7 +3406,7 @@ module Aws::AutoScaling
3453
3406
  #
3454
3407
  # For information about available instance types, see [Available
3455
3408
  # Instance Types][1] in the *Amazon EC2 User Guide for Linux
3456
- # Instances.*
3409
+ # Instances*.
3457
3410
  #
3458
3411
  #
3459
3412
  #
@@ -3470,10 +3423,8 @@ module Aws::AutoScaling
3470
3423
  #
3471
3424
  # @!attribute [rw] block_device_mappings
3472
3425
  # A block device mapping, which specifies the block devices for the
3473
- # instance.
3474
- #
3475
- # For more information, see [Block Device Mapping][1] in the *Amazon
3476
- # EC2 User Guide for Linux Instances*.
3426
+ # instance. For more information, see [Block Device Mapping][1] in the
3427
+ # *Amazon EC2 User Guide for Linux Instances*.
3477
3428
  #
3478
3429
  #
3479
3430
  #
@@ -3495,10 +3446,9 @@ module Aws::AutoScaling
3495
3446
  # @!attribute [rw] spot_price
3496
3447
  # The maximum hourly price to be paid for any Spot Instance launched
3497
3448
  # to fulfill the request. Spot Instances are launched when the price
3498
- # you specify exceeds the current Spot price.
3499
- #
3500
- # For more information, see [Launching Spot Instances in Your Auto
3501
- # Scaling Group][1] in the *Amazon EC2 Auto Scaling User Guide*.
3449
+ # you specify exceeds the current Spot price. For more information,
3450
+ # see [Requesting Spot Instances][1] in the *Amazon EC2 Auto Scaling
3451
+ # User Guide*.
3502
3452
  #
3503
3453
  #
3504
3454
  #
@@ -3508,11 +3458,9 @@ module Aws::AutoScaling
3508
3458
  # @!attribute [rw] iam_instance_profile
3509
3459
  # The name or the Amazon Resource Name (ARN) of the instance profile
3510
3460
  # associated with the IAM role for the instance. The instance profile
3511
- # contains the IAM role.
3512
- #
3513
- # For more information, see [IAM Role for Applications That Run on
3514
- # Amazon EC2 Instances][1] in the *Amazon EC2 Auto Scaling User
3515
- # Guide*.
3461
+ # contains the IAM role. For more information, see [IAM role for
3462
+ # applications that run on Amazon EC2 instances][1] in the *Amazon EC2
3463
+ # Auto Scaling User Guide*.
3516
3464
  #
3517
3465
  #
3518
3466
  #
@@ -3525,10 +3473,9 @@ module Aws::AutoScaling
3525
3473
  #
3526
3474
  # @!attribute [rw] ebs_optimized
3527
3475
  # Specifies whether the launch configuration is optimized for EBS I/O
3528
- # (`true`) or not (`false`).
3529
- #
3530
- # For more information, see [Amazon EBS-Optimized Instances][1] in the
3531
- # *Amazon EC2 User Guide for Linux Instances*.
3476
+ # (`true`) or not (`false`). For more information, see [Amazon
3477
+ # EBS-Optimized Instances][1] in the *Amazon EC2 User Guide for Linux
3478
+ # Instances*.
3532
3479
  #
3533
3480
  #
3534
3481
  #
@@ -3537,10 +3484,9 @@ module Aws::AutoScaling
3537
3484
  #
3538
3485
  # @!attribute [rw] associate_public_ip_address
3539
3486
  # For Auto Scaling groups that are running in a VPC, specifies whether
3540
- # to assign a public IP address to the group's instances.
3541
- #
3542
- # For more information, see [Launching Auto Scaling Instances in a
3543
- # VPC][1] in the *Amazon EC2 Auto Scaling User Guide*.
3487
+ # to assign a public IP address to the group's instances. For more
3488
+ # information, see [Launching Auto Scaling instances in a VPC][1] in
3489
+ # the *Amazon EC2 Auto Scaling User Guide*.
3544
3490
  #
3545
3491
  #
3546
3492
  #
@@ -3552,12 +3498,12 @@ module Aws::AutoScaling
3552
3498
  # instance with `dedicated` tenancy runs on isolated, single-tenant
3553
3499
  # hardware and can only be launched into a VPC.
3554
3500
  #
3555
- # For more information, see [Instance Placement Tenancy][1] in the
3556
- # *Amazon EC2 Auto Scaling User Guide*.
3501
+ # For more information, see [Configuring instance tenancy with Amazon
3502
+ # EC2 Auto Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
3557
3503
  #
3558
3504
  #
3559
3505
  #
3560
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-vpc-tenancy
3506
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-dedicated-instances.html
3561
3507
  # @return [String]
3562
3508
  #
3563
3509
  # @!attribute [rw] metadata_options
@@ -3601,7 +3547,7 @@ module Aws::AutoScaling
3601
3547
  # data as a hash:
3602
3548
  #
3603
3549
  # {
3604
- # launch_configuration_name: "ResourceName", # required
3550
+ # launch_configuration_name: "XmlStringMaxLen255", # required
3605
3551
  # }
3606
3552
  #
3607
3553
  # @!attribute [rw] launch_configuration_name
@@ -3620,7 +3566,7 @@ module Aws::AutoScaling
3620
3566
  # data as a hash:
3621
3567
  #
3622
3568
  # {
3623
- # launch_configuration_names: ["ResourceName"],
3569
+ # launch_configuration_names: ["XmlStringMaxLen255"],
3624
3570
  # next_token: "XmlString",
3625
3571
  # max_records: 1,
3626
3572
  # }
@@ -3673,9 +3619,7 @@ module Aws::AutoScaling
3673
3619
 
3674
3620
  # Describes a launch template and overrides.
3675
3621
  #
3676
- # The overrides are used to override the instance type specified by the
3677
- # launch template with multiple instance types that can be used to
3678
- # launch On-Demand Instances and Spot Instances.
3622
+ # You specify these parameters as part of a mixed instances policy.
3679
3623
  #
3680
3624
  # When you update the launch template or overrides, existing Amazon EC2
3681
3625
  # instances continue to run. When scale out occurs, Amazon EC2 Auto
@@ -3696,22 +3640,24 @@ module Aws::AutoScaling
3696
3640
  # {
3697
3641
  # instance_type: "XmlStringMaxLen255",
3698
3642
  # weighted_capacity: "XmlStringMaxLen32",
3643
+ # launch_template_specification: {
3644
+ # launch_template_id: "XmlStringMaxLen255",
3645
+ # launch_template_name: "LaunchTemplateName",
3646
+ # version: "XmlStringMaxLen255",
3647
+ # },
3699
3648
  # },
3700
3649
  # ],
3701
3650
  # }
3702
3651
  #
3703
3652
  # @!attribute [rw] launch_template_specification
3704
- # The launch template to use. You must specify either the launch
3705
- # template ID or launch template name in the request.
3653
+ # The launch template to use.
3706
3654
  # @return [Types::LaunchTemplateSpecification]
3707
3655
  #
3708
3656
  # @!attribute [rw] overrides
3709
3657
  # Any parameters that you specify override the same parameters in the
3710
- # launch template. Currently, the only supported override is instance
3711
- # type. You can specify between 1 and 20 instance types.
3712
- #
3713
- # If not provided, Amazon EC2 Auto Scaling will use the instance type
3714
- # specified in the launch template to launch instances.
3658
+ # launch template. If not provided, Amazon EC2 Auto Scaling uses the
3659
+ # instance type specified in the launch template when it launches an
3660
+ # instance.
3715
3661
  # @return [Array<Types::LaunchTemplateOverrides>]
3716
3662
  #
3717
3663
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/LaunchTemplate AWS API Documentation
@@ -3723,11 +3669,16 @@ module Aws::AutoScaling
3723
3669
  include Aws::Structure
3724
3670
  end
3725
3671
 
3726
- # Describes an override for a launch template. Currently, the only
3727
- # supported override is instance type.
3672
+ # Describes an override for a launch template. The maximum number of
3673
+ # instance types that can be associated with an Auto Scaling group is
3674
+ # 40. The maximum number of distinct launch templates you can define for
3675
+ # an Auto Scaling group is 20. For more information about configuring
3676
+ # overrides, see [Configuring overrides][1] in the *Amazon EC2 Auto
3677
+ # Scaling User Guide*.
3678
+ #
3728
3679
  #
3729
- # The maximum number of instance type overrides that can be associated
3730
- # with an Auto Scaling group is 20.
3680
+ #
3681
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-override-options.html
3731
3682
  #
3732
3683
  # @note When making an API call, you may pass LaunchTemplateOverrides
3733
3684
  # data as a hash:
@@ -3735,43 +3686,64 @@ module Aws::AutoScaling
3735
3686
  # {
3736
3687
  # instance_type: "XmlStringMaxLen255",
3737
3688
  # weighted_capacity: "XmlStringMaxLen32",
3689
+ # launch_template_specification: {
3690
+ # launch_template_id: "XmlStringMaxLen255",
3691
+ # launch_template_name: "LaunchTemplateName",
3692
+ # version: "XmlStringMaxLen255",
3693
+ # },
3738
3694
  # }
3739
3695
  #
3740
3696
  # @!attribute [rw] instance_type
3741
- # The instance type. You must use an instance type that is supported
3742
- # in your requested Region and Availability Zones.
3743
- #
3744
- # For information about available instance types, see [Available
3745
- # Instance Types][1] in the *Amazon Elastic Compute Cloud User Guide.*
3697
+ # The instance type, such as `m3.xlarge`. You must use an instance
3698
+ # type that is supported in your requested Region and Availability
3699
+ # Zones. For more information, see [Instance types][1] in the *Amazon
3700
+ # Elastic Compute Cloud User Guide*.
3746
3701
  #
3747
3702
  #
3748
3703
  #
3749
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#AvailableInstanceTypes
3704
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html
3750
3705
  # @return [String]
3751
3706
  #
3752
3707
  # @!attribute [rw] weighted_capacity
3753
- # The number of capacity units, which gives the instance type a
3754
- # proportional weight to other instance types. For example, larger
3755
- # instance types are generally weighted more than smaller instance
3756
- # types. These are the same units that you chose to set the desired
3757
- # capacity in terms of instances, or a performance attribute such as
3758
- # vCPUs, memory, or I/O.
3759
- #
3760
- # For more information, see [Instance Weighting for Amazon EC2 Auto
3761
- # Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
3762
- #
3763
- # Valid Range: Minimum value of 1. Maximum value of 999.
3708
+ # The number of capacity units provided by the specified instance type
3709
+ # in terms of virtual CPUs, memory, storage, throughput, or other
3710
+ # relative performance characteristic. When a Spot or On-Demand
3711
+ # Instance is provisioned, the capacity units count toward the desired
3712
+ # capacity. Amazon EC2 Auto Scaling provisions instances until the
3713
+ # desired capacity is totally fulfilled, even if this results in an
3714
+ # overage. For example, if there are 2 units remaining to fulfill
3715
+ # capacity, and Amazon EC2 Auto Scaling can only provision an instance
3716
+ # with a `WeightedCapacity` of 5 units, the instance is provisioned,
3717
+ # and the desired capacity is exceeded by 3 units. For more
3718
+ # information, see [Instance weighting for Amazon EC2 Auto Scaling][1]
3719
+ # in the *Amazon EC2 Auto Scaling User Guide*. Value must be in the
3720
+ # range of 1 to 999.
3764
3721
  #
3765
3722
  #
3766
3723
  #
3767
3724
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-weighting.html
3768
3725
  # @return [String]
3769
3726
  #
3727
+ # @!attribute [rw] launch_template_specification
3728
+ # Provides the launch template to be used when launching the instance
3729
+ # type. For example, some instance types might require a launch
3730
+ # template with a different AMI. If not provided, Amazon EC2 Auto
3731
+ # Scaling uses the launch template that's defined for your mixed
3732
+ # instances policy. For more information, see [Specifying a different
3733
+ # launch template for an instance type][1] in the *Amazon EC2 Auto
3734
+ # Scaling User Guide*.
3735
+ #
3736
+ #
3737
+ #
3738
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-launch-template-overrides.html
3739
+ # @return [Types::LaunchTemplateSpecification]
3740
+ #
3770
3741
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/LaunchTemplateOverrides AWS API Documentation
3771
3742
  #
3772
3743
  class LaunchTemplateOverrides < Struct.new(
3773
3744
  :instance_type,
3774
- :weighted_capacity)
3745
+ :weighted_capacity,
3746
+ :launch_template_specification)
3775
3747
  SENSITIVE = []
3776
3748
  include Aws::Structure
3777
3749
  end
@@ -3781,8 +3753,8 @@ module Aws::AutoScaling
3781
3753
  # EC2 instances.
3782
3754
  #
3783
3755
  # The launch template that is specified must be configured for use with
3784
- # an Auto Scaling group. For more information, see [Creating a Launch
3785
- # Template for an Auto Scaling Group][1] in the *Amazon EC2 Auto Scaling
3756
+ # an Auto Scaling group. For more information, see [Creating a launch
3757
+ # template for an Auto Scaling group][1] in the *Amazon EC2 Auto Scaling
3786
3758
  # User Guide*.
3787
3759
  #
3788
3760
  #
@@ -3804,7 +3776,8 @@ module Aws::AutoScaling
3804
3776
  # templates can be created using the Amazon EC2
3805
3777
  # [CreateLaunchTemplate][2] API.
3806
3778
  #
3807
- # You must specify either a template ID or a template name.
3779
+ # Conditional: You must specify either a `LaunchTemplateId` or a
3780
+ # `LaunchTemplateName`.
3808
3781
  #
3809
3782
  #
3810
3783
  #
@@ -3818,7 +3791,8 @@ module Aws::AutoScaling
3818
3791
  # templates can be created using the Amazon EC2
3819
3792
  # [CreateLaunchTemplate][2] API.
3820
3793
  #
3821
- # You must specify either a template ID or a template name.
3794
+ # Conditional: You must specify either a `LaunchTemplateId` or a
3795
+ # `LaunchTemplateName`.
3822
3796
  #
3823
3797
  #
3824
3798
  #
@@ -3830,13 +3804,12 @@ module Aws::AutoScaling
3830
3804
  # The version number, `$Latest`, or `$Default`. To get the version
3831
3805
  # number, use the Amazon EC2 [DescribeLaunchTemplateVersions][1] API
3832
3806
  # operation. New launch template versions can be created using the
3833
- # Amazon EC2 [CreateLaunchTemplateVersion][2] API.
3834
- #
3835
- # If the value is `$Latest`, Amazon EC2 Auto Scaling selects the
3836
- # latest version of the launch template when launching instances. If
3837
- # the value is `$Default`, Amazon EC2 Auto Scaling selects the default
3838
- # version of the launch template when launching instances. The default
3839
- # value is `$Default`.
3807
+ # Amazon EC2 [CreateLaunchTemplateVersion][2] API. If the value is
3808
+ # `$Latest`, Amazon EC2 Auto Scaling selects the latest version of the
3809
+ # launch template when launching instances. If the value is
3810
+ # `$Default`, Amazon EC2 Auto Scaling selects the default version of
3811
+ # the launch template when launching instances. The default value is
3812
+ # `$Default`.
3840
3813
  #
3841
3814
  #
3842
3815
  #
@@ -3956,7 +3929,7 @@ module Aws::AutoScaling
3956
3929
  # 5. If you finish before the timeout period ends, complete the
3957
3930
  # lifecycle action.
3958
3931
  #
3959
- # For more information, see [Amazon EC2 Auto Scaling Lifecycle Hooks][1]
3932
+ # For more information, see [Amazon EC2 Auto Scaling lifecycle hooks][1]
3960
3933
  # in the *Amazon EC2 Auto Scaling User Guide*.
3961
3934
  #
3962
3935
  #
@@ -3973,7 +3946,7 @@ module Aws::AutoScaling
3973
3946
  # heartbeat_timeout: 1,
3974
3947
  # default_result: "LifecycleActionResult",
3975
3948
  # notification_target_arn: "NotificationTargetResourceName",
3976
- # role_arn: "ResourceName",
3949
+ # role_arn: "XmlStringMaxLen255",
3977
3950
  # }
3978
3951
  #
3979
3952
  # @!attribute [rw] lifecycle_hook_name
@@ -4233,15 +4206,14 @@ module Aws::AutoScaling
4233
4206
  # Describes a mixed instances policy for an Auto Scaling group. With
4234
4207
  # mixed instances, your Auto Scaling group can provision a combination
4235
4208
  # of On-Demand Instances and Spot Instances across multiple instance
4236
- # types. For more information, see [Auto Scaling Groups with Multiple
4237
- # Instance Types and Purchase Options][1] in the *Amazon EC2 Auto
4209
+ # types. For more information, see [Auto Scaling groups with multiple
4210
+ # instance types and purchase options][1] in the *Amazon EC2 Auto
4238
4211
  # Scaling User Guide*.
4239
4212
  #
4240
4213
  # You can create a mixed instances policy for a new Auto Scaling group,
4241
4214
  # or you can create it for an existing group by updating the group to
4242
4215
  # specify `MixedInstancesPolicy` as the top-level parameter instead of a
4243
- # launch configuration or launch template. For more information, see
4244
- # CreateAutoScalingGroup and UpdateAutoScalingGroup.
4216
+ # launch configuration or launch template.
4245
4217
  #
4246
4218
  #
4247
4219
  #
@@ -4261,6 +4233,11 @@ module Aws::AutoScaling
4261
4233
  # {
4262
4234
  # instance_type: "XmlStringMaxLen255",
4263
4235
  # weighted_capacity: "XmlStringMaxLen32",
4236
+ # launch_template_specification: {
4237
+ # launch_template_id: "XmlStringMaxLen255",
4238
+ # launch_template_name: "LaunchTemplateName",
4239
+ # version: "XmlStringMaxLen255",
4240
+ # },
4264
4241
  # },
4265
4242
  # ],
4266
4243
  # },
@@ -4275,16 +4252,15 @@ module Aws::AutoScaling
4275
4252
  # }
4276
4253
  #
4277
4254
  # @!attribute [rw] launch_template
4278
- # The launch template and instance types (overrides).
4279
- #
4280
- # Required when creating a mixed instances policy.
4255
+ # Specifies the launch template to use and optionally the instance
4256
+ # types (overrides) that are used to provision EC2 instances to
4257
+ # fulfill On-Demand and Spot capacities. Required when creating a
4258
+ # mixed instances policy.
4281
4259
  # @return [Types::LaunchTemplate]
4282
4260
  #
4283
4261
  # @!attribute [rw] instances_distribution
4284
- # The instances distribution to use.
4285
- #
4286
- # If you leave this parameter unspecified, the value for each
4287
- # parameter in `InstancesDistribution` uses a default value.
4262
+ # Specifies the instances distribution. If not provided, the value for
4263
+ # each parameter in `InstancesDistribution` uses a default value.
4288
4264
  # @return [Types::InstancesDistribution]
4289
4265
  #
4290
4266
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/MixedInstancesPolicy AWS API Documentation
@@ -4441,7 +4417,7 @@ module Aws::AutoScaling
4441
4417
 
4442
4418
  # Describes a process type.
4443
4419
  #
4444
- # For more information, see [Scaling Processes][1] in the *Amazon EC2
4420
+ # For more information, see [Scaling processes][1] in the *Amazon EC2
4445
4421
  # Auto Scaling User Guide*.
4446
4422
  #
4447
4423
  #
@@ -4499,9 +4475,9 @@ module Aws::AutoScaling
4499
4475
  #
4500
4476
  # {
4501
4477
  # lifecycle_hook_name: "AsciiStringMaxLen255", # required
4502
- # auto_scaling_group_name: "ResourceName", # required
4478
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
4503
4479
  # lifecycle_transition: "LifecycleTransition",
4504
- # role_arn: "ResourceName",
4480
+ # role_arn: "XmlStringMaxLen255",
4505
4481
  # notification_target_arn: "NotificationTargetResourceName",
4506
4482
  # notification_metadata: "XmlStringMaxLen1023",
4507
4483
  # heartbeat_timeout: 1,
@@ -4597,8 +4573,8 @@ module Aws::AutoScaling
4597
4573
  # data as a hash:
4598
4574
  #
4599
4575
  # {
4600
- # auto_scaling_group_name: "ResourceName", # required
4601
- # topic_arn: "ResourceName", # required
4576
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
4577
+ # topic_arn: "XmlStringMaxLen255", # required
4602
4578
  # notification_types: ["XmlStringMaxLen255"], # required
4603
4579
  # }
4604
4580
  #
@@ -4631,7 +4607,7 @@ module Aws::AutoScaling
4631
4607
  # data as a hash:
4632
4608
  #
4633
4609
  # {
4634
- # auto_scaling_group_name: "ResourceName", # required
4610
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
4635
4611
  # policy_name: "XmlStringMaxLen255", # required
4636
4612
  # policy_type: "XmlStringMaxLen64",
4637
4613
  # adjustment_type: "XmlStringMaxLen255",
@@ -4695,7 +4671,7 @@ module Aws::AutoScaling
4695
4671
  # `ChangeInCapacity`, `ExactCapacity`, and `PercentChangeInCapacity`.
4696
4672
  #
4697
4673
  # Required if the policy type is `StepScaling` or `SimpleScaling`. For
4698
- # more information, see [Scaling Adjustment Types][1] in the *Amazon
4674
+ # more information, see [Scaling adjustment types][1] in the *Amazon
4699
4675
  # EC2 Auto Scaling User Guide*.
4700
4676
  #
4701
4677
  #
@@ -4718,7 +4694,7 @@ module Aws::AutoScaling
4718
4694
  # Amazon EC2 Auto Scaling scales out the group by 2 instances.
4719
4695
  #
4720
4696
  # Valid only if the policy type is `StepScaling` or `SimpleScaling`.
4721
- # For more information, see [Scaling Adjustment Types][1] in the
4697
+ # For more information, see [Scaling adjustment types][1] in the
4722
4698
  # *Amazon EC2 Auto Scaling User Guide*.
4723
4699
  #
4724
4700
  # <note markdown="1"> Some Auto Scaling groups use instance weights. In this case, set the
@@ -4748,7 +4724,7 @@ module Aws::AutoScaling
4748
4724
  # period defined for the Auto Scaling group.
4749
4725
  #
4750
4726
  # Valid only if the policy type is `SimpleScaling`. For more
4751
- # information, see [Scaling Cooldowns for Amazon EC2 Auto Scaling][1]
4727
+ # information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1]
4752
4728
  # in the *Amazon EC2 Auto Scaling User Guide*.
4753
4729
  #
4754
4730
  #
@@ -4812,8 +4788,8 @@ module Aws::AutoScaling
4812
4788
  #
4813
4789
  # @!attribute [rw] enabled
4814
4790
  # Indicates whether the scaling policy is enabled or disabled. The
4815
- # default is enabled. For more information, see [Disabling a Scaling
4816
- # Policy for an Auto Scaling Group][1] in the *Amazon EC2 Auto Scaling
4791
+ # default is enabled. For more information, see [Disabling a scaling
4792
+ # policy for an Auto Scaling group][1] in the *Amazon EC2 Auto Scaling
4817
4793
  # User Guide*.
4818
4794
  #
4819
4795
  #
@@ -4845,7 +4821,7 @@ module Aws::AutoScaling
4845
4821
  # data as a hash:
4846
4822
  #
4847
4823
  # {
4848
- # auto_scaling_group_name: "ResourceName", # required
4824
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
4849
4825
  # scheduled_action_name: "XmlStringMaxLen255", # required
4850
4826
  # time: Time.now,
4851
4827
  # start_time: Time.now,
@@ -5076,8 +5052,8 @@ module Aws::AutoScaling
5076
5052
  #
5077
5053
  # * `SimpleScaling` (default)
5078
5054
  #
5079
- # For more information, see [Target Tracking Scaling Policies][1] and
5080
- # [Step and Simple Scaling Policies][2] in the *Amazon EC2 Auto
5055
+ # For more information, see [Target tracking scaling policies][1] and
5056
+ # [Step and simple scaling policies][2] in the *Amazon EC2 Auto
5081
5057
  # Scaling User Guide*.
5082
5058
  #
5083
5059
  #
@@ -5166,7 +5142,7 @@ module Aws::AutoScaling
5166
5142
  # data as a hash:
5167
5143
  #
5168
5144
  # {
5169
- # auto_scaling_group_name: "ResourceName", # required
5145
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
5170
5146
  # scaling_processes: ["XmlStringMaxLen255"],
5171
5147
  # }
5172
5148
  #
@@ -5396,7 +5372,7 @@ module Aws::AutoScaling
5396
5372
  # data as a hash:
5397
5373
  #
5398
5374
  # {
5399
- # auto_scaling_group_name: "ResourceName", # required
5375
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
5400
5376
  # desired_capacity: 1, # required
5401
5377
  # honor_cooldown: false,
5402
5378
  # }
@@ -5483,12 +5459,12 @@ module Aws::AutoScaling
5483
5459
  #
5484
5460
  # {
5485
5461
  # instance_ids: ["XmlStringMaxLen19"], # required
5486
- # auto_scaling_group_name: "ResourceName", # required
5462
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
5487
5463
  # protected_from_scale_in: false, # required
5488
5464
  # }
5489
5465
  #
5490
5466
  # @!attribute [rw] instance_ids
5491
- # One or more instance IDs.
5467
+ # One or more instance IDs. You can specify up to 50 instances.
5492
5468
  # @return [Array<String>]
5493
5469
  #
5494
5470
  # @!attribute [rw] auto_scaling_group_name
@@ -5605,7 +5581,7 @@ module Aws::AutoScaling
5605
5581
  # * The upper and lower bound can't be null in the same step
5606
5582
  # adjustment.
5607
5583
  #
5608
- # For more information, see [Step Adjustments][1] in the *Amazon EC2
5584
+ # For more information, see [Step adjustments][1] in the *Amazon EC2
5609
5585
  # Auto Scaling User Guide*.
5610
5586
  #
5611
5587
  #
@@ -5657,9 +5633,9 @@ module Aws::AutoScaling
5657
5633
  include Aws::Structure
5658
5634
  end
5659
5635
 
5660
- # Describes an automatic scaling process that has been suspended.
5636
+ # Describes an auto scaling process that has been suspended.
5661
5637
  #
5662
- # For more information, see [Scaling Processes][1] in the *Amazon EC2
5638
+ # For more information, see [Scaling processes][1] in the *Amazon EC2
5663
5639
  # Auto Scaling User Guide*.
5664
5640
  #
5665
5641
  #
@@ -5877,8 +5853,8 @@ module Aws::AutoScaling
5877
5853
  # data as a hash:
5878
5854
  #
5879
5855
  # {
5880
- # auto_scaling_group_name: "ResourceName", # required
5881
- # launch_configuration_name: "ResourceName",
5856
+ # auto_scaling_group_name: "XmlStringMaxLen255", # required
5857
+ # launch_configuration_name: "XmlStringMaxLen255",
5882
5858
  # launch_template: {
5883
5859
  # launch_template_id: "XmlStringMaxLen255",
5884
5860
  # launch_template_name: "LaunchTemplateName",
@@ -5895,6 +5871,11 @@ module Aws::AutoScaling
5895
5871
  # {
5896
5872
  # instance_type: "XmlStringMaxLen255",
5897
5873
  # weighted_capacity: "XmlStringMaxLen32",
5874
+ # launch_template_specification: {
5875
+ # launch_template_id: "XmlStringMaxLen255",
5876
+ # launch_template_name: "LaunchTemplateName",
5877
+ # version: "XmlStringMaxLen255",
5878
+ # },
5898
5879
  # },
5899
5880
  # ],
5900
5881
  # },
@@ -5937,31 +5918,18 @@ module Aws::AutoScaling
5937
5918
  # The launch template and version to use to specify the updates. If
5938
5919
  # you specify `LaunchTemplate` in your update request, you can't
5939
5920
  # specify `LaunchConfigurationName` or `MixedInstancesPolicy`.
5940
- #
5941
- # For more information, see [LaunchTemplateSpecification][1] in the
5942
- # *Amazon EC2 Auto Scaling API Reference*.
5943
- #
5944
- #
5945
- #
5946
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_LaunchTemplateSpecification.html
5947
5921
  # @return [Types::LaunchTemplateSpecification]
5948
5922
  #
5949
5923
  # @!attribute [rw] mixed_instances_policy
5950
- # An embedded object that specifies a mixed instances policy.
5951
- #
5952
- # In your call to `UpdateAutoScalingGroup`, you can make changes to
5953
- # the policy that is specified. All optional parameters are left
5954
- # unchanged if not specified.
5955
- #
5956
- # For more information, see [MixedInstancesPolicy][1] in the *Amazon
5957
- # EC2 Auto Scaling API Reference* and [Auto Scaling Groups with
5958
- # Multiple Instance Types and Purchase Options][2] in the *Amazon EC2
5959
- # Auto Scaling User Guide*.
5924
+ # An embedded object that specifies a mixed instances policy. When you
5925
+ # make changes to an existing policy, all optional parameters are left
5926
+ # unchanged if not specified. For more information, see [Auto Scaling
5927
+ # groups with multiple instance types and purchase options][1] in the
5928
+ # *Amazon EC2 Auto Scaling User Guide*.
5960
5929
  #
5961
5930
  #
5962
5931
  #
5963
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_MixedInstancesPolicy.html
5964
- # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
5932
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
5965
5933
  # @return [Types::MixedInstancesPolicy]
5966
5934
  #
5967
5935
  # @!attribute [rw] min_size
@@ -5984,20 +5952,17 @@ module Aws::AutoScaling
5984
5952
  # @!attribute [rw] desired_capacity
5985
5953
  # The desired capacity is the initial capacity of the Auto Scaling
5986
5954
  # group after this operation completes and the capacity it attempts to
5987
- # maintain.
5988
- #
5989
- # This number must be greater than or equal to the minimum size of the
5990
- # group and less than or equal to the maximum size of the group.
5955
+ # maintain. This number must be greater than or equal to the minimum
5956
+ # size of the group and less than or equal to the maximum size of the
5957
+ # group.
5991
5958
  # @return [Integer]
5992
5959
  #
5993
5960
  # @!attribute [rw] default_cooldown
5994
5961
  # The amount of time, in seconds, after a scaling activity completes
5995
5962
  # before another scaling activity can start. The default value is
5996
- # `300`.
5997
- #
5998
- # This setting applies when using simple scaling policies, but not
5999
- # when using other scaling policies or scheduled scaling. For more
6000
- # information, see [Scaling Cooldowns for Amazon EC2 Auto Scaling][1]
5963
+ # `300`. This setting applies when using simple scaling policies, but
5964
+ # not when using other scaling policies or scheduled scaling. For more
5965
+ # information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1]
6001
5966
  # in the *Amazon EC2 Auto Scaling User Guide*.
6002
5967
  #
6003
5968
  #
@@ -6019,12 +5984,11 @@ module Aws::AutoScaling
6019
5984
  # @!attribute [rw] health_check_grace_period
6020
5985
  # The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
6021
5986
  # before checking the health status of an EC2 instance that has come
6022
- # into service. The default value is `0`.
6023
- #
6024
- # For more information, see [Health Check Grace Period][1] in the
6025
- # *Amazon EC2 Auto Scaling User Guide*.
5987
+ # into service. The default value is `0`. For more information, see
5988
+ # [Health check grace period][1] in the *Amazon EC2 Auto Scaling User
5989
+ # Guide*.
6026
5990
  #
6027
- # Required if you are adding an `ELB` health check.
5991
+ # Conditional: Required if you are adding an `ELB` health check.
6028
5992
  #
6029
5993
  #
6030
5994
  #
@@ -6032,11 +5996,12 @@ module Aws::AutoScaling
6032
5996
  # @return [Integer]
6033
5997
  #
6034
5998
  # @!attribute [rw] placement_group
6035
- # The name of the placement group into which to launch your instances,
6036
- # if any. A placement group is a logical grouping of instances within
6037
- # a single Availability Zone. You cannot specify multiple Availability
6038
- # Zones and a placement group. For more information, see [Placement
6039
- # Groups][1] in the *Amazon EC2 User Guide for Linux Instances*.
5999
+ # The name of an existing placement group into which to launch your
6000
+ # instances, if any. A placement group is a logical grouping of
6001
+ # instances within a single Availability Zone. You cannot specify
6002
+ # multiple Availability Zones and a placement group. For more
6003
+ # information, see [Placement Groups][1] in the *Amazon EC2 User Guide
6004
+ # for Linux Instances*.
6040
6005
  #
6041
6006
  #
6042
6007
  #
@@ -6044,22 +6009,18 @@ module Aws::AutoScaling
6044
6009
  # @return [String]
6045
6010
  #
6046
6011
  # @!attribute [rw] vpc_zone_identifier
6047
- # A comma-separated list of subnet IDs for virtual private cloud
6048
- # (VPC).
6049
- #
6050
- # If you specify `VPCZoneIdentifier` with `AvailabilityZones`, the
6051
- # subnets that you specify for this parameter must reside in those
6012
+ # A comma-separated list of subnet IDs for a virtual private cloud
6013
+ # (VPC). If you specify `VPCZoneIdentifier` with `AvailabilityZones`,
6014
+ # the subnets that you specify for this parameter must reside in those
6052
6015
  # Availability Zones.
6053
6016
  # @return [String]
6054
6017
  #
6055
6018
  # @!attribute [rw] termination_policies
6056
- # A standalone termination policy or a list of termination policies
6057
- # used to select the instance to terminate. The policies are executed
6058
- # in the order that they are listed.
6059
- #
6060
- # For more information, see [Controlling Which Instances Auto Scaling
6061
- # Terminates During Scale In][1] in the *Amazon EC2 Auto Scaling User
6062
- # Guide*.
6019
+ # A policy or a list of policies that are used to select the instances
6020
+ # to terminate. The policies are executed in the order that you list
6021
+ # them. For more information, see [Controlling which Auto Scaling
6022
+ # instances terminate during scale in][1] in the *Amazon EC2 Auto
6023
+ # Scaling User Guide*.
6063
6024
  #
6064
6025
  #
6065
6026
  #
@@ -6068,10 +6029,9 @@ module Aws::AutoScaling
6068
6029
  #
6069
6030
  # @!attribute [rw] new_instances_protected_from_scale_in
6070
6031
  # Indicates whether newly launched instances are protected from
6071
- # termination by Amazon EC2 Auto Scaling when scaling in.
6072
- #
6073
- # For more information about preventing instances from terminating on
6074
- # scale in, see [Instance Protection][1] in the *Amazon EC2 Auto
6032
+ # termination by Amazon EC2 Auto Scaling when scaling in. For more
6033
+ # information about preventing instances from terminating on scale in,
6034
+ # see [Instance scale-in protection][1] in the *Amazon EC2 Auto
6075
6035
  # Scaling User Guide*.
6076
6036
  #
6077
6037
  #
@@ -6082,7 +6042,7 @@ module Aws::AutoScaling
6082
6042
  # @!attribute [rw] service_linked_role_arn
6083
6043
  # The Amazon Resource Name (ARN) of the service-linked role that the
6084
6044
  # Auto Scaling group uses to call other AWS services on your behalf.
6085
- # For more information, see [Service-Linked Roles][1] in the *Amazon
6045
+ # For more information, see [Service-linked roles][1] in the *Amazon
6086
6046
  # EC2 Auto Scaling User Guide*.
6087
6047
  #
6088
6048
  #
@@ -6092,17 +6052,11 @@ module Aws::AutoScaling
6092
6052
  #
6093
6053
  # @!attribute [rw] max_instance_lifetime
6094
6054
  # The maximum amount of time, in seconds, that an instance can be in
6095
- # service. The default is null.
6096
- #
6097
- # This parameter is optional, but if you specify a value for it, you
6098
- # must specify a value of at least 604,800 seconds (7 days). To clear
6099
- # a previously set value, specify a new value of 0.
6100
- #
6101
- # For more information, see [Replacing Auto Scaling Instances Based on
6102
- # Maximum Instance Lifetime][1] in the *Amazon EC2 Auto Scaling User
6103
- # Guide*.
6104
- #
6105
- # Valid Range: Minimum value of 0.
6055
+ # service. The default is null. If specified, the value must be either
6056
+ # 0 or a number equal to or greater than 86,400 seconds (1 day). To
6057
+ # clear a previously set value, specify a new value of 0. For more
6058
+ # information, see [Replacing Auto Scaling instances based on maximum
6059
+ # instance lifetime][1] in the *Amazon EC2 Auto Scaling User Guide*.
6106
6060
  #
6107
6061
  #
6108
6062
  #
@@ -6110,16 +6064,9 @@ module Aws::AutoScaling
6110
6064
  # @return [Integer]
6111
6065
  #
6112
6066
  # @!attribute [rw] capacity_rebalance
6113
- # Enables or disables capacity rebalance.
6114
- #
6115
- # You can enable capacity rebalancing for your Auto Scaling groups
6116
- # when using Spot Instances. When you turn on capacity rebalancing,
6117
- # Amazon EC2 Auto Scaling attempts to launch a Spot Instance whenever
6118
- # Amazon EC2 predicts that a Spot Instance is at an elevated risk of
6119
- # interruption. After launching a new instance, it then terminates an
6120
- # old instance. For more information, see [Amazon EC2 Auto Scaling
6121
- # capacity rebalancing][1] in the *Amazon EC2 Auto Scaling User
6122
- # Guide*.
6067
+ # Enables or disables Capacity Rebalancing. For more information, see
6068
+ # [Amazon EC2 Auto Scaling Capacity Rebalancing][1] in the *Amazon EC2
6069
+ # Auto Scaling User Guide*.
6123
6070
  #
6124
6071
  #
6125
6072
  #