aws-sdk-autoscaling 1.27.0 → 1.28.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -43,7 +43,7 @@ module Aws::AutoScaling
43
43
  data[:scheduled_action_arn]
44
44
  end
45
45
 
46
- # This parameter is deprecated.
46
+ # This parameter is no longer used.
47
47
  # @return [Time]
48
48
  def time
49
49
  data[:time]
@@ -769,24 +769,16 @@ module Aws::AutoScaling
769
769
  # @!attribute [rw] launch_configuration_name
770
770
  # The name of the launch configuration.
771
771
  #
772
- # For more information, see [Creating an Auto Scaling Group Using a
773
- # Launch Configuration][1] in the *Amazon EC2 Auto Scaling User
774
- # Guide*.
775
- #
776
772
  # If you do not specify `LaunchConfigurationName`, you must specify
777
773
  # one of the following parameters: `InstanceId`, `LaunchTemplate`, or
778
774
  # `MixedInstancesPolicy`.
779
- #
780
- #
781
- #
782
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg.html
783
775
  # @return [String]
784
776
  #
785
777
  # @!attribute [rw] launch_template
786
778
  # The launch template to use to launch instances.
787
779
  #
788
- # For more information, see [Creating an Auto Scaling Group Using a
789
- # Launch Template][1] in the *Amazon EC2 Auto Scaling User Guide*.
780
+ # For more information, see [LaunchTemplateSpecification][1] in the
781
+ # *Amazon EC2 Auto Scaling API Reference*.
790
782
  #
791
783
  # If you do not specify `LaunchTemplate`, you must specify one of the
792
784
  # following parameters: `InstanceId`, `LaunchConfigurationName`, or
@@ -794,7 +786,7 @@ module Aws::AutoScaling
794
786
  #
795
787
  #
796
788
  #
797
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-launch-template.html
789
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_LaunchTemplateSpecification.html
798
790
  # @return [Types::LaunchTemplateSpecification]
799
791
  #
800
792
  # @!attribute [rw] mixed_instances_policy
@@ -804,14 +796,15 @@ module Aws::AutoScaling
804
796
  #
805
797
  # The policy includes parameters that not only define the distribution
806
798
  # of On-Demand Instances and Spot Instances, the maximum price to pay
807
- # for Spot instances, and how the Auto Scaling group allocates
799
+ # for Spot Instances, and how the Auto Scaling group allocates
808
800
  # instance types to fulfill On-Demand and Spot capacity, but also the
809
801
  # parameters that specify the instance configuration information—the
810
802
  # launch template and instance types.
811
803
  #
812
- # For more information, see [Auto Scaling Groups with Multiple
813
- # Instance Types and Purchase Options][1] in the *Amazon EC2 Auto
814
- # Scaling User Guide*.
804
+ # For more information, see [MixedInstancesPolicy][1] in the *Amazon
805
+ # EC2 Auto Scaling API Reference* and [Auto Scaling Groups with
806
+ # Multiple Instance Types and Purchase Options][2] in the *Amazon EC2
807
+ # Auto Scaling User Guide*.
815
808
  #
816
809
  # You must specify one of the following parameters in your request:
817
810
  # `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
@@ -819,7 +812,8 @@ module Aws::AutoScaling
819
812
  #
820
813
  #
821
814
  #
822
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
815
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_MixedInstancesPolicy.html
816
+ # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
823
817
  # @return [Types::MixedInstancesPolicy]
824
818
  #
825
819
  # @!attribute [rw] instance_id
@@ -928,15 +922,15 @@ module Aws::AutoScaling
928
922
  # into service. During this time, any health check failures for the
929
923
  # instance are ignored. The default value is `0`.
930
924
  #
931
- # For more information, see [Health Checks for Auto Scaling
932
- # Instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
925
+ # For more information, see [Health Check Grace Period][1] in the
926
+ # *Amazon EC2 Auto Scaling User Guide*.
933
927
  #
934
928
  # Conditional: This parameter is required if you are adding an `ELB`
935
929
  # health check.
936
930
  #
937
931
  #
938
932
  #
939
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html
933
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html#health-check-grace-period
940
934
  # @return [Integer]
941
935
  #
942
936
  # @!attribute [rw] placement_group
@@ -1091,14 +1085,12 @@ module Aws::AutoScaling
1091
1085
  # @return [String]
1092
1086
  #
1093
1087
  # @!attribute [rw] image_id
1094
- # The ID of the Amazon Machine Image (AMI) to use to launch your EC2
1095
- # instances.
1088
+ # The ID of the Amazon Machine Image (AMI) that was assigned during
1089
+ # registration. For more information, see [Finding an AMI][1] in the
1090
+ # *Amazon EC2 User Guide for Linux Instances*.
1096
1091
  #
1097
1092
  # If you do not specify `InstanceId`, you must specify `ImageId`.
1098
1093
  #
1099
- # For more information, see [Finding an AMI][1] in the *Amazon EC2
1100
- # User Guide for Linux Instances*.
1101
- #
1102
1094
  #
1103
1095
  #
1104
1096
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html
@@ -1114,30 +1106,31 @@ module Aws::AutoScaling
1114
1106
  # @return [String]
1115
1107
  #
1116
1108
  # @!attribute [rw] security_groups
1117
- # One or more security groups with which to associate the instances.
1109
+ # A list that contains the security groups to assign to the instances
1110
+ # in the Auto Scaling group.
1118
1111
  #
1119
- # If your instances are launched in EC2-Classic, you can either
1120
- # specify security group names or the security group IDs. For more
1121
- # information, see [Amazon EC2 Security Groups][1] in the *Amazon EC2
1122
- # User Guide for Linux Instances*.
1112
+ # \[EC2-VPC\] Specify the security group IDs. For more information,
1113
+ # see [Security Groups for Your VPC][1] in the *Amazon Virtual Private
1114
+ # Cloud User Guide*.
1123
1115
  #
1124
- # If your instances are launched into a VPC, specify security group
1125
- # IDs. For more information, see [Security Groups for Your VPC][2] in
1126
- # the *Amazon Virtual Private Cloud User Guide*.
1116
+ # \[EC2-Classic\] Specify either the security group names or the
1117
+ # security group IDs. For more information, see [Amazon EC2 Security
1118
+ # Groups][2] in the *Amazon EC2 User Guide for Linux Instances*.
1127
1119
  #
1128
1120
  #
1129
1121
  #
1130
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-network-security.html
1131
- # [2]: https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_SecurityGroups.html
1122
+ # [1]: https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_SecurityGroups.html
1123
+ # [2]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-network-security.html
1132
1124
  # @return [Array<String>]
1133
1125
  #
1134
1126
  # @!attribute [rw] classic_link_vpc_id
1135
1127
  # The ID of a ClassicLink-enabled VPC to link your EC2-Classic
1136
- # instances to. This parameter is supported only if you are launching
1137
- # EC2-Classic instances. For more information, see [ClassicLink][1] in
1138
- # the *Amazon EC2 User Guide for Linux Instances* and [Linking
1139
- # EC2-Classic Instances to a VPC][2] in the *Amazon EC2 Auto Scaling
1140
- # User Guide*.
1128
+ # instances to. For more information, see [ClassicLink][1] in the
1129
+ # *Amazon EC2 User Guide for Linux Instances* and [Linking EC2-Classic
1130
+ # Instances to a VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
1131
+ #
1132
+ # This parameter can only be used if you are launching EC2-Classic
1133
+ # instances.
1141
1134
  #
1142
1135
  #
1143
1136
  #
@@ -1152,8 +1145,8 @@ module Aws::AutoScaling
1152
1145
  # EC2-Classic Instances to a VPC][2] in the *Amazon EC2 Auto Scaling
1153
1146
  # User Guide*.
1154
1147
  #
1155
- # Conditional: This parameter is required if you specify a
1156
- # ClassicLink-enabled VPC, and is not supported otherwise.
1148
+ # If you specify the `ClassicLinkVPCId` parameter, you must specify
1149
+ # this parameter.
1157
1150
  #
1158
1151
  #
1159
1152
  #
@@ -1162,9 +1155,9 @@ module Aws::AutoScaling
1162
1155
  # @return [Array<String>]
1163
1156
  #
1164
1157
  # @!attribute [rw] user_data
1165
- # The user data to make available to the launched EC2 instances. For
1166
- # more information, see [Instance Metadata and User Data][1] in the
1167
- # *Amazon EC2 User Guide for Linux Instances*.
1158
+ # The Base64-encoded user data to make available to the launched EC2
1159
+ # instances. For more information, see [Instance Metadata and User
1160
+ # Data][1] in the *Amazon EC2 User Guide for Linux Instances*.
1168
1161
  #
1169
1162
  #
1170
1163
  #
@@ -1192,7 +1185,7 @@ module Aws::AutoScaling
1192
1185
  # @return [String]
1193
1186
  #
1194
1187
  # @!attribute [rw] instance_type
1195
- # The instance type of the EC2 instance.
1188
+ # Specifies the instance type of the EC2 instance.
1196
1189
  #
1197
1190
  # For information about available instance types, see [Available
1198
1191
  # Instance Types][1] in the *Amazon EC2 User Guide for Linux
@@ -1210,13 +1203,14 @@ module Aws::AutoScaling
1210
1203
  # @return [String]
1211
1204
  #
1212
1205
  # @!attribute [rw] ramdisk_id
1213
- # The ID of the RAM disk associated with the AMI.
1206
+ # The ID of the RAM disk to select.
1214
1207
  # @return [String]
1215
1208
  #
1216
1209
  # @!attribute [rw] block_device_mappings
1217
- # One or more mappings that specify how block devices are exposed to
1218
- # the instance. For more information, see [Block Device Mapping][1] in
1219
- # the *Amazon EC2 User Guide for Linux Instances*.
1210
+ # A block device mapping, which specifies the block devices for the
1211
+ # instance. You can specify virtual devices and EBS volumes. For more
1212
+ # information, see [Block Device Mapping][1] in the *Amazon EC2 User
1213
+ # Guide for Linux Instances*.
1220
1214
  #
1221
1215
  #
1222
1216
  #
@@ -1224,8 +1218,20 @@ module Aws::AutoScaling
1224
1218
  # @return [Array<Types::BlockDeviceMapping>]
1225
1219
  #
1226
1220
  # @!attribute [rw] instance_monitoring
1227
- # Enables detailed monitoring (`true`) or basic monitoring (`false`)
1228
- # for the Auto Scaling instances. The default value is `true`.
1221
+ # Controls whether instances in this group are launched with detailed
1222
+ # (`true`) or basic (`false`) monitoring.
1223
+ #
1224
+ # The default value is `true` (enabled).
1225
+ #
1226
+ # When detailed monitoring is enabled, Amazon CloudWatch generates
1227
+ # metrics every minute and your account is charged a fee. When you
1228
+ # disable detailed monitoring, CloudWatch generates metrics every 5
1229
+ # minutes. For more information, see [Configure Monitoring for Auto
1230
+ # Scaling Instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
1231
+ #
1232
+ #
1233
+ #
1234
+ # [1]: https://docs.aws.amazon.com/autoscaling/latest/userguide/as-instance-monitoring.html#enable-as-instance-metrics
1229
1235
  # @return [Types::InstanceMonitoring]
1230
1236
  #
1231
1237
  # @!attribute [rw] spot_price
@@ -1235,6 +1241,17 @@ module Aws::AutoScaling
1235
1241
  # information, see [Launching Spot Instances in Your Auto Scaling
1236
1242
  # Group][1] in the *Amazon EC2 Auto Scaling User Guide*.
1237
1243
  #
1244
+ # If a Spot price is set, then the Auto Scaling group will only launch
1245
+ # instances when the Spot price has been met, regardless of the
1246
+ # setting in the Auto Scaling group's `DesiredCapacity`.
1247
+ #
1248
+ # <note markdown="1"> When you change your Spot price by creating a new launch
1249
+ # configuration, running instances will continue to run as long as the
1250
+ # Spot price for those running instances is higher than the current
1251
+ # Spot market price.
1252
+ #
1253
+ # </note>
1254
+ #
1238
1255
  #
1239
1256
  #
1240
1257
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-launch-spot-instances.html
@@ -1242,14 +1259,12 @@ module Aws::AutoScaling
1242
1259
  #
1243
1260
  # @!attribute [rw] iam_instance_profile
1244
1261
  # The name or the Amazon Resource Name (ARN) of the instance profile
1245
- # associated with the IAM role for the instance.
1262
+ # associated with the IAM role for the instance. The instance profile
1263
+ # contains the IAM role.
1246
1264
  #
1247
- # EC2 instances launched with an IAM role automatically have AWS
1248
- # security credentials available. You can use IAM roles with Amazon
1249
- # EC2 Auto Scaling to automatically enable applications running on
1250
- # your EC2 instances to securely access other AWS resources. For more
1251
- # information, see [IAM Role for Applications That Run on Amazon EC2
1252
- # Instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
1265
+ # For more information, see [IAM Role for Applications That Run on
1266
+ # Amazon EC2 Instances][1] in the *Amazon EC2 Auto Scaling User
1267
+ # Guide*.
1253
1268
  #
1254
1269
  #
1255
1270
  #
@@ -1257,13 +1272,17 @@ module Aws::AutoScaling
1257
1272
  # @return [String]
1258
1273
  #
1259
1274
  # @!attribute [rw] ebs_optimized
1260
- # Indicates whether the instance is optimized for Amazon EBS I/O. By
1261
- # default, the instance is not optimized for EBS I/O. The optimization
1262
- # provides dedicated throughput to Amazon EBS and an optimized
1263
- # configuration stack to provide optimal I/O performance. This
1264
- # optimization is not available with all instance types. Additional
1265
- # usage charges apply. For more information, see [Amazon EBS-Optimized
1266
- # Instances][1] in the *Amazon EC2 User Guide for Linux Instances*.
1275
+ # Specifies whether the launch configuration is optimized for EBS I/O
1276
+ # (`true`) or not (`false`). The optimization provides dedicated
1277
+ # throughput to Amazon EBS and an optimized configuration stack to
1278
+ # provide optimal I/O performance. This optimization is not available
1279
+ # with all instance types. Additional fees are incurred when you
1280
+ # enable EBS optimization for an instance type that is not
1281
+ # EBS-optimized by default. For more information, see [Amazon
1282
+ # EBS-Optimized Instances][1] in the *Amazon EC2 User Guide for Linux
1283
+ # Instances*.
1284
+ #
1285
+ # The default value is `false`.
1267
1286
  #
1268
1287
  #
1269
1288
  #
@@ -1271,18 +1290,24 @@ module Aws::AutoScaling
1271
1290
  # @return [Boolean]
1272
1291
  #
1273
1292
  # @!attribute [rw] associate_public_ip_address
1274
- # Used for groups that launch instances into a virtual private cloud
1275
- # (VPC). Specifies whether to assign a public IP address to each
1276
- # instance. For more information, see [Launching Auto Scaling
1277
- # Instances in a VPC][1] in the *Amazon EC2 Auto Scaling User Guide*.
1293
+ # For Auto Scaling groups that are running in a virtual private cloud
1294
+ # (VPC), specifies whether to assign a public IP address to the
1295
+ # group's instances. If you specify `true`, each instance in the Auto
1296
+ # Scaling group receives a unique public IP address. For more
1297
+ # information, see [Launching Auto Scaling Instances in a VPC][1] in
1298
+ # the *Amazon EC2 Auto Scaling User Guide*.
1299
+ #
1300
+ # If you specify this parameter, you must specify at least one subnet
1301
+ # for `VPCZoneIdentifier` when you create your group.
1302
+ #
1303
+ # <note markdown="1"> If the instance is launched into a default subnet, the default is to
1304
+ # assign a public IP address, unless you disabled the option to assign
1305
+ # a public IP address on the subnet. If the instance is launched into
1306
+ # a nondefault subnet, the default is not to assign a public IP
1307
+ # address, unless you enabled the option to assign a public IP address
1308
+ # on the subnet.
1278
1309
  #
1279
- # If you specify this parameter, be sure to specify at least one
1280
- # subnet when you create your group.
1281
- #
1282
- # Default: If the instance is launched into a default subnet, the
1283
- # default is to assign a public IP address. If the instance is
1284
- # launched into a nondefault subnet, the default is not to assign a
1285
- # public IP address.
1310
+ # </note>
1286
1311
  #
1287
1312
  #
1288
1313
  #
@@ -1290,16 +1315,16 @@ module Aws::AutoScaling
1290
1315
  # @return [Boolean]
1291
1316
  #
1292
1317
  # @!attribute [rw] placement_tenancy
1293
- # The tenancy of the instance. An instance with a tenancy of
1294
- # `dedicated` runs on single-tenant hardware and can only be launched
1318
+ # The tenancy of the instance. An instance with `dedicated` tenancy
1319
+ # runs on isolated, single-tenant hardware and can only be launched
1295
1320
  # into a VPC.
1296
1321
  #
1297
- # To launch Dedicated Instances into a shared tenancy VPC (a VPC with
1322
+ # To launch dedicated instances into a shared tenancy VPC (a VPC with
1298
1323
  # the instance placement tenancy attribute set to `default`), you must
1299
1324
  # set the value of this parameter to `dedicated`.
1300
1325
  #
1301
- # If you specify `PlacementTenancy`, be sure to specify at least one
1302
- # subnet when you create your group.
1326
+ # If you specify `PlacementTenancy`, you must specify at least one
1327
+ # subnet for `VPCZoneIdentifier` when you create your group.
1303
1328
  #
1304
1329
  # For more information, see [Instance Placement Tenancy][1] in the
1305
1330
  # *Amazon EC2 Auto Scaling User Guide*.
@@ -1591,12 +1616,12 @@ module Aws::AutoScaling
1591
1616
 
1592
1617
  # @!attribute [rw] max_number_of_auto_scaling_groups
1593
1618
  # The maximum number of groups allowed for your AWS account. The
1594
- # default limit is 200 per region.
1619
+ # default limit is 200 per AWS Region.
1595
1620
  # @return [Integer]
1596
1621
  #
1597
1622
  # @!attribute [rw] max_number_of_launch_configurations
1598
1623
  # The maximum number of launch configurations allowed for your AWS
1599
- # account. The default limit is 200 per region.
1624
+ # account. The default limit is 200 per AWS Region.
1600
1625
  # @return [Integer]
1601
1626
  #
1602
1627
  # @!attribute [rw] number_of_auto_scaling_groups
@@ -2757,20 +2782,30 @@ module Aws::AutoScaling
2757
2782
  # @return [Integer]
2758
2783
  #
2759
2784
  # @!attribute [rw] spot_allocation_strategy
2760
- # Indicates how to allocate Spot capacity across Spot pools.
2785
+ # Indicates how to allocate instances across Spot Instance pools.
2786
+ #
2787
+ # If the allocation strategy is `lowest-price`, the Auto Scaling group
2788
+ # launches instances using the Spot pools with the lowest price, and
2789
+ # evenly allocates your instances across the number of Spot pools that
2790
+ # you specify. If the allocation strategy is `capacity-optimized`, the
2791
+ # Auto Scaling group launches instances using Spot pools that are
2792
+ # optimally chosen based on the available Spot capacity.
2761
2793
  #
2762
- # The only valid value is `lowest-price`, which is also the default
2763
- # value. The Auto Scaling group selects the cheapest Spot pools and
2764
- # evenly allocates your Spot capacity across the number of Spot pools
2765
- # that you specify.
2794
+ # The default Spot allocation strategy for calls that you make through
2795
+ # the API, the AWS CLI, or the AWS SDKs is `lowest-price`. The default
2796
+ # Spot allocation strategy for the AWS Management Console is
2797
+ # `capacity-optimized`.
2798
+ #
2799
+ # Valid values: `lowest-price` \| `capacity-optimized`
2766
2800
  # @return [String]
2767
2801
  #
2768
2802
  # @!attribute [rw] spot_instance_pools
2769
- # The number of Spot pools to use to allocate your Spot capacity. The
2770
- # Spot pools are determined from the different instance types in the
2771
- # Overrides array of LaunchTemplate. The range is 1–20.
2772
- #
2803
+ # The number of Spot Instance pools across which to allocate your Spot
2804
+ # Instances. The Spot pools are determined from the different instance
2805
+ # types in the Overrides array of LaunchTemplate. The range is 1–20.
2773
2806
  # The default value is `2`.
2807
+ #
2808
+ # Valid only when the Spot allocation strategy is `lowest-price`.
2774
2809
  # @return [Integer]
2775
2810
  #
2776
2811
  # @!attribute [rw] spot_max_price
@@ -2818,24 +2853,47 @@ module Aws::AutoScaling
2818
2853
  # @return [String]
2819
2854
  #
2820
2855
  # @!attribute [rw] image_id
2821
- # The ID of the Amazon Machine Image (AMI).
2856
+ # The ID of the Amazon Machine Image (AMI) to use to launch your EC2
2857
+ # instances.
2858
+ #
2859
+ # For more information, see [Finding an AMI][1] in the *Amazon EC2
2860
+ # User Guide for Linux Instances*.
2861
+ #
2862
+ #
2863
+ #
2864
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html
2822
2865
  # @return [String]
2823
2866
  #
2824
2867
  # @!attribute [rw] key_name
2825
2868
  # The name of the key pair.
2869
+ #
2870
+ # For more information, see [Amazon EC2 Key Pairs][1] in the *Amazon
2871
+ # EC2 User Guide for Linux Instances*.
2872
+ #
2873
+ #
2874
+ #
2875
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html
2826
2876
  # @return [String]
2827
2877
  #
2828
2878
  # @!attribute [rw] security_groups
2829
- # The security groups to associate with the instances.
2879
+ # A list that contains the security groups to assign to the instances
2880
+ # in the Auto Scaling group.
2881
+ #
2882
+ # For more information, see [Security Groups for Your VPC][1] in the
2883
+ # *Amazon Virtual Private Cloud User Guide*.
2884
+ #
2885
+ #
2886
+ #
2887
+ # [1]: https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_SecurityGroups.html
2830
2888
  # @return [Array<String>]
2831
2889
  #
2832
2890
  # @!attribute [rw] classic_link_vpc_id
2833
2891
  # The ID of a ClassicLink-enabled VPC to link your EC2-Classic
2834
- # instances to. This parameter can only be used if you are launching
2835
- # EC2-Classic instances. For more information, see [ClassicLink][1] in
2836
- # the *Amazon EC2 User Guide for Linux Instances* and [Linking
2837
- # EC2-Classic Instances to a VPC][2] in the *Amazon EC2 Auto Scaling
2838
- # User Guide*.
2892
+ # instances to.
2893
+ #
2894
+ # For more information, see [ClassicLink][1] in the *Amazon EC2 User
2895
+ # Guide for Linux Instances* and [Linking EC2-Classic Instances to a
2896
+ # VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
2839
2897
  #
2840
2898
  #
2841
2899
  #
@@ -2845,13 +2903,11 @@ module Aws::AutoScaling
2845
2903
  #
2846
2904
  # @!attribute [rw] classic_link_vpc_security_groups
2847
2905
  # The IDs of one or more security groups for the VPC specified in
2848
- # `ClassicLinkVPCId`. For more information, see [ClassicLink][1] in
2849
- # the *Amazon EC2 User Guide for Linux Instances* and [Linking
2850
- # EC2-Classic Instances to a VPC][2] in the *Amazon EC2 Auto Scaling
2851
- # User Guide*.
2906
+ # `ClassicLinkVPCId`.
2852
2907
  #
2853
- # Conditional: This parameter is required if you specify a
2854
- # ClassicLink-enabled VPC, and cannot be used otherwise.
2908
+ # For more information, see [ClassicLink][1] in the *Amazon EC2 User
2909
+ # Guide for Linux Instances* and [Linking EC2-Classic Instances to a
2910
+ # VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
2855
2911
  #
2856
2912
  #
2857
2913
  #
@@ -2860,11 +2916,27 @@ module Aws::AutoScaling
2860
2916
  # @return [Array<String>]
2861
2917
  #
2862
2918
  # @!attribute [rw] user_data
2863
- # The user data available to the instances.
2919
+ # The Base64-encoded user data to make available to the launched EC2
2920
+ # instances.
2921
+ #
2922
+ # For more information, see [Instance Metadata and User Data][1] in
2923
+ # the *Amazon EC2 User Guide for Linux Instances*.
2924
+ #
2925
+ #
2926
+ #
2927
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html
2864
2928
  # @return [String]
2865
2929
  #
2866
2930
  # @!attribute [rw] instance_type
2867
2931
  # The instance type for the instances.
2932
+ #
2933
+ # For information about available instance types, see [Available
2934
+ # Instance Types][1] in the *Amazon EC2 User Guide for Linux
2935
+ # Instances.*
2936
+ #
2937
+ #
2938
+ #
2939
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#AvailableInstanceTypes
2868
2940
  # @return [String]
2869
2941
  #
2870
2942
  # @!attribute [rw] kernel_id
@@ -2878,20 +2950,52 @@ module Aws::AutoScaling
2878
2950
  # @!attribute [rw] block_device_mappings
2879
2951
  # A block device mapping, which specifies the block devices for the
2880
2952
  # instance.
2953
+ #
2954
+ # For more information, see [Block Device Mapping][1] in the *Amazon
2955
+ # EC2 User Guide for Linux Instances*.
2956
+ #
2957
+ #
2958
+ #
2959
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-device-mapping-concepts.html
2881
2960
  # @return [Array<Types::BlockDeviceMapping>]
2882
2961
  #
2883
2962
  # @!attribute [rw] instance_monitoring
2884
2963
  # Controls whether instances in this group are launched with detailed
2885
2964
  # (`true`) or basic (`false`) monitoring.
2965
+ #
2966
+ # For more information, see [Configure Monitoring for Auto Scaling
2967
+ # Instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
2968
+ #
2969
+ #
2970
+ #
2971
+ # [1]: https://docs.aws.amazon.com/autoscaling/latest/userguide/as-instance-monitoring.html#enable-as-instance-metrics
2886
2972
  # @return [Types::InstanceMonitoring]
2887
2973
  #
2888
2974
  # @!attribute [rw] spot_price
2889
- # The price to bid when launching Spot Instances.
2975
+ # The maximum hourly price to be paid for any Spot Instance launched
2976
+ # to fulfill the request. Spot Instances are launched when the price
2977
+ # you specify exceeds the current Spot market price.
2978
+ #
2979
+ # For more information, see [Launching Spot Instances in Your Auto
2980
+ # Scaling Group][1] in the *Amazon EC2 Auto Scaling User Guide*.
2981
+ #
2982
+ #
2983
+ #
2984
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-launch-spot-instances.html
2890
2985
  # @return [String]
2891
2986
  #
2892
2987
  # @!attribute [rw] iam_instance_profile
2893
- # The name or Amazon Resource Name (ARN) of the instance profile
2894
- # associated with the IAM role for the instance.
2988
+ # The name or the Amazon Resource Name (ARN) of the instance profile
2989
+ # associated with the IAM role for the instance. The instance profile
2990
+ # contains the IAM role.
2991
+ #
2992
+ # For more information, see [IAM Role for Applications That Run on
2993
+ # Amazon EC2 Instances][1] in the *Amazon EC2 Auto Scaling User
2994
+ # Guide*.
2995
+ #
2996
+ #
2997
+ #
2998
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/us-iam-role.html
2895
2999
  # @return [String]
2896
3000
  #
2897
3001
  # @!attribute [rw] created_time
@@ -2899,19 +3003,40 @@ module Aws::AutoScaling
2899
3003
  # @return [Time]
2900
3004
  #
2901
3005
  # @!attribute [rw] ebs_optimized
2902
- # Controls whether the instance is optimized for EBS I/O (`true`) or
2903
- # not (`false`).
3006
+ # Specifies whether the launch configuration is optimized for EBS I/O
3007
+ # (`true`) or not (`false`).
3008
+ #
3009
+ # For more information, see [Amazon EBS-Optimized Instances][1] in the
3010
+ # *Amazon EC2 User Guide for Linux Instances*.
3011
+ #
3012
+ #
3013
+ #
3014
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSOptimized.html
2904
3015
  # @return [Boolean]
2905
3016
  #
2906
3017
  # @!attribute [rw] associate_public_ip_address
2907
- # \[EC2-VPC\] Indicates whether to assign a public IP address to each
2908
- # instance.
3018
+ # For Auto Scaling groups that are running in a VPC, specifies whether
3019
+ # to assign a public IP address to the group's instances.
3020
+ #
3021
+ # For more information, see [Launching Auto Scaling Instances in a
3022
+ # VPC][1] in the *Amazon EC2 Auto Scaling User Guide*.
3023
+ #
3024
+ #
3025
+ #
3026
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html
2909
3027
  # @return [Boolean]
2910
3028
  #
2911
3029
  # @!attribute [rw] placement_tenancy
2912
3030
  # The tenancy of the instance, either `default` or `dedicated`. An
2913
- # instance with `dedicated` tenancy runs in an isolated, single-tenant
3031
+ # instance with `dedicated` tenancy runs on isolated, single-tenant
2914
3032
  # hardware and can only be launched into a VPC.
3033
+ #
3034
+ # For more information, see [Instance Placement Tenancy][1] in the
3035
+ # *Amazon EC2 Auto Scaling User Guide*.
3036
+ #
3037
+ #
3038
+ #
3039
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-vpc-tenancy
2915
3040
  # @return [String]
2916
3041
  #
2917
3042
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/LaunchConfiguration AWS API Documentation
@@ -3128,8 +3253,7 @@ module Aws::AutoScaling
3128
3253
 
3129
3254
  # Describes a lifecycle hook, which tells Amazon EC2 Auto Scaling that
3130
3255
  # you want to perform an action whenever it launches instances or
3131
- # whenever it terminates instances. Used in response to
3132
- # DescribeLifecycleHooks.
3256
+ # terminates instances. Used in response to DescribeLifecycleHooks.
3133
3257
  #
3134
3258
  # @!attribute [rw] lifecycle_hook_name
3135
3259
  # The name of the lifecycle hook.
@@ -3223,7 +3347,7 @@ module Aws::AutoScaling
3223
3347
  # the instances launch or terminate.**
3224
3348
  #
3225
3349
  # 4. If you need more time, record the lifecycle action heartbeat to
3226
- # keep the instance in a pending state using using
3350
+ # keep the instance in a pending state using
3227
3351
  # RecordLifecycleActionHeartbeat.
3228
3352
  #
3229
3353
  # 5. If you finish before the timeout period ends, complete the
@@ -3494,11 +3618,11 @@ module Aws::AutoScaling
3494
3618
  # Instance Types and Purchase Options][1] in the *Amazon EC2 Auto
3495
3619
  # Scaling User Guide*.
3496
3620
  #
3497
- # You can create a mixed instances policy for a new Auto Scaling group
3498
- # (CreateAutoScalingGroup), or you can create it for an existing group
3499
- # by updating the group (UpdateAutoScalingGroup) to specify
3500
- # `MixedInstancesPolicy` as the top-level parameter instead of a launch
3501
- # configuration or template.
3621
+ # You can create a mixed instances policy for a new Auto Scaling group,
3622
+ # or you can create it for an existing group by updating the group to
3623
+ # specify `MixedInstancesPolicy` as the top-level parameter instead of a
3624
+ # launch configuration or template. For more information, see
3625
+ # CreateAutoScalingGroup and UpdateAutoScalingGroup.
3502
3626
  #
3503
3627
  #
3504
3628
  #
@@ -3918,18 +4042,17 @@ module Aws::AutoScaling
3918
4042
  # @return [String]
3919
4043
  #
3920
4044
  # @!attribute [rw] adjustment_type
3921
- # The adjustment type. The valid values are `ChangeInCapacity`,
3922
- # `ExactCapacity`, and `PercentChangeInCapacity`.
3923
- #
3924
- # This parameter is supported if the policy type is `SimpleScaling` or
3925
- # `StepScaling`.
4045
+ # Specifies whether the `ScalingAdjustment` parameter is an absolute
4046
+ # number or a percentage of the current capacity. The valid values are
4047
+ # `ChangeInCapacity`, `ExactCapacity`, and `PercentChangeInCapacity`.
3926
4048
  #
3927
- # For more information, see [Dynamic Scaling][1] in the *Amazon EC2
3928
- # Auto Scaling User Guide*.
4049
+ # Valid only if the policy type is `StepScaling` or `SimpleScaling`.
4050
+ # For more information, see [Scaling Adjustment Types][1] in the
4051
+ # *Amazon EC2 Auto Scaling User Guide*.
3929
4052
  #
3930
4053
  #
3931
4054
  #
3932
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-scale-based-on-demand.html
4055
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-scaling-simple-step.html#as-scaling-adjustment
3933
4056
  # @return [String]
3934
4057
  #
3935
4058
  # @!attribute [rw] min_adjustment_step
@@ -3943,28 +4066,38 @@ module Aws::AutoScaling
3943
4066
  # changes the `DesiredCapacity` of the Auto Scaling group by at least
3944
4067
  # this many instances. Otherwise, the error is `ValidationError`.
3945
4068
  #
3946
- # This parameter is supported if the policy type is `SimpleScaling` or
3947
- # `StepScaling`.
4069
+ # This property replaces the `MinAdjustmentStep` property. For
4070
+ # example, suppose that you create a step scaling policy to scale out
4071
+ # an Auto Scaling group by 25 percent and you specify a
4072
+ # `MinAdjustmentMagnitude` of 2. If the group has 4 instances and the
4073
+ # scaling policy is performed, 25 percent of 4 is 1. However, because
4074
+ # you specified a `MinAdjustmentMagnitude` of 2, Amazon EC2 Auto
4075
+ # Scaling scales out the group by 2 instances.
4076
+ #
4077
+ # Valid only if the policy type is `SimpleScaling` or `StepScaling`.
3948
4078
  # @return [Integer]
3949
4079
  #
3950
4080
  # @!attribute [rw] scaling_adjustment
3951
- # The amount by which to scale, based on the specified adjustment
3952
- # type. A positive value adds to the current capacity while a negative
3953
- # number removes from the current capacity.
3954
- #
3955
- # Conditional: This parameter is required if the policy type is
3956
- # `SimpleScaling` and not supported otherwise.
4081
+ # The amount by which a simple scaling policy scales the Auto Scaling
4082
+ # group in response to an alarm breach. The adjustment is based on the
4083
+ # value that you specified in the `AdjustmentType` parameter (either
4084
+ # an absolute number or a percentage). A positive value adds to the
4085
+ # current capacity and a negative value subtracts from the current
4086
+ # capacity. For exact capacity, you must specify a positive value.
4087
+ #
4088
+ # Conditional: If you specify `SimpleScaling` for the policy type, you
4089
+ # must specify this parameter. (Not used with any other policy type.)
3957
4090
  # @return [Integer]
3958
4091
  #
3959
4092
  # @!attribute [rw] cooldown
3960
4093
  # The amount of time, in seconds, after a scaling activity completes
3961
- # and before the next scaling activity can start. If this parameter is
3962
- # not specified, the default cooldown period for the group applies.
3963
- #
3964
- # This parameter is supported if the policy type is `SimpleScaling`.
4094
+ # before any further dynamic scaling activities can start. If this
4095
+ # parameter is not specified, the default cooldown period for the
4096
+ # group applies.
3965
4097
  #
3966
- # For more information, see [Scaling Cooldowns][1] in the *Amazon EC2
3967
- # Auto Scaling User Guide*.
4098
+ # Valid only if the policy type is `SimpleScaling`. For more
4099
+ # information, see [Scaling Cooldowns][1] in the *Amazon EC2 Auto
4100
+ # Scaling User Guide*.
3968
4101
  #
3969
4102
  #
3970
4103
  #
@@ -3976,15 +4109,15 @@ module Aws::AutoScaling
3976
4109
  # are `Minimum`, `Maximum`, and `Average`. If the aggregation type is
3977
4110
  # null, the value is treated as `Average`.
3978
4111
  #
3979
- # This parameter is supported if the policy type is `StepScaling`.
4112
+ # Valid only if the policy type is `StepScaling`.
3980
4113
  # @return [String]
3981
4114
  #
3982
4115
  # @!attribute [rw] step_adjustments
3983
4116
  # A set of adjustments that enable you to scale based on the size of
3984
4117
  # the alarm breach.
3985
4118
  #
3986
- # Conditional: This parameter is required if the policy type is
3987
- # `StepScaling` and not supported otherwise.
4119
+ # Conditional: If you specify `StepScaling` for the policy type, you
4120
+ # must specify this parameter. (Not used with any other policy type.)
3988
4121
  # @return [Array<Types::StepAdjustment>]
3989
4122
  #
3990
4123
  # @!attribute [rw] estimated_instance_warmup
@@ -3992,7 +4125,7 @@ module Aws::AutoScaling
3992
4125
  # contribute to the CloudWatch metrics. The default is to use the
3993
4126
  # value specified for the default cooldown period for the group.
3994
4127
  #
3995
- # This parameter is supported if the policy type is `StepScaling` or
4128
+ # Valid only if the policy type is `StepScaling` or
3996
4129
  # `TargetTrackingScaling`.
3997
4130
  # @return [Integer]
3998
4131
  #
@@ -4000,8 +4133,16 @@ module Aws::AutoScaling
4000
4133
  # A target tracking scaling policy. Includes support for predefined or
4001
4134
  # customized metrics.
4002
4135
  #
4003
- # Conditional: This parameter is required if the policy type is
4004
- # `TargetTrackingScaling` and not supported otherwise.
4136
+ # For more information, see [TargetTrackingConfiguration][1] in the
4137
+ # *Amazon EC2 Auto Scaling API Reference*.
4138
+ #
4139
+ # Conditional: If you specify `TargetTrackingScaling` for the policy
4140
+ # type, you must specify this parameter. (Not used with any other
4141
+ # policy type.)
4142
+ #
4143
+ #
4144
+ #
4145
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_TargetTrackingConfiguration.html
4005
4146
  # @return [Types::TargetTrackingConfiguration]
4006
4147
  #
4007
4148
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PutScalingPolicyType AWS API Documentation
@@ -4046,7 +4187,7 @@ module Aws::AutoScaling
4046
4187
  # @return [String]
4047
4188
  #
4048
4189
  # @!attribute [rw] time
4049
- # This parameter is deprecated.
4190
+ # This parameter is no longer used.
4050
4191
  # @return [Time]
4051
4192
  #
4052
4193
  # @!attribute [rw] start_time
@@ -4361,7 +4502,7 @@ module Aws::AutoScaling
4361
4502
  # @return [String]
4362
4503
  #
4363
4504
  # @!attribute [rw] time
4364
- # This parameter is deprecated.
4505
+ # This parameter is no longer used.
4365
4506
  # @return [Time]
4366
4507
  #
4367
4508
  # @!attribute [rw] start_time
@@ -4947,19 +5088,24 @@ module Aws::AutoScaling
4947
5088
  # `LaunchConfigurationName` in your update request, you can't specify
4948
5089
  # `LaunchTemplate` or `MixedInstancesPolicy`.
4949
5090
  #
4950
- # <note markdown="1"> To update an Auto Scaling group with a launch configuration with
5091
+ # To update an Auto Scaling group with a launch configuration with
4951
5092
  # `InstanceMonitoring` set to `false`, you must first disable the
4952
5093
  # collection of group metrics. Otherwise, you get an error. If you
4953
5094
  # have previously enabled the collection of group metrics, you can
4954
5095
  # disable it using DisableMetricsCollection.
4955
- #
4956
- # </note>
4957
5096
  # @return [String]
4958
5097
  #
4959
5098
  # @!attribute [rw] launch_template
4960
5099
  # The launch template and version to use to specify the updates. If
4961
5100
  # you specify `LaunchTemplate` in your update request, you can't
4962
5101
  # specify `LaunchConfigurationName` or `MixedInstancesPolicy`.
5102
+ #
5103
+ # For more information, see [LaunchTemplateSpecification][1] in the
5104
+ # *Amazon EC2 Auto Scaling API Reference*.
5105
+ #
5106
+ #
5107
+ #
5108
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_LaunchTemplateSpecification.html
4963
5109
  # @return [Types::LaunchTemplateSpecification]
4964
5110
  #
4965
5111
  # @!attribute [rw] mixed_instances_policy
@@ -4969,13 +5115,15 @@ module Aws::AutoScaling
4969
5115
  # the policy that is specified. All optional parameters are left
4970
5116
  # unchanged if not specified.
4971
5117
  #
4972
- # For more information, see [Auto Scaling Groups with Multiple
4973
- # Instance Types and Purchase Options][1] in the *Amazon EC2 Auto
4974
- # Scaling User Guide*.
5118
+ # For more information, see [MixedInstancesPolicy][1] in the *Amazon
5119
+ # EC2 Auto Scaling API Reference* and [Auto Scaling Groups with
5120
+ # Multiple Instance Types and Purchase Options][2] in the *Amazon EC2
5121
+ # Auto Scaling User Guide*.
4975
5122
  #
4976
5123
  #
4977
5124
  #
4978
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
5125
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_MixedInstancesPolicy.html
5126
+ # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
4979
5127
  # @return [Types::MixedInstancesPolicy]
4980
5128
  #
4981
5129
  # @!attribute [rw] min_size
@@ -5025,15 +5173,15 @@ module Aws::AutoScaling
5025
5173
  # before checking the health status of an EC2 instance that has come
5026
5174
  # into service. The default value is `0`.
5027
5175
  #
5028
- # For more information, see [Health Checks for Auto Scaling
5029
- # Instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
5176
+ # For more information, see [Health Check Grace Period][1] in the
5177
+ # *Amazon EC2 Auto Scaling User Guide*.
5030
5178
  #
5031
5179
  # Conditional: This parameter is required if you are adding an `ELB`
5032
5180
  # health check.
5033
5181
  #
5034
5182
  #
5035
5183
  #
5036
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html
5184
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html#health-check-grace-period
5037
5185
  # @return [Integer]
5038
5186
  #
5039
5187
  # @!attribute [rw] placement_group