aws-sdk-autoscaling 1.78.0 → 1.79.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 1297d3ab96d99067b36582bccd3fc98b407006a10892b0e8a7480666e02d1ec8
4
- data.tar.gz: 8c43e827ad2ca1a5ec99bec764a5631c939528dce67dd9db8418d64c9b02ec4c
3
+ metadata.gz: fb6018b6a3f686dd00f1295d3ff6c2120a567430889669197cdff253bc18129a
4
+ data.tar.gz: b2f324f7e8bbefae715151f02b6ac7bb1fb5e97b11b840ace0b482ec950d9a4d
5
5
  SHA512:
6
- metadata.gz: 852f0d4766c849e434778eb7b965800de831c059c8e9a83db11aa30774db9a68bfb8ace9e9e89ded658249486b40a050a9f8af139a0346d454be1705bbac28c1
7
- data.tar.gz: 2e65494c870d2e6b1deb1f97f7745bac6dc602a026eb040fdaffe74d7d848b2577b16a05bdaff66cceda7fa39249f6eadd3fb475fdcfc86e9310169e229e02d5
6
+ metadata.gz: f4cd35fd4b3454a3c43430a11a90e9215c8fb48d6357bf3db514e46324f405c0fddc2a113b491109a5d2f54f74cc4ce642066e98bc062614e539c8958ba5db85
7
+ data.tar.gz: d804d1d96266479c42d4ea89b4c8ca075011d8ed4b95bc6b3b2d0008eed8df5f516db0c6c1be97994b1ed0d2cb61ec665b141fadcf1824e888d28190268404e0
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.79.0 (2022-04-19)
5
+ ------------------
6
+
7
+ * Feature - EC2 Auto Scaling now adds default instance warm-up times for all scaling activities, health check replacements, and other replacement events in the Auto Scaling instance lifecycle.
8
+
4
9
  1.78.0 (2022-02-24)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.78.0
1
+ 1.79.0
@@ -118,9 +118,7 @@ module Aws::AutoScaling
118
118
  data[:health_check_type]
119
119
  end
120
120
 
121
- # The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
122
- # before checking the health status of an EC2 instance that has come
123
- # into service and marking it unhealthy due to a failed health check.
121
+ # The duration of the health check grace period, in seconds.
124
122
  # @return [Integer]
125
123
  def health_check_grace_period
126
124
  data[:health_check_grace_period]
@@ -220,23 +218,18 @@ module Aws::AutoScaling
220
218
 
221
219
  # The unit of measurement for the value specified for desired capacity.
222
220
  # Amazon EC2 Auto Scaling supports `DesiredCapacityType` for
223
- # attribute-based instance type selection only. For more information,
224
- # see [Creating an Auto Scaling group using attribute-based instance
225
- # type selection][1] in the *Amazon EC2 Auto Scaling User Guide*.
226
- #
227
- # By default, Amazon EC2 Auto Scaling specifies `units`, which
228
- # translates into number of instances.
229
- #
230
- # Valid values: `units` \| `vcpu` \| `memory-mib`
231
- #
232
- #
233
- #
234
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-instance-type-requirements.html
221
+ # attribute-based instance type selection only.
235
222
  # @return [String]
236
223
  def desired_capacity_type
237
224
  data[:desired_capacity_type]
238
225
  end
239
226
 
227
+ # The duration of the default instance warmup, in seconds.
228
+ # @return [Integer]
229
+ def default_instance_warmup
230
+ data[:default_instance_warmup]
231
+ end
232
+
240
233
  # @!endgroup
241
234
 
242
235
  # @return [Client]
@@ -815,14 +808,16 @@ module Aws::AutoScaling
815
808
  # Required if the policy type is `SimpleScaling`. (Not used with any
816
809
  # other policy type.)
817
810
  # @option options [Integer] :cooldown
818
- # The duration of the policy's cooldown period, in seconds. When a
819
- # cooldown period is specified here, it overrides the default cooldown
820
- # period defined for the Auto Scaling group.
811
+ # A cooldown period, in seconds, that applies to a specific simple
812
+ # scaling policy. When a cooldown period is specified here, it overrides
813
+ # the default cooldown.
821
814
  #
822
815
  # Valid only if the policy type is `SimpleScaling`. For more
823
816
  # information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1] in
824
817
  # the *Amazon EC2 Auto Scaling User Guide*.
825
818
  #
819
+ # Default: None
820
+ #
826
821
  #
827
822
  #
828
823
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/Cooldown.html
@@ -839,13 +834,22 @@ module Aws::AutoScaling
839
834
  # Required if the policy type is `StepScaling`. (Not used with any other
840
835
  # policy type.)
841
836
  # @option options [Integer] :estimated_instance_warmup
837
+ # *Not needed if the default instance warmup is defined for the group.*
838
+ #
842
839
  # The estimated time, in seconds, until a newly launched instance can
843
- # contribute to the CloudWatch metrics. If not provided, the default is
844
- # to use the value from the default cooldown period for the Auto Scaling
845
- # group.
840
+ # contribute to the CloudWatch metrics. This warm-up period applies to
841
+ # instances launched due to a specific target tracking or step scaling
842
+ # policy. When a warm-up period is specified here, it overrides the
843
+ # default instance warmup.
846
844
  #
847
845
  # Valid only if the policy type is `TargetTrackingScaling` or
848
846
  # `StepScaling`.
847
+ #
848
+ # <note markdown="1"> The default is to use the value for the default instance warmup
849
+ # defined for the group. If default instance warmup is null, then
850
+ # `EstimatedInstanceWarmup` falls back to the value of default cooldown.
851
+ #
852
+ # </note>
849
853
  # @option options [Types::TargetTrackingConfiguration] :target_tracking_configuration
850
854
  # A target tracking scaling policy. Provides support for predefined or
851
855
  # custom metrics.
@@ -1177,6 +1181,7 @@ module Aws::AutoScaling
1177
1181
  # capacity_rebalance: false,
1178
1182
  # context: "Context",
1179
1183
  # desired_capacity_type: "XmlStringMaxLen255",
1184
+ # default_instance_warmup: 1,
1180
1185
  # })
1181
1186
  # @param [Hash] options ({})
1182
1187
  # @option options [String] :launch_configuration_name
@@ -1215,10 +1220,10 @@ module Aws::AutoScaling
1215
1220
  # size of the group and less than or equal to the maximum size of the
1216
1221
  # group.
1217
1222
  # @option options [Integer] :default_cooldown
1218
- # The amount of time, in seconds, after a scaling activity completes
1219
- # before another scaling activity can start. The default value is `300`.
1220
- # This setting applies when using simple scaling policies, but not when
1221
- # using other scaling policies or scheduled scaling. For more
1223
+ # *Only needed if you use simple scaling policies.*
1224
+ #
1225
+ # The amount of time, in seconds, between one scaling activity ending
1226
+ # and another one starting due to simple scaling policies. For more
1222
1227
  # information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1] in
1223
1228
  # the *Amazon EC2 Auto Scaling User Guide*.
1224
1229
  #
@@ -1235,22 +1240,25 @@ module Aws::AutoScaling
1235
1240
  # @option options [Integer] :health_check_grace_period
1236
1241
  # The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
1237
1242
  # before checking the health status of an EC2 instance that has come
1238
- # into service and marking it unhealthy due to a failed health check.
1239
- # The default value is `0`. For more information, see [Health check
1240
- # grace period][1] in the *Amazon EC2 Auto Scaling User Guide*.
1241
- #
1242
- # Required if you are adding an `ELB` health check.
1243
+ # into service and marking it unhealthy due to a failed Elastic Load
1244
+ # Balancing or custom health check. This is useful if your instances do
1245
+ # not immediately pass these health checks after they enter the
1246
+ # `InService` state. For more information, see [Health check grace
1247
+ # period][1] in the *Amazon EC2 Auto Scaling User Guide*.
1243
1248
  #
1244
1249
  #
1245
1250
  #
1246
1251
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html#health-check-grace-period
1247
1252
  # @option options [String] :placement_group
1248
1253
  # The name of an existing placement group into which to launch your
1249
- # instances, if any. A placement group is a logical grouping of
1250
- # instances within a single Availability Zone. You cannot specify
1251
- # multiple Availability Zones and a placement group. For more
1252
- # information, see [Placement Groups][1] in the *Amazon EC2 User Guide
1253
- # for Linux Instances*.
1254
+ # instances. For more information, see [Placement groups][1] in the
1255
+ # *Amazon EC2 User Guide for Linux Instances*.
1256
+ #
1257
+ # <note markdown="1"> A *cluster* placement group is a logical grouping of instances within
1258
+ # a single Availability Zone. You cannot specify multiple Availability
1259
+ # Zones and a cluster placement group.
1260
+ #
1261
+ # </note>
1254
1262
  #
1255
1263
  #
1256
1264
  #
@@ -1325,6 +1333,29 @@ module Aws::AutoScaling
1325
1333
  #
1326
1334
  #
1327
1335
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-instance-type-requirements.html
1336
+ # @option options [Integer] :default_instance_warmup
1337
+ # The amount of time, in seconds, until a newly launched instance can
1338
+ # contribute to the Amazon CloudWatch metrics. This delay lets an
1339
+ # instance finish initializing before Amazon EC2 Auto Scaling aggregates
1340
+ # instance metrics, resulting in more reliable usage data. Set this
1341
+ # value equal to the amount of time that it takes for resource
1342
+ # consumption to become stable after an instance reaches the `InService`
1343
+ # state. For more information, see [Set the default instance warmup for
1344
+ # an Auto Scaling group][1] in the *Amazon EC2 Auto Scaling User Guide*.
1345
+ #
1346
+ # To manage your warm-up settings at the group level, we recommend that
1347
+ # you set the default instance warmup, *even if its value is set to 0
1348
+ # seconds*. This also optimizes the performance of scaling policies that
1349
+ # scale continuously, such as target tracking and step scaling policies.
1350
+ #
1351
+ # If you need to remove a value that you previously set, include the
1352
+ # property but specify `-1` for the value. However, we strongly
1353
+ # recommend keeping the default instance warmup enabled by specifying a
1354
+ # minimum value of `0`.
1355
+ #
1356
+ #
1357
+ #
1358
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-default-instance-warmup.html
1328
1359
  # @return [AutoScalingGroup]
1329
1360
  def update(options = {})
1330
1361
  options = options.merge(auto_scaling_group_name: @name)
@@ -872,13 +872,15 @@ module Aws::AutoScaling
872
872
  # group.
873
873
  #
874
874
  # @option params [Integer] :default_cooldown
875
- # The amount of time, in seconds, after a scaling activity completes
876
- # before another scaling activity can start. The default value is `300`.
877
- # This setting applies when using simple scaling policies, but not when
878
- # using other scaling policies or scheduled scaling. For more
875
+ # *Only needed if you use simple scaling policies.*
876
+ #
877
+ # The amount of time, in seconds, between one scaling activity ending
878
+ # and another one starting due to simple scaling policies. For more
879
879
  # information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1] in
880
880
  # the *Amazon EC2 Auto Scaling User Guide*.
881
881
  #
882
+ # Default: `300` seconds
883
+ #
882
884
  #
883
885
  #
884
886
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/Cooldown.html
@@ -921,13 +923,17 @@ module Aws::AutoScaling
921
923
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html
922
924
  #
923
925
  # @option params [Integer] :health_check_grace_period
926
+ # **
927
+ #
924
928
  # The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
925
929
  # before checking the health status of an EC2 instance that has come
926
- # into service and marking it unhealthy due to a failed health check.
927
- # The default value is `0`. For more information, see [Health check
928
- # grace period][1] in the *Amazon EC2 Auto Scaling User Guide*.
930
+ # into service and marking it unhealthy due to a failed Elastic Load
931
+ # Balancing or custom health check. This is useful if your instances do
932
+ # not immediately pass these health checks after they enter the
933
+ # `InService` state. For more information, see [Health check grace
934
+ # period][1] in the *Amazon EC2 Auto Scaling User Guide*.
929
935
  #
930
- # Required if you are adding an `ELB` health check.
936
+ # Default: `0` seconds
931
937
  #
932
938
  #
933
939
  #
@@ -935,11 +941,14 @@ module Aws::AutoScaling
935
941
  #
936
942
  # @option params [String] :placement_group
937
943
  # The name of an existing placement group into which to launch your
938
- # instances, if any. A placement group is a logical grouping of
939
- # instances within a single Availability Zone. You cannot specify
940
- # multiple Availability Zones and a placement group. For more
941
- # information, see [Placement Groups][1] in the *Amazon EC2 User Guide
942
- # for Linux Instances*.
944
+ # instances. For more information, see [Placement groups][1] in the
945
+ # *Amazon EC2 User Guide for Linux Instances*.
946
+ #
947
+ # <note markdown="1"> A *cluster* placement group is a logical grouping of instances within
948
+ # a single Availability Zone. You cannot specify multiple Availability
949
+ # Zones and a cluster placement group.
950
+ #
951
+ # </note>
943
952
  #
944
953
  #
945
954
  #
@@ -1051,6 +1060,32 @@ module Aws::AutoScaling
1051
1060
  #
1052
1061
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-instance-type-requirements.html
1053
1062
  #
1063
+ # @option params [Integer] :default_instance_warmup
1064
+ # The amount of time, in seconds, until a newly launched instance can
1065
+ # contribute to the Amazon CloudWatch metrics. This delay lets an
1066
+ # instance finish initializing before Amazon EC2 Auto Scaling aggregates
1067
+ # instance metrics, resulting in more reliable usage data. Set this
1068
+ # value equal to the amount of time that it takes for resource
1069
+ # consumption to become stable after an instance reaches the `InService`
1070
+ # state. For more information, see [Set the default instance warmup for
1071
+ # an Auto Scaling group][1] in the *Amazon EC2 Auto Scaling User Guide*.
1072
+ #
1073
+ # To manage your warm-up settings at the group level, we recommend that
1074
+ # you set the default instance warmup, *even if its value is set to 0
1075
+ # seconds*. This also optimizes the performance of scaling policies that
1076
+ # scale continuously, such as target tracking and step scaling policies.
1077
+ #
1078
+ # If you need to remove a value that you previously set, include the
1079
+ # property but specify `-1` for the value. However, we strongly
1080
+ # recommend keeping the default instance warmup enabled by specifying a
1081
+ # minimum value of `0`.
1082
+ #
1083
+ # Default: None
1084
+ #
1085
+ #
1086
+ #
1087
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-default-instance-warmup.html
1088
+ #
1054
1089
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1055
1090
  #
1056
1091
  #
@@ -1255,6 +1290,7 @@ module Aws::AutoScaling
1255
1290
  # max_instance_lifetime: 1,
1256
1291
  # context: "Context",
1257
1292
  # desired_capacity_type: "XmlStringMaxLen255",
1293
+ # default_instance_warmup: 1,
1258
1294
  # })
1259
1295
  #
1260
1296
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CreateAutoScalingGroup AWS API Documentation
@@ -1322,25 +1358,24 @@ module Aws::AutoScaling
1322
1358
  # [2]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-network-security.html
1323
1359
  #
1324
1360
  # @option params [String] :classic_link_vpc_id
1361
+ # *EC2-Classic retires on August 15, 2022. This parameter is not
1362
+ # supported after that date.*
1363
+ #
1325
1364
  # The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances
1326
1365
  # to. For more information, see [ClassicLink][1] in the *Amazon EC2 User
1327
- # Guide for Linux Instances* and [Linking EC2-Classic instances to a
1328
- # VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
1329
- #
1330
- # This parameter can only be used if you are launching EC2-Classic
1331
- # instances.
1366
+ # Guide for Linux Instances*.
1332
1367
  #
1333
1368
  #
1334
1369
  #
1335
1370
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html
1336
- # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-ClassicLink
1337
1371
  #
1338
1372
  # @option params [Array<String>] :classic_link_vpc_security_groups
1373
+ # *EC2-Classic retires on August 15, 2022. This parameter is not
1374
+ # supported after that date.*
1375
+ #
1339
1376
  # The IDs of one or more security groups for the specified
1340
1377
  # ClassicLink-enabled VPC. For more information, see [ClassicLink][1] in
1341
- # the *Amazon EC2 User Guide for Linux Instances* and [Linking
1342
- # EC2-Classic instances to a VPC][2] in the *Amazon EC2 Auto Scaling
1343
- # User Guide*.
1378
+ # the *Amazon EC2 User Guide for Linux Instances*.
1344
1379
  #
1345
1380
  # If you specify the `ClassicLinkVPCId` parameter, you must specify this
1346
1381
  # parameter.
@@ -1348,7 +1383,6 @@ module Aws::AutoScaling
1348
1383
  #
1349
1384
  #
1350
1385
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html
1351
- # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-ClassicLink
1352
1386
  #
1353
1387
  # @option params [String] :user_data
1354
1388
  # The user data to make available to the launched EC2 instances. For
@@ -2328,6 +2362,7 @@ module Aws::AutoScaling
2328
2362
  # resp.auto_scaling_groups[0].warm_pool_size #=> Integer
2329
2363
  # resp.auto_scaling_groups[0].context #=> String
2330
2364
  # resp.auto_scaling_groups[0].desired_capacity_type #=> String
2365
+ # resp.auto_scaling_groups[0].default_instance_warmup #=> Integer
2331
2366
  # resp.next_token #=> String
2332
2367
  #
2333
2368
  #
@@ -4890,14 +4925,16 @@ module Aws::AutoScaling
4890
4925
  # other policy type.)
4891
4926
  #
4892
4927
  # @option params [Integer] :cooldown
4893
- # The duration of the policy's cooldown period, in seconds. When a
4894
- # cooldown period is specified here, it overrides the default cooldown
4895
- # period defined for the Auto Scaling group.
4928
+ # A cooldown period, in seconds, that applies to a specific simple
4929
+ # scaling policy. When a cooldown period is specified here, it overrides
4930
+ # the default cooldown.
4896
4931
  #
4897
4932
  # Valid only if the policy type is `SimpleScaling`. For more
4898
4933
  # information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1] in
4899
4934
  # the *Amazon EC2 Auto Scaling User Guide*.
4900
4935
  #
4936
+ # Default: None
4937
+ #
4901
4938
  #
4902
4939
  #
4903
4940
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/Cooldown.html
@@ -4917,14 +4954,23 @@ module Aws::AutoScaling
4917
4954
  # policy type.)
4918
4955
  #
4919
4956
  # @option params [Integer] :estimated_instance_warmup
4957
+ # *Not needed if the default instance warmup is defined for the group.*
4958
+ #
4920
4959
  # The estimated time, in seconds, until a newly launched instance can
4921
- # contribute to the CloudWatch metrics. If not provided, the default is
4922
- # to use the value from the default cooldown period for the Auto Scaling
4923
- # group.
4960
+ # contribute to the CloudWatch metrics. This warm-up period applies to
4961
+ # instances launched due to a specific target tracking or step scaling
4962
+ # policy. When a warm-up period is specified here, it overrides the
4963
+ # default instance warmup.
4924
4964
  #
4925
4965
  # Valid only if the policy type is `TargetTrackingScaling` or
4926
4966
  # `StepScaling`.
4927
4967
  #
4968
+ # <note markdown="1"> The default is to use the value for the default instance warmup
4969
+ # defined for the group. If default instance warmup is null, then
4970
+ # `EstimatedInstanceWarmup` falls back to the value of default cooldown.
4971
+ #
4972
+ # </note>
4973
+ #
4928
4974
  # @option params [Types::TargetTrackingConfiguration] :target_tracking_configuration
4929
4975
  # A target tracking scaling policy. Provides support for predefined or
4930
4976
  # custom metrics.
@@ -6167,10 +6213,10 @@ module Aws::AutoScaling
6167
6213
  # group.
6168
6214
  #
6169
6215
  # @option params [Integer] :default_cooldown
6170
- # The amount of time, in seconds, after a scaling activity completes
6171
- # before another scaling activity can start. The default value is `300`.
6172
- # This setting applies when using simple scaling policies, but not when
6173
- # using other scaling policies or scheduled scaling. For more
6216
+ # *Only needed if you use simple scaling policies.*
6217
+ #
6218
+ # The amount of time, in seconds, between one scaling activity ending
6219
+ # and another one starting due to simple scaling policies. For more
6174
6220
  # information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1] in
6175
6221
  # the *Amazon EC2 Auto Scaling User Guide*.
6176
6222
  #
@@ -6190,11 +6236,11 @@ module Aws::AutoScaling
6190
6236
  # @option params [Integer] :health_check_grace_period
6191
6237
  # The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
6192
6238
  # before checking the health status of an EC2 instance that has come
6193
- # into service and marking it unhealthy due to a failed health check.
6194
- # The default value is `0`. For more information, see [Health check
6195
- # grace period][1] in the *Amazon EC2 Auto Scaling User Guide*.
6196
- #
6197
- # Required if you are adding an `ELB` health check.
6239
+ # into service and marking it unhealthy due to a failed Elastic Load
6240
+ # Balancing or custom health check. This is useful if your instances do
6241
+ # not immediately pass these health checks after they enter the
6242
+ # `InService` state. For more information, see [Health check grace
6243
+ # period][1] in the *Amazon EC2 Auto Scaling User Guide*.
6198
6244
  #
6199
6245
  #
6200
6246
  #
@@ -6202,11 +6248,14 @@ module Aws::AutoScaling
6202
6248
  #
6203
6249
  # @option params [String] :placement_group
6204
6250
  # The name of an existing placement group into which to launch your
6205
- # instances, if any. A placement group is a logical grouping of
6206
- # instances within a single Availability Zone. You cannot specify
6207
- # multiple Availability Zones and a placement group. For more
6208
- # information, see [Placement Groups][1] in the *Amazon EC2 User Guide
6209
- # for Linux Instances*.
6251
+ # instances. For more information, see [Placement groups][1] in the
6252
+ # *Amazon EC2 User Guide for Linux Instances*.
6253
+ #
6254
+ # <note markdown="1"> A *cluster* placement group is a logical grouping of instances within
6255
+ # a single Availability Zone. You cannot specify multiple Availability
6256
+ # Zones and a cluster placement group.
6257
+ #
6258
+ # </note>
6210
6259
  #
6211
6260
  #
6212
6261
  #
@@ -6290,6 +6339,30 @@ module Aws::AutoScaling
6290
6339
  #
6291
6340
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-instance-type-requirements.html
6292
6341
  #
6342
+ # @option params [Integer] :default_instance_warmup
6343
+ # The amount of time, in seconds, until a newly launched instance can
6344
+ # contribute to the Amazon CloudWatch metrics. This delay lets an
6345
+ # instance finish initializing before Amazon EC2 Auto Scaling aggregates
6346
+ # instance metrics, resulting in more reliable usage data. Set this
6347
+ # value equal to the amount of time that it takes for resource
6348
+ # consumption to become stable after an instance reaches the `InService`
6349
+ # state. For more information, see [Set the default instance warmup for
6350
+ # an Auto Scaling group][1] in the *Amazon EC2 Auto Scaling User Guide*.
6351
+ #
6352
+ # To manage your warm-up settings at the group level, we recommend that
6353
+ # you set the default instance warmup, *even if its value is set to 0
6354
+ # seconds*. This also optimizes the performance of scaling policies that
6355
+ # scale continuously, such as target tracking and step scaling policies.
6356
+ #
6357
+ # If you need to remove a value that you previously set, include the
6358
+ # property but specify `-1` for the value. However, we strongly
6359
+ # recommend keeping the default instance warmup enabled by specifying a
6360
+ # minimum value of `0`.
6361
+ #
6362
+ #
6363
+ #
6364
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-default-instance-warmup.html
6365
+ #
6293
6366
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
6294
6367
  #
6295
6368
  #
@@ -6409,6 +6482,7 @@ module Aws::AutoScaling
6409
6482
  # capacity_rebalance: false,
6410
6483
  # context: "Context",
6411
6484
  # desired_capacity_type: "XmlStringMaxLen255",
6485
+ # default_instance_warmup: 1,
6412
6486
  # })
6413
6487
  #
6414
6488
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/UpdateAutoScalingGroup AWS API Documentation
@@ -6433,7 +6507,7 @@ module Aws::AutoScaling
6433
6507
  params: params,
6434
6508
  config: config)
6435
6509
  context[:gem_name] = 'aws-sdk-autoscaling'
6436
- context[:gem_version] = '1.78.0'
6510
+ context[:gem_version] = '1.79.0'
6437
6511
  Seahorse::Client::Request.new(handlers, context)
6438
6512
  end
6439
6513
 
@@ -86,6 +86,7 @@ module Aws::AutoScaling
86
86
  CreateLaunchConfigurationType = Shapes::StructureShape.new(name: 'CreateLaunchConfigurationType')
87
87
  CreateOrUpdateTagsType = Shapes::StructureShape.new(name: 'CreateOrUpdateTagsType')
88
88
  CustomizedMetricSpecification = Shapes::StructureShape.new(name: 'CustomizedMetricSpecification')
89
+ DefaultInstanceWarmup = Shapes::IntegerShape.new(name: 'DefaultInstanceWarmup')
89
90
  DeleteAutoScalingGroupType = Shapes::StructureShape.new(name: 'DeleteAutoScalingGroupType')
90
91
  DeleteLifecycleHookAnswer = Shapes::StructureShape.new(name: 'DeleteLifecycleHookAnswer')
91
92
  DeleteLifecycleHookType = Shapes::StructureShape.new(name: 'DeleteLifecycleHookType')
@@ -467,6 +468,7 @@ module Aws::AutoScaling
467
468
  AutoScalingGroup.add_member(:warm_pool_size, Shapes::ShapeRef.new(shape: WarmPoolSize, location_name: "WarmPoolSize"))
468
469
  AutoScalingGroup.add_member(:context, Shapes::ShapeRef.new(shape: Context, location_name: "Context"))
469
470
  AutoScalingGroup.add_member(:desired_capacity_type, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, location_name: "DesiredCapacityType"))
471
+ AutoScalingGroup.add_member(:default_instance_warmup, Shapes::ShapeRef.new(shape: DefaultInstanceWarmup, location_name: "DefaultInstanceWarmup"))
470
472
  AutoScalingGroup.struct_class = Types::AutoScalingGroup
471
473
 
472
474
  AutoScalingGroupNames.member = Shapes::ShapeRef.new(shape: XmlStringMaxLen255)
@@ -581,6 +583,7 @@ module Aws::AutoScaling
581
583
  CreateAutoScalingGroupType.add_member(:max_instance_lifetime, Shapes::ShapeRef.new(shape: MaxInstanceLifetime, location_name: "MaxInstanceLifetime"))
582
584
  CreateAutoScalingGroupType.add_member(:context, Shapes::ShapeRef.new(shape: Context, location_name: "Context"))
583
585
  CreateAutoScalingGroupType.add_member(:desired_capacity_type, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, location_name: "DesiredCapacityType"))
586
+ CreateAutoScalingGroupType.add_member(:default_instance_warmup, Shapes::ShapeRef.new(shape: DefaultInstanceWarmup, location_name: "DefaultInstanceWarmup"))
584
587
  CreateAutoScalingGroupType.struct_class = Types::CreateAutoScalingGroupType
585
588
 
586
589
  CreateLaunchConfigurationType.add_member(:launch_configuration_name, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, required: true, location_name: "LaunchConfigurationName"))
@@ -1418,6 +1421,7 @@ module Aws::AutoScaling
1418
1421
  UpdateAutoScalingGroupType.add_member(:capacity_rebalance, Shapes::ShapeRef.new(shape: CapacityRebalanceEnabled, location_name: "CapacityRebalance"))
1419
1422
  UpdateAutoScalingGroupType.add_member(:context, Shapes::ShapeRef.new(shape: Context, location_name: "Context"))
1420
1423
  UpdateAutoScalingGroupType.add_member(:desired_capacity_type, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, location_name: "DesiredCapacityType"))
1424
+ UpdateAutoScalingGroupType.add_member(:default_instance_warmup, Shapes::ShapeRef.new(shape: DefaultInstanceWarmup, location_name: "DefaultInstanceWarmup"))
1421
1425
  UpdateAutoScalingGroupType.struct_class = Types::UpdateAutoScalingGroupType
1422
1426
 
1423
1427
  VCpuCountRequest.add_member(:min, Shapes::ShapeRef.new(shape: NullablePositiveInteger, required: true, location_name: "Min"))
@@ -78,31 +78,21 @@ module Aws::AutoScaling
78
78
  data[:security_groups]
79
79
  end
80
80
 
81
- # The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances
82
- # to. For more information, see [ClassicLink][1] in the *Amazon EC2 User
83
- # Guide for Linux Instances* and [Linking EC2-Classic instances to a
84
- # VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
85
- #
86
- #
81
+ # *EC2-Classic retires on August 15, 2022. This parameter is not
82
+ # supported after that date.*
87
83
  #
88
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html
89
- # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-ClassicLink
84
+ # The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances
85
+ # to.
90
86
  # @return [String]
91
87
  def classic_link_vpc_id
92
88
  data[:classic_link_vpc_id]
93
89
  end
94
90
 
91
+ # *EC2-Classic retires on August 15, 2022. This parameter is not
92
+ # supported after that date.*
93
+ #
95
94
  # The IDs of one or more security groups for the VPC specified in
96
95
  # `ClassicLinkVPCId`.
97
- #
98
- # For more information, see [ClassicLink][1] in the *Amazon EC2 User
99
- # Guide for Linux Instances* and [Linking EC2-Classic instances to a
100
- # VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
101
- #
102
- #
103
- #
104
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html
105
- # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-ClassicLink
106
96
  # @return [Array<String>]
107
97
  def classic_link_vpc_security_groups
108
98
  data[:classic_link_vpc_security_groups]
@@ -87,10 +87,9 @@ module Aws::AutoScaling
87
87
  data[:heartbeat_timeout]
88
88
  end
89
89
 
90
- # The maximum time, in seconds, that an instance can remain in a
91
- # `Pending:Wait` or `Terminating:Wait` state. The maximum is 172800
92
- # seconds (48 hours) or 100 times `HeartbeatTimeout`, whichever is
93
- # smaller.
90
+ # The maximum time, in seconds, that an instance can remain in a wait
91
+ # state. The maximum is 172800 seconds (48 hours) or 100 times
92
+ # `HeartbeatTimeout`, whichever is smaller.
94
93
  # @return [Integer]
95
94
  def global_timeout
96
95
  data[:global_timeout]
@@ -159,6 +159,7 @@ module Aws::AutoScaling
159
159
  # max_instance_lifetime: 1,
160
160
  # context: "Context",
161
161
  # desired_capacity_type: "XmlStringMaxLen255",
162
+ # default_instance_warmup: 1,
162
163
  # })
163
164
  # @param [Hash] options ({})
164
165
  # @option options [required, String] :auto_scaling_group_name
@@ -232,13 +233,15 @@ module Aws::AutoScaling
232
233
  # specify a desired capacity, the default is the minimum size of the
233
234
  # group.
234
235
  # @option options [Integer] :default_cooldown
235
- # The amount of time, in seconds, after a scaling activity completes
236
- # before another scaling activity can start. The default value is `300`.
237
- # This setting applies when using simple scaling policies, but not when
238
- # using other scaling policies or scheduled scaling. For more
236
+ # *Only needed if you use simple scaling policies.*
237
+ #
238
+ # The amount of time, in seconds, between one scaling activity ending
239
+ # and another one starting due to simple scaling policies. For more
239
240
  # information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1] in
240
241
  # the *Amazon EC2 Auto Scaling User Guide*.
241
242
  #
243
+ # Default: `300` seconds
244
+ #
242
245
  #
243
246
  #
244
247
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/Cooldown.html
@@ -276,24 +279,31 @@ module Aws::AutoScaling
276
279
  #
277
280
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html
278
281
  # @option options [Integer] :health_check_grace_period
282
+ # **
283
+ #
279
284
  # The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
280
285
  # before checking the health status of an EC2 instance that has come
281
- # into service and marking it unhealthy due to a failed health check.
282
- # The default value is `0`. For more information, see [Health check
283
- # grace period][1] in the *Amazon EC2 Auto Scaling User Guide*.
286
+ # into service and marking it unhealthy due to a failed Elastic Load
287
+ # Balancing or custom health check. This is useful if your instances do
288
+ # not immediately pass these health checks after they enter the
289
+ # `InService` state. For more information, see [Health check grace
290
+ # period][1] in the *Amazon EC2 Auto Scaling User Guide*.
284
291
  #
285
- # Required if you are adding an `ELB` health check.
292
+ # Default: `0` seconds
286
293
  #
287
294
  #
288
295
  #
289
296
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html#health-check-grace-period
290
297
  # @option options [String] :placement_group
291
298
  # The name of an existing placement group into which to launch your
292
- # instances, if any. A placement group is a logical grouping of
293
- # instances within a single Availability Zone. You cannot specify
294
- # multiple Availability Zones and a placement group. For more
295
- # information, see [Placement Groups][1] in the *Amazon EC2 User Guide
296
- # for Linux Instances*.
299
+ # instances. For more information, see [Placement groups][1] in the
300
+ # *Amazon EC2 User Guide for Linux Instances*.
301
+ #
302
+ # <note markdown="1"> A *cluster* placement group is a logical grouping of instances within
303
+ # a single Availability Zone. You cannot specify multiple Availability
304
+ # Zones and a cluster placement group.
305
+ #
306
+ # </note>
297
307
  #
298
308
  #
299
309
  #
@@ -394,6 +404,31 @@ module Aws::AutoScaling
394
404
  #
395
405
  #
396
406
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-instance-type-requirements.html
407
+ # @option options [Integer] :default_instance_warmup
408
+ # The amount of time, in seconds, until a newly launched instance can
409
+ # contribute to the Amazon CloudWatch metrics. This delay lets an
410
+ # instance finish initializing before Amazon EC2 Auto Scaling aggregates
411
+ # instance metrics, resulting in more reliable usage data. Set this
412
+ # value equal to the amount of time that it takes for resource
413
+ # consumption to become stable after an instance reaches the `InService`
414
+ # state. For more information, see [Set the default instance warmup for
415
+ # an Auto Scaling group][1] in the *Amazon EC2 Auto Scaling User Guide*.
416
+ #
417
+ # To manage your warm-up settings at the group level, we recommend that
418
+ # you set the default instance warmup, *even if its value is set to 0
419
+ # seconds*. This also optimizes the performance of scaling policies that
420
+ # scale continuously, such as target tracking and step scaling policies.
421
+ #
422
+ # If you need to remove a value that you previously set, include the
423
+ # property but specify `-1` for the value. However, we strongly
424
+ # recommend keeping the default instance warmup enabled by specifying a
425
+ # minimum value of `0`.
426
+ #
427
+ # Default: None
428
+ #
429
+ #
430
+ #
431
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-default-instance-warmup.html
397
432
  # @return [AutoScalingGroup]
398
433
  def create_group(options = {})
399
434
  @client.create_auto_scaling_group(options)
@@ -485,24 +520,23 @@ module Aws::AutoScaling
485
520
  # [1]: https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_SecurityGroups.html
486
521
  # [2]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-network-security.html
487
522
  # @option options [String] :classic_link_vpc_id
523
+ # *EC2-Classic retires on August 15, 2022. This parameter is not
524
+ # supported after that date.*
525
+ #
488
526
  # The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances
489
527
  # to. For more information, see [ClassicLink][1] in the *Amazon EC2 User
490
- # Guide for Linux Instances* and [Linking EC2-Classic instances to a
491
- # VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
492
- #
493
- # This parameter can only be used if you are launching EC2-Classic
494
- # instances.
528
+ # Guide for Linux Instances*.
495
529
  #
496
530
  #
497
531
  #
498
532
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html
499
- # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-ClassicLink
500
533
  # @option options [Array<String>] :classic_link_vpc_security_groups
534
+ # *EC2-Classic retires on August 15, 2022. This parameter is not
535
+ # supported after that date.*
536
+ #
501
537
  # The IDs of one or more security groups for the specified
502
538
  # ClassicLink-enabled VPC. For more information, see [ClassicLink][1] in
503
- # the *Amazon EC2 User Guide for Linux Instances* and [Linking
504
- # EC2-Classic instances to a VPC][2] in the *Amazon EC2 Auto Scaling
505
- # User Guide*.
539
+ # the *Amazon EC2 User Guide for Linux Instances*.
506
540
  #
507
541
  # If you specify the `ClassicLinkVPCId` parameter, you must specify this
508
542
  # parameter.
@@ -510,7 +544,6 @@ module Aws::AutoScaling
510
544
  #
511
545
  #
512
546
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html
513
- # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-ClassicLink
514
547
  # @option options [String] :user_data
515
548
  # The user data to make available to the launched EC2 instances. For
516
549
  # more information, see [Instance metadata and user data][1] (Linux) and
@@ -391,9 +391,7 @@ module Aws::AutoScaling
391
391
  # @return [String]
392
392
  #
393
393
  # @!attribute [rw] health_check_grace_period
394
- # The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
395
- # before checking the health status of an EC2 instance that has come
396
- # into service and marking it unhealthy due to a failed health check.
394
+ # The duration of the health check grace period, in seconds.
397
395
  # @return [Integer]
398
396
  #
399
397
  # @!attribute [rw] instances
@@ -471,20 +469,13 @@ module Aws::AutoScaling
471
469
  # @!attribute [rw] desired_capacity_type
472
470
  # The unit of measurement for the value specified for desired
473
471
  # capacity. Amazon EC2 Auto Scaling supports `DesiredCapacityType` for
474
- # attribute-based instance type selection only. For more information,
475
- # see [Creating an Auto Scaling group using attribute-based instance
476
- # type selection][1] in the *Amazon EC2 Auto Scaling User Guide*.
477
- #
478
- # By default, Amazon EC2 Auto Scaling specifies `units`, which
479
- # translates into number of instances.
480
- #
481
- # Valid values: `units` \| `vcpu` \| `memory-mib`
482
- #
483
- #
484
- #
485
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-instance-type-requirements.html
472
+ # attribute-based instance type selection only.
486
473
  # @return [String]
487
474
  #
475
+ # @!attribute [rw] default_instance_warmup
476
+ # The duration of the default instance warmup, in seconds.
477
+ # @return [Integer]
478
+ #
488
479
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/AutoScalingGroup AWS API Documentation
489
480
  #
490
481
  class AutoScalingGroup < Struct.new(
@@ -519,7 +510,8 @@ module Aws::AutoScaling
519
510
  :warm_pool_configuration,
520
511
  :warm_pool_size,
521
512
  :context,
522
- :desired_capacity_type)
513
+ :desired_capacity_type,
514
+ :default_instance_warmup)
523
515
  SENSITIVE = []
524
516
  include Aws::Structure
525
517
  end
@@ -1108,6 +1100,7 @@ module Aws::AutoScaling
1108
1100
  # max_instance_lifetime: 1,
1109
1101
  # context: "Context",
1110
1102
  # desired_capacity_type: "XmlStringMaxLen255",
1103
+ # default_instance_warmup: 1,
1111
1104
  # }
1112
1105
  #
1113
1106
  # @!attribute [rw] auto_scaling_group_name
@@ -1198,13 +1191,15 @@ module Aws::AutoScaling
1198
1191
  # @return [Integer]
1199
1192
  #
1200
1193
  # @!attribute [rw] default_cooldown
1201
- # The amount of time, in seconds, after a scaling activity completes
1202
- # before another scaling activity can start. The default value is
1203
- # `300`. This setting applies when using simple scaling policies, but
1204
- # not when using other scaling policies or scheduled scaling. For more
1194
+ # *Only needed if you use simple scaling policies.*
1195
+ #
1196
+ # The amount of time, in seconds, between one scaling activity ending
1197
+ # and another one starting due to simple scaling policies. For more
1205
1198
  # information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1]
1206
1199
  # in the *Amazon EC2 Auto Scaling User Guide*.
1207
1200
  #
1201
+ # Default: `300` seconds
1202
+ #
1208
1203
  #
1209
1204
  #
1210
1205
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/Cooldown.html
@@ -1253,13 +1248,17 @@ module Aws::AutoScaling
1253
1248
  # @return [String]
1254
1249
  #
1255
1250
  # @!attribute [rw] health_check_grace_period
1251
+ # **
1252
+ #
1256
1253
  # The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
1257
1254
  # before checking the health status of an EC2 instance that has come
1258
- # into service and marking it unhealthy due to a failed health check.
1259
- # The default value is `0`. For more information, see [Health check
1260
- # grace period][1] in the *Amazon EC2 Auto Scaling User Guide*.
1255
+ # into service and marking it unhealthy due to a failed Elastic Load
1256
+ # Balancing or custom health check. This is useful if your instances
1257
+ # do not immediately pass these health checks after they enter the
1258
+ # `InService` state. For more information, see [Health check grace
1259
+ # period][1] in the *Amazon EC2 Auto Scaling User Guide*.
1261
1260
  #
1262
- # Required if you are adding an `ELB` health check.
1261
+ # Default: `0` seconds
1263
1262
  #
1264
1263
  #
1265
1264
  #
@@ -1268,11 +1267,14 @@ module Aws::AutoScaling
1268
1267
  #
1269
1268
  # @!attribute [rw] placement_group
1270
1269
  # The name of an existing placement group into which to launch your
1271
- # instances, if any. A placement group is a logical grouping of
1272
- # instances within a single Availability Zone. You cannot specify
1273
- # multiple Availability Zones and a placement group. For more
1274
- # information, see [Placement Groups][1] in the *Amazon EC2 User Guide
1275
- # for Linux Instances*.
1270
+ # instances. For more information, see [Placement groups][1] in the
1271
+ # *Amazon EC2 User Guide for Linux Instances*.
1272
+ #
1273
+ # <note markdown="1"> A *cluster* placement group is a logical grouping of instances
1274
+ # within a single Availability Zone. You cannot specify multiple
1275
+ # Availability Zones and a cluster placement group.
1276
+ #
1277
+ # </note>
1276
1278
  #
1277
1279
  #
1278
1280
  #
@@ -1399,6 +1401,35 @@ module Aws::AutoScaling
1399
1401
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-instance-type-requirements.html
1400
1402
  # @return [String]
1401
1403
  #
1404
+ # @!attribute [rw] default_instance_warmup
1405
+ # The amount of time, in seconds, until a newly launched instance can
1406
+ # contribute to the Amazon CloudWatch metrics. This delay lets an
1407
+ # instance finish initializing before Amazon EC2 Auto Scaling
1408
+ # aggregates instance metrics, resulting in more reliable usage data.
1409
+ # Set this value equal to the amount of time that it takes for
1410
+ # resource consumption to become stable after an instance reaches the
1411
+ # `InService` state. For more information, see [Set the default
1412
+ # instance warmup for an Auto Scaling group][1] in the *Amazon EC2
1413
+ # Auto Scaling User Guide*.
1414
+ #
1415
+ # To manage your warm-up settings at the group level, we recommend
1416
+ # that you set the default instance warmup, *even if its value is set
1417
+ # to 0 seconds*. This also optimizes the performance of scaling
1418
+ # policies that scale continuously, such as target tracking and step
1419
+ # scaling policies.
1420
+ #
1421
+ # If you need to remove a value that you previously set, include the
1422
+ # property but specify `-1` for the value. However, we strongly
1423
+ # recommend keeping the default instance warmup enabled by specifying
1424
+ # a minimum value of `0`.
1425
+ #
1426
+ # Default: None
1427
+ #
1428
+ #
1429
+ #
1430
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-default-instance-warmup.html
1431
+ # @return [Integer]
1432
+ #
1402
1433
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CreateAutoScalingGroupType AWS API Documentation
1403
1434
  #
1404
1435
  class CreateAutoScalingGroupType < Struct.new(
@@ -1426,7 +1457,8 @@ module Aws::AutoScaling
1426
1457
  :service_linked_role_arn,
1427
1458
  :max_instance_lifetime,
1428
1459
  :context,
1429
- :desired_capacity_type)
1460
+ :desired_capacity_type,
1461
+ :default_instance_warmup)
1430
1462
  SENSITIVE = []
1431
1463
  include Aws::Structure
1432
1464
  end
@@ -1522,26 +1554,25 @@ module Aws::AutoScaling
1522
1554
  # @return [Array<String>]
1523
1555
  #
1524
1556
  # @!attribute [rw] classic_link_vpc_id
1557
+ # *EC2-Classic retires on August 15, 2022. This parameter is not
1558
+ # supported after that date.*
1559
+ #
1525
1560
  # The ID of a ClassicLink-enabled VPC to link your EC2-Classic
1526
1561
  # instances to. For more information, see [ClassicLink][1] in the
1527
- # *Amazon EC2 User Guide for Linux Instances* and [Linking EC2-Classic
1528
- # instances to a VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
1529
- #
1530
- # This parameter can only be used if you are launching EC2-Classic
1531
- # instances.
1562
+ # *Amazon EC2 User Guide for Linux Instances*.
1532
1563
  #
1533
1564
  #
1534
1565
  #
1535
1566
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html
1536
- # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-ClassicLink
1537
1567
  # @return [String]
1538
1568
  #
1539
1569
  # @!attribute [rw] classic_link_vpc_security_groups
1570
+ # *EC2-Classic retires on August 15, 2022. This parameter is not
1571
+ # supported after that date.*
1572
+ #
1540
1573
  # The IDs of one or more security groups for the specified
1541
1574
  # ClassicLink-enabled VPC. For more information, see [ClassicLink][1]
1542
- # in the *Amazon EC2 User Guide for Linux Instances* and [Linking
1543
- # EC2-Classic instances to a VPC][2] in the *Amazon EC2 Auto Scaling
1544
- # User Guide*.
1575
+ # in the *Amazon EC2 User Guide for Linux Instances*.
1545
1576
  #
1546
1577
  # If you specify the `ClassicLinkVPCId` parameter, you must specify
1547
1578
  # this parameter.
@@ -1549,7 +1580,6 @@ module Aws::AutoScaling
1549
1580
  #
1550
1581
  #
1551
1582
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html
1552
- # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-ClassicLink
1553
1583
  # @return [Array<String>]
1554
1584
  #
1555
1585
  # @!attribute [rw] user_data
@@ -4488,29 +4518,19 @@ module Aws::AutoScaling
4488
4518
  # @return [Array<String>]
4489
4519
  #
4490
4520
  # @!attribute [rw] classic_link_vpc_id
4491
- # The ID of a ClassicLink-enabled VPC to link your EC2-Classic
4492
- # instances to. For more information, see [ClassicLink][1] in the
4493
- # *Amazon EC2 User Guide for Linux Instances* and [Linking EC2-Classic
4494
- # instances to a VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
4495
- #
4496
- #
4521
+ # *EC2-Classic retires on August 15, 2022. This parameter is not
4522
+ # supported after that date.*
4497
4523
  #
4498
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html
4499
- # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-ClassicLink
4524
+ # The ID of a ClassicLink-enabled VPC to link your EC2-Classic
4525
+ # instances to.
4500
4526
  # @return [String]
4501
4527
  #
4502
4528
  # @!attribute [rw] classic_link_vpc_security_groups
4529
+ # *EC2-Classic retires on August 15, 2022. This parameter is not
4530
+ # supported after that date.*
4531
+ #
4503
4532
  # The IDs of one or more security groups for the VPC specified in
4504
4533
  # `ClassicLinkVPCId`.
4505
- #
4506
- # For more information, see [ClassicLink][1] in the *Amazon EC2 User
4507
- # Guide for Linux Instances* and [Linking EC2-Classic instances to a
4508
- # VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
4509
- #
4510
- #
4511
- #
4512
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html
4513
- # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-ClassicLink
4514
4534
  # @return [Array<String>]
4515
4535
  #
4516
4536
  # @!attribute [rw] user_data
@@ -5095,10 +5115,9 @@ module Aws::AutoScaling
5095
5115
  # @return [Integer]
5096
5116
  #
5097
5117
  # @!attribute [rw] global_timeout
5098
- # The maximum time, in seconds, that an instance can remain in a
5099
- # `Pending:Wait` or `Terminating:Wait` state. The maximum is 172800
5100
- # seconds (48 hours) or 100 times `HeartbeatTimeout`, whichever is
5101
- # smaller.
5118
+ # The maximum time, in seconds, that an instance can remain in a wait
5119
+ # state. The maximum is 172800 seconds (48 hours) or 100 times
5120
+ # `HeartbeatTimeout`, whichever is smaller.
5102
5121
  # @return [Integer]
5103
5122
  #
5104
5123
  # @!attribute [rw] default_result
@@ -5936,14 +5955,14 @@ module Aws::AutoScaling
5936
5955
  # * `ASGAverageCPUUtilization` - Average CPU utilization of the Auto
5937
5956
  # Scaling group.
5938
5957
  #
5939
- # * `ASGAverageNetworkIn` - Average number of bytes received (per
5940
- # instance per minute) for the Auto Scaling group.
5958
+ # * `ASGAverageNetworkIn` - Average number of bytes received on all
5959
+ # network interfaces by the Auto Scaling group.
5941
5960
  #
5942
- # * `ASGAverageNetworkOut` - Average number of bytes sent out (per
5943
- # instance per minute) for the Auto Scaling group.
5961
+ # * `ASGAverageNetworkOut` - Average number of bytes sent out on all
5962
+ # network interfaces by the Auto Scaling group.
5944
5963
  #
5945
5964
  # * `ALBRequestCountPerTarget` - Average Application Load Balancer
5946
- # request count (per target per minute) for your Auto Scaling group.
5965
+ # request count per target for your Auto Scaling group.
5947
5966
  # @return [String]
5948
5967
  #
5949
5968
  # @!attribute [rw] resource_label
@@ -7065,14 +7084,16 @@ module Aws::AutoScaling
7065
7084
  # @return [Integer]
7066
7085
  #
7067
7086
  # @!attribute [rw] cooldown
7068
- # The duration of the policy's cooldown period, in seconds. When a
7069
- # cooldown period is specified here, it overrides the default cooldown
7070
- # period defined for the Auto Scaling group.
7087
+ # A cooldown period, in seconds, that applies to a specific simple
7088
+ # scaling policy. When a cooldown period is specified here, it
7089
+ # overrides the default cooldown.
7071
7090
  #
7072
7091
  # Valid only if the policy type is `SimpleScaling`. For more
7073
7092
  # information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1]
7074
7093
  # in the *Amazon EC2 Auto Scaling User Guide*.
7075
7094
  #
7095
+ # Default: None
7096
+ #
7076
7097
  #
7077
7098
  #
7078
7099
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/Cooldown.html
@@ -7095,13 +7116,24 @@ module Aws::AutoScaling
7095
7116
  # @return [Array<Types::StepAdjustment>]
7096
7117
  #
7097
7118
  # @!attribute [rw] estimated_instance_warmup
7119
+ # *Not needed if the default instance warmup is defined for the
7120
+ # group.*
7121
+ #
7098
7122
  # The estimated time, in seconds, until a newly launched instance can
7099
- # contribute to the CloudWatch metrics. If not provided, the default
7100
- # is to use the value from the default cooldown period for the Auto
7101
- # Scaling group.
7123
+ # contribute to the CloudWatch metrics. This warm-up period applies to
7124
+ # instances launched due to a specific target tracking or step scaling
7125
+ # policy. When a warm-up period is specified here, it overrides the
7126
+ # default instance warmup.
7102
7127
  #
7103
7128
  # Valid only if the policy type is `TargetTrackingScaling` or
7104
7129
  # `StepScaling`.
7130
+ #
7131
+ # <note markdown="1"> The default is to use the value for the default instance warmup
7132
+ # defined for the group. If default instance warmup is null, then
7133
+ # `EstimatedInstanceWarmup` falls back to the value of default
7134
+ # cooldown.
7135
+ #
7136
+ # </note>
7105
7137
  # @return [Integer]
7106
7138
  #
7107
7139
  # @!attribute [rw] target_tracking_configuration
@@ -7422,11 +7454,11 @@ module Aws::AutoScaling
7422
7454
  # }
7423
7455
  #
7424
7456
  # @!attribute [rw] min_healthy_percentage
7425
- # The amount of capacity in the Auto Scaling group that must remain
7426
- # healthy during an instance refresh to allow the operation to
7427
- # continue. The value is expressed as a percentage of the desired
7428
- # capacity of the Auto Scaling group (rounded up to the nearest
7429
- # integer). The default is `90`.
7457
+ # The amount of capacity in the Auto Scaling group that must pass your
7458
+ # group's health checks to allow the operation to continue. The value
7459
+ # is expressed as a percentage of the desired capacity of the Auto
7460
+ # Scaling group (rounded up to the nearest integer). The default is
7461
+ # `90`.
7430
7462
  #
7431
7463
  # Setting the minimum healthy percentage to 100 percent limits the
7432
7464
  # rate of replacement to one instance at a time. In contrast, setting
@@ -7435,10 +7467,17 @@ module Aws::AutoScaling
7435
7467
  # @return [Integer]
7436
7468
  #
7437
7469
  # @!attribute [rw] instance_warmup
7438
- # The number of seconds until a newly launched instance is configured
7439
- # and ready to use. During this time, Amazon EC2 Auto Scaling does not
7440
- # immediately move on to the next replacement. The default is to use
7441
- # the value for the health check grace period defined for the group.
7470
+ # *Not needed if the default instance warmup is defined for the
7471
+ # group.*
7472
+ #
7473
+ # The duration of the instance warmup, in seconds.
7474
+ #
7475
+ # <note markdown="1"> The default is to use the value for the default instance warmup
7476
+ # defined for the group. If default instance warmup is null, then
7477
+ # `InstanceWarmup` falls back to the value of the health check grace
7478
+ # period.
7479
+ #
7480
+ # </note>
7442
7481
  # @return [Integer]
7443
7482
  #
7444
7483
  # @!attribute [rw] checkpoint_percentages
@@ -8605,6 +8644,7 @@ module Aws::AutoScaling
8605
8644
  # capacity_rebalance: false,
8606
8645
  # context: "Context",
8607
8646
  # desired_capacity_type: "XmlStringMaxLen255",
8647
+ # default_instance_warmup: 1,
8608
8648
  # }
8609
8649
  #
8610
8650
  # @!attribute [rw] auto_scaling_group_name
@@ -8660,10 +8700,10 @@ module Aws::AutoScaling
8660
8700
  # @return [Integer]
8661
8701
  #
8662
8702
  # @!attribute [rw] default_cooldown
8663
- # The amount of time, in seconds, after a scaling activity completes
8664
- # before another scaling activity can start. The default value is
8665
- # `300`. This setting applies when using simple scaling policies, but
8666
- # not when using other scaling policies or scheduled scaling. For more
8703
+ # *Only needed if you use simple scaling policies.*
8704
+ #
8705
+ # The amount of time, in seconds, between one scaling activity ending
8706
+ # and another one starting due to simple scaling policies. For more
8667
8707
  # information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1]
8668
8708
  # in the *Amazon EC2 Auto Scaling User Guide*.
8669
8709
  #
@@ -8686,11 +8726,11 @@ module Aws::AutoScaling
8686
8726
  # @!attribute [rw] health_check_grace_period
8687
8727
  # The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
8688
8728
  # before checking the health status of an EC2 instance that has come
8689
- # into service and marking it unhealthy due to a failed health check.
8690
- # The default value is `0`. For more information, see [Health check
8691
- # grace period][1] in the *Amazon EC2 Auto Scaling User Guide*.
8692
- #
8693
- # Required if you are adding an `ELB` health check.
8729
+ # into service and marking it unhealthy due to a failed Elastic Load
8730
+ # Balancing or custom health check. This is useful if your instances
8731
+ # do not immediately pass these health checks after they enter the
8732
+ # `InService` state. For more information, see [Health check grace
8733
+ # period][1] in the *Amazon EC2 Auto Scaling User Guide*.
8694
8734
  #
8695
8735
  #
8696
8736
  #
@@ -8699,11 +8739,14 @@ module Aws::AutoScaling
8699
8739
  #
8700
8740
  # @!attribute [rw] placement_group
8701
8741
  # The name of an existing placement group into which to launch your
8702
- # instances, if any. A placement group is a logical grouping of
8703
- # instances within a single Availability Zone. You cannot specify
8704
- # multiple Availability Zones and a placement group. For more
8705
- # information, see [Placement Groups][1] in the *Amazon EC2 User Guide
8706
- # for Linux Instances*.
8742
+ # instances. For more information, see [Placement groups][1] in the
8743
+ # *Amazon EC2 User Guide for Linux Instances*.
8744
+ #
8745
+ # <note markdown="1"> A *cluster* placement group is a logical grouping of instances
8746
+ # within a single Availability Zone. You cannot specify multiple
8747
+ # Availability Zones and a cluster placement group.
8748
+ #
8749
+ # </note>
8707
8750
  #
8708
8751
  #
8709
8752
  #
@@ -8796,6 +8839,33 @@ module Aws::AutoScaling
8796
8839
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-instance-type-requirements.html
8797
8840
  # @return [String]
8798
8841
  #
8842
+ # @!attribute [rw] default_instance_warmup
8843
+ # The amount of time, in seconds, until a newly launched instance can
8844
+ # contribute to the Amazon CloudWatch metrics. This delay lets an
8845
+ # instance finish initializing before Amazon EC2 Auto Scaling
8846
+ # aggregates instance metrics, resulting in more reliable usage data.
8847
+ # Set this value equal to the amount of time that it takes for
8848
+ # resource consumption to become stable after an instance reaches the
8849
+ # `InService` state. For more information, see [Set the default
8850
+ # instance warmup for an Auto Scaling group][1] in the *Amazon EC2
8851
+ # Auto Scaling User Guide*.
8852
+ #
8853
+ # To manage your warm-up settings at the group level, we recommend
8854
+ # that you set the default instance warmup, *even if its value is set
8855
+ # to 0 seconds*. This also optimizes the performance of scaling
8856
+ # policies that scale continuously, such as target tracking and step
8857
+ # scaling policies.
8858
+ #
8859
+ # If you need to remove a value that you previously set, include the
8860
+ # property but specify `-1` for the value. However, we strongly
8861
+ # recommend keeping the default instance warmup enabled by specifying
8862
+ # a minimum value of `0`.
8863
+ #
8864
+ #
8865
+ #
8866
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-default-instance-warmup.html
8867
+ # @return [Integer]
8868
+ #
8799
8869
  # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/UpdateAutoScalingGroupType AWS API Documentation
8800
8870
  #
8801
8871
  class UpdateAutoScalingGroupType < Struct.new(
@@ -8818,7 +8888,8 @@ module Aws::AutoScaling
8818
8888
  :max_instance_lifetime,
8819
8889
  :capacity_rebalance,
8820
8890
  :context,
8821
- :desired_capacity_type)
8891
+ :desired_capacity_type,
8892
+ :default_instance_warmup)
8822
8893
  SENSITIVE = []
8823
8894
  include Aws::Structure
8824
8895
  end
@@ -59,6 +59,6 @@ require_relative 'aws-sdk-autoscaling/customizations'
59
59
  # @!group service
60
60
  module Aws::AutoScaling
61
61
 
62
- GEM_VERSION = '1.78.0'
62
+ GEM_VERSION = '1.79.0'
63
63
 
64
64
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-autoscaling
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.78.0
4
+ version: 1.79.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2022-02-24 00:00:00.000000000 Z
11
+ date: 2022-04-19 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core