aws-sdk-autoscaling 1.76.0 → 1.79.0

data/lib/aws-sdk-autoscaling/client.rb

@@ -27,7 +27,9 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
 require 'aws-sdk-core/plugins/http_checksum.rb'
+require 'aws-sdk-core/plugins/checksum_algorithm.rb'
 require 'aws-sdk-core/plugins/defaults_mode.rb'
+require 'aws-sdk-core/plugins/recursion_detection.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/query.rb'
 
@@ -74,7 +76,9 @@ module Aws::AutoScaling
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
+    add_plugin(Aws::Plugins::ChecksumAlgorithm)
     add_plugin(Aws::Plugins::DefaultsMode)
+    add_plugin(Aws::Plugins::RecursionDetection)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::Query)
 
@@ -676,22 +680,26 @@ module Aws::AutoScaling
     # This step is a part of the procedure for adding a lifecycle hook to an
     # Auto Scaling group:
     #
-    # 1.  (Optional) Create a Lambda function and a rule that allows Amazon
-    #     EventBridge to invoke your Lambda function when Amazon EC2 Auto
-    #     Scaling launches or terminates instances.
+    # 1.  (Optional) Create a launch template or launch configuration with a
+    #     user data script that runs while an instance is in a wait state
+    #     due to a lifecycle hook.
     #
-    # 2.  (Optional) Create a notification target and an IAM role. The
+    # 2.  (Optional) Create a Lambda function and a rule that allows Amazon
+    #     EventBridge to invoke your Lambda function when an instance is put
+    #     into a wait state due to a lifecycle hook.
+    #
+    # 3.  (Optional) Create a notification target and an IAM role. The
     #     target can be either an Amazon SQS queue or an Amazon SNS topic.
     #     The role allows Amazon EC2 Auto Scaling to publish lifecycle
     #     notifications to the target.
     #
-    # 3.  Create the lifecycle hook. Specify whether the hook is used when
+    # 4.  Create the lifecycle hook. Specify whether the hook is used when
     #     the instances launch or terminate.
     #
-    # 4.  If you need more time, record the lifecycle action heartbeat to
-    #     keep the instance in a pending state.
+    # 5.  If you need more time, record the lifecycle action heartbeat to
+    #     keep the instance in a wait state.
     #
-    # 5.  **If you finish before the timeout period ends, send a callback by
+    # 6.  **If you finish before the timeout period ends, send a callback by
     #     using the CompleteLifecycleAction API call.**
     #
     # For more information, see [Amazon EC2 Auto Scaling lifecycle hooks][1]
@@ -864,13 +872,15 @@ module Aws::AutoScaling
     #   group.
     #
     # @option params [Integer] :default_cooldown
-    #   The amount of time, in seconds, after a scaling activity completes
-    #   before another scaling activity can start. The default value is `300`.
-    #   This setting applies when using simple scaling policies, but not when
-    #   using other scaling policies or scheduled scaling. For more
+    #   *Only needed if you use simple scaling policies.*
+    #
+    #   The amount of time, in seconds, between one scaling activity ending
+    #   and another one starting due to simple scaling policies. For more
     #   information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1] in
     #   the *Amazon EC2 Auto Scaling User Guide*.
     #
+    #   Default: `300` seconds
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/Cooldown.html
@@ -913,13 +923,17 @@ module Aws::AutoScaling
     #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html
     #
     # @option params [Integer] :health_check_grace_period
+    #   **
+    #
     #   The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
     #   before checking the health status of an EC2 instance that has come
-    #   into service and marking it unhealthy due to a failed health check.
-    #   The default value is `0`. For more information, see [Health check
-    #   grace period][1] in the *Amazon EC2 Auto Scaling User Guide*.
+    #   into service and marking it unhealthy due to a failed Elastic Load
+    #   Balancing or custom health check. This is useful if your instances do
+    #   not immediately pass these health checks after they enter the
+    #   `InService` state. For more information, see [Health check grace
+    #   period][1] in the *Amazon EC2 Auto Scaling User Guide*.
     #
-    #   Conditional: Required if you are adding an `ELB` health check.
+    #   Default: `0` seconds
     #
     #
     #
@@ -927,11 +941,14 @@ module Aws::AutoScaling
     #
     # @option params [String] :placement_group
     #   The name of an existing placement group into which to launch your
-    #   instances, if any. A placement group is a logical grouping of
-    #   instances within a single Availability Zone. You cannot specify
-    #   multiple Availability Zones and a placement group. For more
-    #   information, see [Placement Groups][1] in the *Amazon EC2 User Guide
-    #   for Linux Instances*.
+    #   instances. For more information, see [Placement groups][1] in the
+    #   *Amazon EC2 User Guide for Linux Instances*.
+    #
+    #   <note markdown="1"> A *cluster* placement group is a logical grouping of instances within
+    #   a single Availability Zone. You cannot specify multiple Availability
+    #   Zones and a cluster placement group.
+    #
+    #    </note>
     #
     #
     #
@@ -1043,6 +1060,32 @@ module Aws::AutoScaling
     #
     #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-instance-type-requirements.html
     #
+    # @option params [Integer] :default_instance_warmup
+    #   The amount of time, in seconds, until a newly launched instance can
+    #   contribute to the Amazon CloudWatch metrics. This delay lets an
+    #   instance finish initializing before Amazon EC2 Auto Scaling aggregates
+    #   instance metrics, resulting in more reliable usage data. Set this
+    #   value equal to the amount of time that it takes for resource
+    #   consumption to become stable after an instance reaches the `InService`
+    #   state. For more information, see [Set the default instance warmup for
+    #   an Auto Scaling group][1] in the *Amazon EC2 Auto Scaling User Guide*.
+    #
+    #   To manage your warm-up settings at the group level, we recommend that
+    #   you set the default instance warmup, *even if its value is set to 0
+    #   seconds*. This also optimizes the performance of scaling policies that
+    #   scale continuously, such as target tracking and step scaling policies.
+    #
+    #    If you need to remove a value that you previously set, include the
+    #   property but specify `-1` for the value. However, we strongly
+    #   recommend keeping the default instance warmup enabled by specifying a
+    #   minimum value of `0`.
+    #
+    #   Default: None
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-default-instance-warmup.html
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     #
@@ -1053,7 +1096,7 @@ module Aws::AutoScaling
     #   resp = client.create_auto_scaling_group({
     #     auto_scaling_group_name: "my-auto-scaling-group", 
     #     launch_template: {
-    #       launch_template_id: "lt-0a20c965061f64abc", 
+    #       launch_template_name: "my-template-for-auto-scaling", 
     #       version: "$Latest", 
     #     }, 
     #     max_instance_lifetime: 2592000, 
@@ -1071,8 +1114,8 @@ module Aws::AutoScaling
     #     health_check_grace_period: 300, 
     #     health_check_type: "ELB", 
     #     launch_template: {
-    #       launch_template_id: "lt-0a20c965061f64abc", 
-    #       version: "$Default", 
+    #       launch_template_name: "my-template-for-auto-scaling", 
+    #       version: "$Latest", 
     #     }, 
     #     max_size: 3, 
     #     min_size: 1, 
@@ -1247,6 +1290,7 @@ module Aws::AutoScaling
     #     max_instance_lifetime: 1,
     #     context: "Context",
     #     desired_capacity_type: "XmlStringMaxLen255",
+    #     default_instance_warmup: 1,
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CreateAutoScalingGroup AWS API Documentation
@@ -1314,25 +1358,24 @@ module Aws::AutoScaling
     #   [2]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-network-security.html
     #
     # @option params [String] :classic_link_vpc_id
+    #   *EC2-Classic retires on August 15, 2022. This parameter is not
+    #   supported after that date.*
+    #
     #   The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances
     #   to. For more information, see [ClassicLink][1] in the *Amazon EC2 User
-    #   Guide for Linux Instances* and [Linking EC2-Classic instances to a
-    #   VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
-    #
-    #   This parameter can only be used if you are launching EC2-Classic
-    #   instances.
+    #   Guide for Linux Instances*.
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html
-    #   [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-ClassicLink
     #
     # @option params [Array<String>] :classic_link_vpc_security_groups
+    #   *EC2-Classic retires on August 15, 2022. This parameter is not
+    #   supported after that date.*
+    #
     #   The IDs of one or more security groups for the specified
     #   ClassicLink-enabled VPC. For more information, see [ClassicLink][1] in
-    #   the *Amazon EC2 User Guide for Linux Instances* and [Linking
-    #   EC2-Classic instances to a VPC][2] in the *Amazon EC2 Auto Scaling
-    #   User Guide*.
+    #   the *Amazon EC2 User Guide for Linux Instances*.
     #
     #   If you specify the `ClassicLinkVPCId` parameter, you must specify this
     #   parameter.
@@ -1340,7 +1383,6 @@ module Aws::AutoScaling
     #
     #
     #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html
-    #   [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-ClassicLink
     #
     # @option params [String] :user_data
     #   The user data to make available to the launched EC2 instances. For
@@ -2282,7 +2324,7 @@ module Aws::AutoScaling
     #   resp.auto_scaling_groups[0].instances[0].instance_id #=> String
     #   resp.auto_scaling_groups[0].instances[0].instance_type #=> String
     #   resp.auto_scaling_groups[0].instances[0].availability_zone #=> String
-    #   resp.auto_scaling_groups[0].instances[0].lifecycle_state #=> String, one of "Pending", "Pending:Wait", "Pending:Proceed", "Quarantined", "InService", "Terminating", "Terminating:Wait", "Terminating:Proceed", "Terminated", "Detaching", "Detached", "EnteringStandby", "Standby", "Warmed:Pending", "Warmed:Pending:Wait", "Warmed:Pending:Proceed", "Warmed:Terminating", "Warmed:Terminating:Wait", "Warmed:Terminating:Proceed", "Warmed:Terminated", "Warmed:Stopped", "Warmed:Running"
+    #   resp.auto_scaling_groups[0].instances[0].lifecycle_state #=> String, one of "Pending", "Pending:Wait", "Pending:Proceed", "Quarantined", "InService", "Terminating", "Terminating:Wait", "Terminating:Proceed", "Terminated", "Detaching", "Detached", "EnteringStandby", "Standby", "Warmed:Pending", "Warmed:Pending:Wait", "Warmed:Pending:Proceed", "Warmed:Terminating", "Warmed:Terminating:Wait", "Warmed:Terminating:Proceed", "Warmed:Terminated", "Warmed:Stopped", "Warmed:Running", "Warmed:Hibernated"
     #   resp.auto_scaling_groups[0].instances[0].health_status #=> String
     #   resp.auto_scaling_groups[0].instances[0].launch_configuration_name #=> String
     #   resp.auto_scaling_groups[0].instances[0].launch_template.launch_template_id #=> String
@@ -2314,11 +2356,13 @@ module Aws::AutoScaling
     #   resp.auto_scaling_groups[0].capacity_rebalance #=> Boolean
     #   resp.auto_scaling_groups[0].warm_pool_configuration.max_group_prepared_capacity #=> Integer
     #   resp.auto_scaling_groups[0].warm_pool_configuration.min_size #=> Integer
-    #   resp.auto_scaling_groups[0].warm_pool_configuration.pool_state #=> String, one of "Stopped", "Running"
+    #   resp.auto_scaling_groups[0].warm_pool_configuration.pool_state #=> String, one of "Stopped", "Running", "Hibernated"
     #   resp.auto_scaling_groups[0].warm_pool_configuration.status #=> String, one of "PendingDelete"
+    #   resp.auto_scaling_groups[0].warm_pool_configuration.instance_reuse_policy.reuse_on_scale_in #=> Boolean
     #   resp.auto_scaling_groups[0].warm_pool_size #=> Integer
     #   resp.auto_scaling_groups[0].context #=> String
     #   resp.auto_scaling_groups[0].desired_capacity_type #=> String
+    #   resp.auto_scaling_groups[0].default_instance_warmup #=> Integer
     #   resp.next_token #=> String
     #
     #
@@ -3829,13 +3873,14 @@ module Aws::AutoScaling
     #
     #   resp.warm_pool_configuration.max_group_prepared_capacity #=> Integer
     #   resp.warm_pool_configuration.min_size #=> Integer
-    #   resp.warm_pool_configuration.pool_state #=> String, one of "Stopped", "Running"
+    #   resp.warm_pool_configuration.pool_state #=> String, one of "Stopped", "Running", "Hibernated"
     #   resp.warm_pool_configuration.status #=> String, one of "PendingDelete"
+    #   resp.warm_pool_configuration.instance_reuse_policy.reuse_on_scale_in #=> Boolean
     #   resp.instances #=> Array
     #   resp.instances[0].instance_id #=> String
     #   resp.instances[0].instance_type #=> String
     #   resp.instances[0].availability_zone #=> String
-    #   resp.instances[0].lifecycle_state #=> String, one of "Pending", "Pending:Wait", "Pending:Proceed", "Quarantined", "InService", "Terminating", "Terminating:Wait", "Terminating:Proceed", "Terminated", "Detaching", "Detached", "EnteringStandby", "Standby", "Warmed:Pending", "Warmed:Pending:Wait", "Warmed:Pending:Proceed", "Warmed:Terminating", "Warmed:Terminating:Wait", "Warmed:Terminating:Proceed", "Warmed:Terminated", "Warmed:Stopped", "Warmed:Running"
+    #   resp.instances[0].lifecycle_state #=> String, one of "Pending", "Pending:Wait", "Pending:Proceed", "Quarantined", "InService", "Terminating", "Terminating:Wait", "Terminating:Proceed", "Terminated", "Detaching", "Detached", "EnteringStandby", "Standby", "Warmed:Pending", "Warmed:Pending:Wait", "Warmed:Pending:Proceed", "Warmed:Terminating", "Warmed:Terminating:Wait", "Warmed:Terminating:Proceed", "Warmed:Terminated", "Warmed:Stopped", "Warmed:Running", "Warmed:Hibernated"
     #   resp.instances[0].health_status #=> String
     #   resp.instances[0].launch_configuration_name #=> String
     #   resp.instances[0].launch_template.launch_template_id #=> String
@@ -4586,30 +4631,34 @@ module Aws::AutoScaling
     # Creates or updates a lifecycle hook for the specified Auto Scaling
     # group.
     #
-    # A lifecycle hook enables an Auto Scaling group to be aware of events
-    # in the Auto Scaling instance lifecycle, and then perform a custom
-    # action when the corresponding lifecycle event occurs.
+    # Lifecycle hooks let you create solutions that are aware of events in
+    # the Auto Scaling instance lifecycle, and then perform a custom action
+    # on instances when the corresponding lifecycle event occurs.
     #
     # This step is a part of the procedure for adding a lifecycle hook to an
     # Auto Scaling group:
     #
-    # 1.  (Optional) Create a Lambda function and a rule that allows Amazon
-    #     EventBridge to invoke your Lambda function when Amazon EC2 Auto
-    #     Scaling launches or terminates instances.
+    # 1.  (Optional) Create a launch template or launch configuration with a
+    #     user data script that runs while an instance is in a wait state
+    #     due to a lifecycle hook.
     #
-    # 2.  (Optional) Create a notification target and an IAM role. The
+    # 2.  (Optional) Create a Lambda function and a rule that allows Amazon
+    #     EventBridge to invoke your Lambda function when an instance is put
+    #     into a wait state due to a lifecycle hook.
+    #
+    # 3.  (Optional) Create a notification target and an IAM role. The
     #     target can be either an Amazon SQS queue or an Amazon SNS topic.
     #     The role allows Amazon EC2 Auto Scaling to publish lifecycle
     #     notifications to the target.
     #
-    # 3.  **Create the lifecycle hook. Specify whether the hook is used when
+    # 4.  **Create the lifecycle hook. Specify whether the hook is used when
     #     the instances launch or terminate.**
     #
-    # 4.  If you need more time, record the lifecycle action heartbeat to
-    #     keep the instance in a pending state using the
+    # 5.  If you need more time, record the lifecycle action heartbeat to
+    #     keep the instance in a wait state using the
     #     RecordLifecycleActionHeartbeat API call.
     #
-    # 5.  If you finish before the timeout period ends, send a callback by
+    # 6.  If you finish before the timeout period ends, send a callback by
     #     using the CompleteLifecycleAction API call.
     #
     # For more information, see [Amazon EC2 Auto Scaling lifecycle hooks][1]
@@ -4646,11 +4695,11 @@ module Aws::AutoScaling
     #
     # @option params [String] :role_arn
     #   The ARN of the IAM role that allows the Auto Scaling group to publish
-    #   to the specified notification target, for example, an Amazon SNS topic
-    #   or an Amazon SQS queue.
+    #   to the specified notification target.
     #
-    #   Required for new lifecycle hooks, but optional when updating existing
-    #   hooks.
+    #   Valid only if the notification target is an Amazon SNS topic or an
+    #   Amazon SQS queue. Required for new lifecycle hooks, but optional when
+    #   updating existing hooks.
     #
     # @option params [String] :notification_target_arn
     #   The ARN of the notification target that Amazon EC2 Auto Scaling uses
@@ -4691,16 +4740,16 @@ module Aws::AutoScaling
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     #
-    # @example Example: To create a lifecycle hook
+    # @example Example: To create a launch lifecycle hook
     #
-    #   # This example creates a lifecycle hook.
+    #   # This example creates a lifecycle hook for instance launch.
     #
     #   resp = client.put_lifecycle_hook({
     #     auto_scaling_group_name: "my-auto-scaling-group", 
-    #     lifecycle_hook_name: "my-lifecycle-hook", 
+    #     default_result: "CONTINUE", 
+    #     heartbeat_timeout: 300, 
+    #     lifecycle_hook_name: "my-launch-lifecycle-hook", 
     #     lifecycle_transition: "autoscaling:EC2_INSTANCE_LAUNCHING", 
-    #     notification_target_arn: "arn:aws:sns:us-west-2:123456789012:my-sns-topic --role-arn", 
-    #     role_arn: "arn:aws:iam::123456789012:role/my-auto-scaling-role", 
     #   })
     #
     # @example Request syntax with placeholder values
@@ -4876,14 +4925,16 @@ module Aws::AutoScaling
     #   other policy type.)
     #
     # @option params [Integer] :cooldown
-    #   The duration of the policy's cooldown period, in seconds. When a
-    #   cooldown period is specified here, it overrides the default cooldown
-    #   period defined for the Auto Scaling group.
+    #   A cooldown period, in seconds, that applies to a specific simple
+    #   scaling policy. When a cooldown period is specified here, it overrides
+    #   the default cooldown.
     #
     #   Valid only if the policy type is `SimpleScaling`. For more
     #   information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1] in
     #   the *Amazon EC2 Auto Scaling User Guide*.
     #
+    #   Default: None
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/Cooldown.html
@@ -4903,14 +4954,23 @@ module Aws::AutoScaling
     #   policy type.)
     #
     # @option params [Integer] :estimated_instance_warmup
+    #   *Not needed if the default instance warmup is defined for the group.*
+    #
     #   The estimated time, in seconds, until a newly launched instance can
-    #   contribute to the CloudWatch metrics. If not provided, the default is
-    #   to use the value from the default cooldown period for the Auto Scaling
-    #   group.
+    #   contribute to the CloudWatch metrics. This warm-up period applies to
+    #   instances launched due to a specific target tracking or step scaling
+    #   policy. When a warm-up period is specified here, it overrides the
+    #   default instance warmup.
     #
     #   Valid only if the policy type is `TargetTrackingScaling` or
     #   `StepScaling`.
     #
+    #   <note markdown="1"> The default is to use the value for the default instance warmup
+    #   defined for the group. If default instance warmup is null, then
+    #   `EstimatedInstanceWarmup` falls back to the value of default cooldown.
+    #
+    #    </note>
+    #
     # @option params [Types::TargetTrackingConfiguration] :target_tracking_configuration
     #   A target tracking scaling policy. Provides support for predefined or
     #   custom metrics.
@@ -5334,17 +5394,25 @@ module Aws::AutoScaling
     #   Sets the instance state to transition to after the lifecycle actions
     #   are complete. Default is `Stopped`.
     #
+    # @option params [Types::InstanceReusePolicy] :instance_reuse_policy
+    #   Indicates whether instances in the Auto Scaling group can be returned
+    #   to the warm pool on scale in. The default is to terminate instances in
+    #   the Auto Scaling group when the group scales in.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     #
-    # @example Example: To add a warm pool to an Auto Scaling group
+    # @example Example: To create a warm pool for an Auto Scaling group
     #
-    #   # This example adds a warm pool to the specified Auto Scaling group.
+    #   # This example creates a warm pool for the specified Auto Scaling group.
     #
     #   resp = client.put_warm_pool({
     #     auto_scaling_group_name: "my-auto-scaling-group", 
+    #     instance_reuse_policy: {
+    #       reuse_on_scale_in: true, 
+    #     }, 
     #     min_size: 30, 
-    #     pool_state: "Stopped", 
+    #     pool_state: "Hibernated", 
     #   })
     #
     # @example Request syntax with placeholder values
@@ -5353,7 +5421,10 @@ module Aws::AutoScaling
     #     auto_scaling_group_name: "XmlStringMaxLen255", # required
     #     max_group_prepared_capacity: 1,
     #     min_size: 1,
-    #     pool_state: "Stopped", # accepts Stopped, Running
+    #     pool_state: "Stopped", # accepts Stopped, Running, Hibernated
+    #     instance_reuse_policy: {
+    #       reuse_on_scale_in: false,
+    #     },
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PutWarmPool AWS API Documentation
@@ -5372,22 +5443,26 @@ module Aws::AutoScaling
     # This step is a part of the procedure for adding a lifecycle hook to an
     # Auto Scaling group:
     #
-    # 1.  (Optional) Create a Lambda function and a rule that allows Amazon
-    #     EventBridge to invoke your Lambda function when Amazon EC2 Auto
-    #     Scaling launches or terminates instances.
+    # 1.  (Optional) Create a launch template or launch configuration with a
+    #     user data script that runs while an instance is in a wait state
+    #     due to a lifecycle hook.
     #
-    # 2.  (Optional) Create a notification target and an IAM role. The
+    # 2.  (Optional) Create a Lambda function and a rule that allows Amazon
+    #     EventBridge to invoke your Lambda function when an instance is put
+    #     into a wait state due to a lifecycle hook.
+    #
+    # 3.  (Optional) Create a notification target and an IAM role. The
     #     target can be either an Amazon SQS queue or an Amazon SNS topic.
     #     The role allows Amazon EC2 Auto Scaling to publish lifecycle
     #     notifications to the target.
     #
-    # 3.  Create the lifecycle hook. Specify whether the hook is used when
+    # 4.  Create the lifecycle hook. Specify whether the hook is used when
     #     the instances launch or terminate.
     #
-    # 4.  **If you need more time, record the lifecycle action heartbeat to
-    #     keep the instance in a pending state.**
+    # 5.  **If you need more time, record the lifecycle action heartbeat to
+    #     keep the instance in a wait state.**
     #
-    # 5.  If you finish before the timeout period ends, send a callback by
+    # 6.  If you finish before the timeout period ends, send a callback by
     #     using the CompleteLifecycleAction API call.
     #
     # For more information, see [Amazon EC2 Auto Scaling lifecycle hooks][1]
@@ -5768,9 +5843,16 @@ module Aws::AutoScaling
     #
     #   resp = client.start_instance_refresh({
     #     auto_scaling_group_name: "my-auto-scaling-group", 
+    #     desired_configuration: {
+    #       launch_template: {
+    #         launch_template_name: "my-template-for-auto-scaling", 
+    #         version: "$Latest", 
+    #       }, 
+    #     }, 
     #     preferences: {
     #       instance_warmup: 400, 
-    #       min_healthy_percentage: 50, 
+    #       min_healthy_percentage: 90, 
+    #       skip_matching: true, 
     #     }, 
     #   })
     #
@@ -6131,10 +6213,10 @@ module Aws::AutoScaling
     #   group.
     #
     # @option params [Integer] :default_cooldown
-    #   The amount of time, in seconds, after a scaling activity completes
-    #   before another scaling activity can start. The default value is `300`.
-    #   This setting applies when using simple scaling policies, but not when
-    #   using other scaling policies or scheduled scaling. For more
+    #   *Only needed if you use simple scaling policies.*
+    #
+    #   The amount of time, in seconds, between one scaling activity ending
+    #   and another one starting due to simple scaling policies. For more
     #   information, see [Scaling cooldowns for Amazon EC2 Auto Scaling][1] in
     #   the *Amazon EC2 Auto Scaling User Guide*.
     #
@@ -6154,11 +6236,11 @@ module Aws::AutoScaling
     # @option params [Integer] :health_check_grace_period
     #   The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
     #   before checking the health status of an EC2 instance that has come
-    #   into service and marking it unhealthy due to a failed health check.
-    #   The default value is `0`. For more information, see [Health check
-    #   grace period][1] in the *Amazon EC2 Auto Scaling User Guide*.
-    #
-    #   Conditional: Required if you are adding an `ELB` health check.
+    #   into service and marking it unhealthy due to a failed Elastic Load
+    #   Balancing or custom health check. This is useful if your instances do
+    #   not immediately pass these health checks after they enter the
+    #   `InService` state. For more information, see [Health check grace
+    #   period][1] in the *Amazon EC2 Auto Scaling User Guide*.
     #
     #
     #
@@ -6166,11 +6248,14 @@ module Aws::AutoScaling
     #
     # @option params [String] :placement_group
     #   The name of an existing placement group into which to launch your
-    #   instances, if any. A placement group is a logical grouping of
-    #   instances within a single Availability Zone. You cannot specify
-    #   multiple Availability Zones and a placement group. For more
-    #   information, see [Placement Groups][1] in the *Amazon EC2 User Guide
-    #   for Linux Instances*.
+    #   instances. For more information, see [Placement groups][1] in the
+    #   *Amazon EC2 User Guide for Linux Instances*.
+    #
+    #   <note markdown="1"> A *cluster* placement group is a logical grouping of instances within
+    #   a single Availability Zone. You cannot specify multiple Availability
+    #   Zones and a cluster placement group.
+    #
+    #    </note>
     #
     #
     #
@@ -6254,34 +6339,45 @@ module Aws::AutoScaling
     #
     #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-instance-type-requirements.html
     #
-    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    # @option params [Integer] :default_instance_warmup
+    #   The amount of time, in seconds, until a newly launched instance can
+    #   contribute to the Amazon CloudWatch metrics. This delay lets an
+    #   instance finish initializing before Amazon EC2 Auto Scaling aggregates
+    #   instance metrics, resulting in more reliable usage data. Set this
+    #   value equal to the amount of time that it takes for resource
+    #   consumption to become stable after an instance reaches the `InService`
+    #   state. For more information, see [Set the default instance warmup for
+    #   an Auto Scaling group][1] in the *Amazon EC2 Auto Scaling User Guide*.
     #
+    #   To manage your warm-up settings at the group level, we recommend that
+    #   you set the default instance warmup, *even if its value is set to 0
+    #   seconds*. This also optimizes the performance of scaling policies that
+    #   scale continuously, such as target tracking and step scaling policies.
     #
-    # @example Example: To update the launch configuration
+    #    If you need to remove a value that you previously set, include the
+    #   property but specify `-1` for the value. However, we strongly
+    #   recommend keeping the default instance warmup enabled by specifying a
+    #   minimum value of `0`.
     #
-    #   # This example updates the launch configuration of the specified Auto Scaling group.
     #
-    #   resp = client.update_auto_scaling_group({
-    #     auto_scaling_group_name: "my-auto-scaling-group", 
-    #     launch_configuration_name: "new-launch-config", 
-    #   })
     #
-    # @example Example: To update the minimum and maximum size
+    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-default-instance-warmup.html
     #
-    #   # This example updates the minimum size and maximum size of the specified Auto Scaling group.
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
-    #   resp = client.update_auto_scaling_group({
-    #     auto_scaling_group_name: "my-auto-scaling-group", 
-    #     max_size: 3, 
-    #     min_size: 1, 
-    #   })
     #
-    # @example Example: To enable instance protection
+    # @example Example: To update an Auto Scaling group
     #
-    #   # This example enables instance protection for the specified Auto Scaling group.
+    #   # This example updates multiple properties at the same time.
     #
     #   resp = client.update_auto_scaling_group({
     #     auto_scaling_group_name: "my-auto-scaling-group", 
+    #     launch_template: {
+    #       launch_template_name: "my-template-for-auto-scaling", 
+    #       version: "2", 
+    #     }, 
+    #     max_size: 5, 
+    #     min_size: 1, 
     #     new_instances_protected_from_scale_in: true, 
     #   })
     #
@@ -6386,6 +6482,7 @@ module Aws::AutoScaling
     #     capacity_rebalance: false,
     #     context: "Context",
     #     desired_capacity_type: "XmlStringMaxLen255",
+    #     default_instance_warmup: 1,
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/UpdateAutoScalingGroup AWS API Documentation
@@ -6410,7 +6507,7 @@ module Aws::AutoScaling
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-autoscaling'
-      context[:gem_version] = '1.76.0'
+      context[:gem_version] = '1.79.0'
       Seahorse::Client::Request.new(handlers, context)
     end