aws-sdk-autoscaling 1.37.0 → 1.42.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c086cea371c937d88a7b1b9cd28b169a8fef23dadad9c9319aca18d3945ef777
-  data.tar.gz: c880b97dcaef3184de0336b7b92e357025eca761e2e50b8cf3c8159561b6eba1
+  metadata.gz: e0786a9223123cef73c7b9c179e1aefe4c22900880442978300da566ab81af0f
+  data.tar.gz: 493f3aed7782bc6010212e04edf7df808e2fdea482b9a07584c4cfb148757669
 SHA512:
-  metadata.gz: 24ce25063ee1ded19008d85928963fa2ae354e1b64a5c5198fdcfb6fd5e97db4b3bf5aadaaf2eaa50dfaea6c22e7d09735e75adbfff3b8e08c17f7825fde7a92
-  data.tar.gz: 49caf7c247a7d223510b3d0cf4ce7b4c2cb8b804875c886cfe463f2c929d3cac89c3a04cda2344cf51111478920026cf0778493404fcd8227fc257f02ed20fbd
+  metadata.gz: bff7f98125203274c2b8a856732fa30cd93eae20ea58ca07b5a6df6bdea6600434c966c7418c2e21c91dee20ac0d57d692862e028c728b7ff710e616fa4e318e
+  data.tar.gz: e1a64dd69e5c839af9792f8142736e4200d2755908196d79c16bf0e329d00b1d42db206ea097882567895b53eb5083a9baec8f0c2c54f4d1192bdbc2d26cdfeb

data/lib/aws-sdk-autoscaling.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -56,6 +58,6 @@ require_relative 'aws-sdk-autoscaling/customizations'
 # @service
 module Aws::AutoScaling
 
-  GEM_VERSION = '1.37.0'
+  GEM_VERSION = '1.42.0'
 
 end

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -75,8 +77,7 @@ module Aws::AutoScaling
       data[:desired_capacity]
     end
 
-    # The amount of time, in seconds, after a scaling activity completes
-    # before another scaling activity can start.
+    # The duration of the default cooldown period, in seconds.
     # @return [Integer]
     def default_cooldown
       data[:default_cooldown]
@@ -583,15 +584,19 @@ module Aws::AutoScaling
     # @option options [required, String] :policy_name
     #   The name of the policy.
     # @option options [String] :policy_type
-    #   The policy type. The valid values are `SimpleScaling`, `StepScaling`,
-    #   and `TargetTrackingScaling`. If the policy type is null, the value is
-    #   treated as `SimpleScaling`.
+    #   One of the following policy types:
+    #
+    #   * `TargetTrackingScaling`
+    #
+    #   * `StepScaling`
+    #
+    #   * `SimpleScaling` (default)
     # @option options [String] :adjustment_type
-    #   Specifies whether the `ScalingAdjustment` parameter is an absolute
-    #   number or a percentage of the current capacity. The valid values are
+    #   Specifies how the scaling adjustment is interpreted (either an
+    #   absolute number or a percentage). The valid values are
     #   `ChangeInCapacity`, `ExactCapacity`, and `PercentChangeInCapacity`.
     #
-    #   Valid only if the policy type is `StepScaling` or `SimpleScaling`. For
+    #   Required if the policy type is `StepScaling` or `SimpleScaling`. For
     #   more information, see [Scaling Adjustment Types][1] in the *Amazon EC2
     #   Auto Scaling User Guide*.
     #
@@ -602,41 +607,43 @@ module Aws::AutoScaling
     #   Available for backward compatibility. Use `MinAdjustmentMagnitude`
     #   instead.
     # @option options [Integer] :min_adjustment_magnitude
-    #   The minimum value to scale by when scaling by percentages. For
-    #   example, suppose that you create a step scaling policy to scale out an
-    #   Auto Scaling group by 25 percent and you specify a
-    #   `MinAdjustmentMagnitude` of 2. If the group has 4 instances and the
-    #   scaling policy is performed, 25 percent of 4 is 1. However, because
-    #   you specified a `MinAdjustmentMagnitude` of 2, Amazon EC2 Auto Scaling
-    #   scales out the group by 2 instances.
-    #
-    #   Valid only if the policy type is `StepScaling` or `SimpleScaling` and
-    #   the adjustment type is `PercentChangeInCapacity`. For more
-    #   information, see [Scaling Adjustment Types][1] in the *Amazon EC2 Auto
-    #   Scaling User Guide*.
+    #   The minimum value to scale by when the adjustment type is
+    #   `PercentChangeInCapacity`. For example, suppose that you create a step
+    #   scaling policy to scale out an Auto Scaling group by 25 percent and
+    #   you specify a `MinAdjustmentMagnitude` of 2. If the group has 4
+    #   instances and the scaling policy is performed, 25 percent of 4 is 1.
+    #   However, because you specified a `MinAdjustmentMagnitude` of 2, Amazon
+    #   EC2 Auto Scaling scales out the group by 2 instances.
+    #
+    #   Valid only if the policy type is `StepScaling` or `SimpleScaling`. For
+    #   more information, see [Scaling Adjustment Types][1] in the *Amazon EC2
+    #   Auto Scaling User Guide*.
+    #
+    #   <note markdown="1"> Some Auto Scaling groups use instance weights. In this case, set the
+    #   `MinAdjustmentMagnitude` to a value that is at least as large as your
+    #   largest instance weight.
+    #
+    #    </note>
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-scaling-simple-step.html#as-scaling-adjustment
     # @option options [Integer] :scaling_adjustment
-    #   The amount by which a simple scaling policy scales the Auto Scaling
-    #   group in response to an alarm breach. The adjustment is based on the
-    #   value that you specified in the `AdjustmentType` parameter (either an
-    #   absolute number or a percentage). A positive value adds to the current
-    #   capacity and a negative value subtracts from the current capacity. For
-    #   exact capacity, you must specify a positive value.
-    #
-    #   Conditional: If you specify `SimpleScaling` for the policy type, you
-    #   must specify this parameter. (Not used with any other policy type.)
+    #   The amount by which to scale, based on the specified adjustment type.
+    #   A positive value adds to the current capacity while a negative number
+    #   removes from the current capacity. For exact capacity, you must
+    #   specify a positive value.
+    #
+    #   Required if the policy type is `SimpleScaling`. (Not used with any
+    #   other policy type.)
     # @option options [Integer] :cooldown
-    #   The amount of time, in seconds, after a scaling activity completes
-    #   before any further dynamic scaling activities can start. If this
-    #   parameter is not specified, the default cooldown period for the group
-    #   applies.
+    #   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.
     #
     #   Valid only if the policy type is `SimpleScaling`. For more
-    #   information, see [Scaling Cooldowns][1] in the *Amazon EC2 Auto
-    #   Scaling User Guide*.
+    #   information, see [Scaling Cooldowns for Amazon EC2 Auto Scaling][1] in
+    #   the *Amazon EC2 Auto Scaling User Guide*.
     #
     #
     #
@@ -651,25 +658,38 @@ module Aws::AutoScaling
     #   A set of adjustments that enable you to scale based on the size of the
     #   alarm breach.
     #
-    #   Conditional: If you specify `StepScaling` for the policy type, you
-    #   must specify this parameter. (Not used with any other policy type.)
+    #   Required if the policy type is `StepScaling`. (Not used with any other
+    #   policy type.)
     # @option options [Integer] :estimated_instance_warmup
     #   The estimated time, in seconds, until a newly launched instance can
-    #   contribute to the CloudWatch metrics. The default is to use the value
-    #   specified for the default cooldown period for the group.
+    #   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.
     #
-    #   Valid only if the policy type is `StepScaling` or
-    #   `TargetTrackingScaling`.
+    #   Valid only if the policy type is `TargetTrackingScaling` or
+    #   `StepScaling`.
     # @option options [Types::TargetTrackingConfiguration] :target_tracking_configuration
     #   A target tracking scaling policy. Includes support for predefined or
     #   customized metrics.
     #
+    #   The following predefined metrics are available:
+    #
+    #   * `ASGAverageCPUUtilization`
+    #
+    #   * `ASGAverageNetworkIn`
+    #
+    #   * `ASGAverageNetworkOut`
+    #
+    #   * `ALBRequestCountPerTarget`
+    #
+    #   If you specify `ALBRequestCountPerTarget` for the metric, you must
+    #   specify the `ResourceLabel` parameter with the
+    #   `PredefinedMetricSpecification`.
+    #
     #   For more information, see [TargetTrackingConfiguration][1] in the
     #   *Amazon EC2 Auto Scaling API Reference*.
     #
-    #   Conditional: If you specify `TargetTrackingScaling` for the policy
-    #   type, you must specify this parameter. (Not used with any other policy
-    #   type.)
+    #   Required if the policy type is `TargetTrackingScaling`.
     #
     #
     #
@@ -763,24 +783,27 @@ module Aws::AutoScaling
     #   })
     # @param [Hash] options ({})
     # @option options [Array<String>] :scaling_processes
-    #   One or more of the following processes. If you omit this parameter,
-    #   all processes are specified.
+    #   One or more of the following processes:
     #
     #   * `Launch`
     #
     #   * `Terminate`
     #
-    #   * `HealthCheck`
+    #   * `AddToLoadBalancer`
     #
-    #   * `ReplaceUnhealthy`
+    #   * `AlarmNotification`
     #
     #   * `AZRebalance`
     #
-    #   * `AlarmNotification`
+    #   * `HealthCheck`
+    #
+    #   * `InstanceRefresh`
+    #
+    #   * `ReplaceUnhealthy`
     #
     #   * `ScheduledActions`
     #
-    #   * `AddToLoadBalancer`
+    #   If you omit this parameter, all processes are specified.
     # @return [EmptyStructure]
     def resume_processes(options = {})
       options = options.merge(auto_scaling_group_name: @name)
@@ -819,24 +842,27 @@ module Aws::AutoScaling
     #   })
     # @param [Hash] options ({})
     # @option options [Array<String>] :scaling_processes
-    #   One or more of the following processes. If you omit this parameter,
-    #   all processes are specified.
+    #   One or more of the following processes:
     #
     #   * `Launch`
     #
     #   * `Terminate`
     #
-    #   * `HealthCheck`
+    #   * `AddToLoadBalancer`
     #
-    #   * `ReplaceUnhealthy`
+    #   * `AlarmNotification`
     #
     #   * `AZRebalance`
     #
-    #   * `AlarmNotification`
+    #   * `HealthCheck`
+    #
+    #   * `InstanceRefresh`
+    #
+    #   * `ReplaceUnhealthy`
     #
     #   * `ScheduledActions`
     #
-    #   * `AddToLoadBalancer`
+    #   If you omit this parameter, all processes are specified.
     # @return [EmptyStructure]
     def suspend_processes(options = {})
       options = options.merge(auto_scaling_group_name: @name)
@@ -945,13 +971,11 @@ module Aws::AutoScaling
     # @option options [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 cooldown period is not used when a scaling-specific cooldown is
-    #   specified.
     #
-    #   Cooldown periods are not supported for target tracking scaling
-    #   policies, step scaling policies, or scheduled scaling. For more
-    #   information, see [Scaling Cooldowns][1] in the *Amazon EC2 Auto
-    #   Scaling User Guide*.
+    #   This setting applies when using simple scaling policies, but not when
+    #   using other scaling policies or scheduled scaling. For more
+    #   information, see [Scaling Cooldowns for Amazon EC2 Auto Scaling][1] in
+    #   the *Amazon EC2 Auto Scaling User Guide*.
     #
     #
     #
@@ -971,8 +995,7 @@ module Aws::AutoScaling
     #   For more information, see [Health Check Grace Period][1] in the
     #   *Amazon EC2 Auto Scaling User Guide*.
     #
-    #   Conditional: This parameter is required if you are adding an `ELB`
-    #   health check.
+    #   Required if you are adding an `ELB` health check.
     #
     #
     #

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -24,6 +26,7 @@ require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 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/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/query.rb'
 
@@ -69,6 +72,7 @@ module Aws::AutoScaling
     add_plugin(Aws::Plugins::ClientMetricsPlugin)
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
+    add_plugin(Aws::Plugins::HttpChecksum)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::Query)
 
@@ -161,7 +165,7 @@ module Aws::AutoScaling
     #   @option options [String] :endpoint
     #     The client endpoint is normally constructed from the `:region`
     #     option. You should only configure an `:endpoint` when connecting
-    #     to test endpoints. This should be a valid HTTP(S) URI.
+    #     to test or custom endpoints. This should be a valid HTTP(S) URI.
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -560,6 +564,57 @@ module Aws::AutoScaling
       req.send_request(options)
     end
 
+    # Cancels an instance refresh operation in progress. Cancellation does
+    # not roll back any replacements that have already been completed, but
+    # it prevents new replacements from being started.
+    #
+    # For more information, see [Replacing Auto Scaling Instances Based on
+    # an Instance Refresh][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-refresh.html
+    #
+    # @option params [required, String] :auto_scaling_group_name
+    #   The name of the Auto Scaling group.
+    #
+    # @return [Types::CancelInstanceRefreshAnswer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CancelInstanceRefreshAnswer#instance_refresh_id #instance_refresh_id} => String
+    #
+    #
+    # @example Example: To cancel an instance refresh
+    #
+    #   # This example cancels an instance refresh operation in progress.
+    #
+    #   resp = client.cancel_instance_refresh({
+    #     auto_scaling_group_name: "my-auto-scaling-group", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     instance_refresh_id: "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b", 
+    #   }
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.cancel_instance_refresh({
+    #     auto_scaling_group_name: "XmlStringMaxLen255", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.instance_refresh_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CancelInstanceRefresh AWS API Documentation
+    #
+    # @overload cancel_instance_refresh(params = {})
+    # @param [Hash] params ({})
+    def cancel_instance_refresh(params = {}, options = {})
+      req = build_request(:cancel_instance_refresh, params)
+      req.send_request(options)
+    end
+
     # Completes the lifecycle action for the specified token or instance
     # with the specified result.
     #
@@ -769,8 +824,10 @@ module Aws::AutoScaling
     #   The amount of time, in seconds, after a scaling activity completes
     #   before another scaling activity can start. The default value is `300`.
     #
-    #   For more information, see [Scaling Cooldowns][1] in the *Amazon EC2
-    #   Auto Scaling User Guide*.
+    #   This setting applies when using simple scaling policies, but not when
+    #   using other scaling policies or scheduled scaling. For more
+    #   information, see [Scaling Cooldowns for Amazon EC2 Auto Scaling][1] in
+    #   the *Amazon EC2 Auto Scaling User Guide*.
     #
     #
     #
@@ -831,8 +888,7 @@ module Aws::AutoScaling
     #   For more information, see [Health Check Grace Period][1] in the
     #   *Amazon EC2 Auto Scaling User Guide*.
     #
-    #   Conditional: This parameter is required if you are adding an `ELB`
-    #   health check.
+    #   Required if you are adding an `ELB` health check.
     #
     #
     #
@@ -945,46 +1001,50 @@ module Aws::AutoScaling
     #
     #   resp = client.create_auto_scaling_group({
     #     auto_scaling_group_name: "my-auto-scaling-group", 
-    #     launch_configuration_name: "my-launch-config", 
+    #     launch_template: {
+    #       launch_template_id: "lt-0a20c965061f64abc", 
+    #       version: "$Latest", 
+    #     }, 
+    #     max_instance_lifetime: 2592000, 
     #     max_size: 3, 
     #     min_size: 1, 
-    #     vpc_zone_identifier: "subnet-4176792c", 
+    #     vpc_zone_identifier: "subnet-057fa0918fEXAMPLE", 
     #   })
     #
-    # @example Example: To create an Auto Scaling group with an attached load balancer
+    # @example Example: To create an Auto Scaling group with an attached target group
     #
-    #   # This example creates an Auto Scaling group and attaches the specified Classic Load Balancer.
+    #   # This example creates an Auto Scaling group and attaches the specified target group.
     #
     #   resp = client.create_auto_scaling_group({
     #     auto_scaling_group_name: "my-auto-scaling-group", 
-    #     availability_zones: [
-    #       "us-west-2c", 
-    #     ], 
     #     health_check_grace_period: 120, 
     #     health_check_type: "ELB", 
     #     launch_configuration_name: "my-launch-config", 
-    #     load_balancer_names: [
-    #       "my-load-balancer", 
-    #     ], 
     #     max_size: 3, 
     #     min_size: 1, 
+    #     target_group_arns: [
+    #       "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", 
+    #     ], 
+    #     vpc_zone_identifier: "subnet-057fa0918fEXAMPLE, subnet-610acd08EXAMPLE", 
     #   })
     #
-    # @example Example: To create an Auto Scaling group with an attached target group
+    # @example Example: To create an Auto Scaling group with an attached load balancer
     #
-    #   # This example creates an Auto Scaling group and attaches the specified target group.
+    #   # This example creates an Auto Scaling group and attaches the specified Classic Load Balancer.
     #
     #   resp = client.create_auto_scaling_group({
     #     auto_scaling_group_name: "my-auto-scaling-group", 
+    #     availability_zones: [
+    #       "us-west-2c", 
+    #     ], 
     #     health_check_grace_period: 120, 
     #     health_check_type: "ELB", 
     #     launch_configuration_name: "my-launch-config", 
+    #     load_balancer_names: [
+    #       "my-load-balancer", 
+    #     ], 
     #     max_size: 3, 
     #     min_size: 1, 
-    #     target_group_arns: [
-    #       "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", 
-    #     ], 
-    #     vpc_zone_identifier: "subnet-4176792c, subnet-65ea5f08", 
     #   })
     #
     # @example Request syntax with placeholder values
@@ -1647,7 +1707,7 @@ module Aws::AutoScaling
     #
     #   resp = client.delete_policy({
     #     auto_scaling_group_name: "my-auto-scaling-group", 
-    #     policy_name: "ScaleIn", 
+    #     policy_name: "my-step-scale-out-policy", 
     #   })
     #
     # @example Request syntax with placeholder values
@@ -1816,7 +1876,7 @@ module Aws::AutoScaling
     #   * {Types::DescribeAdjustmentTypesAnswer#adjustment_types #adjustment_types} => Array<Types::AdjustmentType>
     #
     #
-    # @example Example: To describe the Auto Scaling adjustment types
+    # @example Example: To describe the Amazon EC2 Auto Scaling adjustment types
     #
     #   # This example describes the available adjustment types.
     #
@@ -2145,6 +2205,116 @@ module Aws::AutoScaling
       req.send_request(options)
     end
 
+    # Describes one or more instance refreshes.
+    #
+    # You can determine the status of a request by looking at the `Status`
+    # parameter. The following are the possible statuses:
+    #
+    # * `Pending` - The request was created, but the operation has not
+    #   started.
+    #
+    # * `InProgress` - The operation is in progress.
+    #
+    # * `Successful` - The operation completed successfully.
+    #
+    # * `Failed` - The operation failed to complete. You can troubleshoot
+    #   using the status reason and the scaling activities.
+    #
+    # * `Cancelling` - An ongoing operation is being cancelled. Cancellation
+    #   does not roll back any replacements that have already been
+    #   completed, but it prevents new replacements from being started.
+    #
+    # * `Cancelled` - The operation is cancelled.
+    #
+    # For more information, see [Replacing Auto Scaling Instances Based on
+    # an Instance Refresh][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-refresh.html
+    #
+    # @option params [required, String] :auto_scaling_group_name
+    #   The name of the Auto Scaling group.
+    #
+    # @option params [Array<String>] :instance_refresh_ids
+    #   One or more instance refresh IDs.
+    #
+    # @option params [String] :next_token
+    #   The token for the next set of items to return. (You received this
+    #   token from a previous call.)
+    #
+    # @option params [Integer] :max_records
+    #   The maximum number of items to return with this call. The default
+    #   value is `50` and the maximum value is `100`.
+    #
+    # @return [Types::DescribeInstanceRefreshesAnswer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeInstanceRefreshesAnswer#instance_refreshes #instance_refreshes} => Array&lt;Types::InstanceRefresh&gt;
+    #   * {Types::DescribeInstanceRefreshesAnswer#next_token #next_token} => String
+    #
+    #
+    # @example Example: To list instance refreshes
+    #
+    #   # This example describes the instance refreshes for the specified Auto Scaling group.
+    #
+    #   resp = client.describe_instance_refreshes({
+    #     auto_scaling_group_name: "my-auto-scaling-group", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     instance_refreshes: [
+    #       {
+    #         auto_scaling_group_name: "my-auto-scaling-group", 
+    #         instance_refresh_id: "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b", 
+    #         instances_to_update: 5, 
+    #         percentage_complete: 0, 
+    #         start_time: Time.parse("2020-06-02T18:11:27Z"), 
+    #         status: "InProgress", 
+    #       }, 
+    #       {
+    #         auto_scaling_group_name: "my-auto-scaling-group", 
+    #         end_time: Time.parse("2020-06-02T16:53:37Z"), 
+    #         instance_refresh_id: "dd7728d0-5bc4-4575-96a3-1b2c52bf8bb1", 
+    #         instances_to_update: 0, 
+    #         percentage_complete: 100, 
+    #         start_time: Time.parse("2020-06-02T16:43:19Z"), 
+    #         status: "Successful", 
+    #       }, 
+    #     ], 
+    #   }
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_instance_refreshes({
+    #     auto_scaling_group_name: "XmlStringMaxLen255", # required
+    #     instance_refresh_ids: ["XmlStringMaxLen255"],
+    #     next_token: "XmlString",
+    #     max_records: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.instance_refreshes #=> Array
+    #   resp.instance_refreshes[0].instance_refresh_id #=> String
+    #   resp.instance_refreshes[0].auto_scaling_group_name #=> String
+    #   resp.instance_refreshes[0].status #=> String, one of "Pending", "InProgress", "Successful", "Failed", "Cancelling", "Cancelled"
+    #   resp.instance_refreshes[0].status_reason #=> String
+    #   resp.instance_refreshes[0].start_time #=> Time
+    #   resp.instance_refreshes[0].end_time #=> Time
+    #   resp.instance_refreshes[0].percentage_complete #=> Integer
+    #   resp.instance_refreshes[0].instances_to_update #=> Integer
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeInstanceRefreshes AWS API Documentation
+    #
+    # @overload describe_instance_refreshes(params = {})
+    # @param [Hash] params ({})
+    def describe_instance_refreshes(params = {}, options = {})
+      req = build_request(:describe_instance_refreshes, params)
+      req.send_request(options)
+    end
+
     # Describes one or more launch configurations.
     #
     # @option params [Array<String>] :launch_configuration_names
@@ -2662,7 +2832,7 @@ module Aws::AutoScaling
     # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
     #
     #
-    # @example Example: To describe Auto Scaling policies
+    # @example Example: To describe scaling policies
     #
     #   # This example describes the policies for the specified Auto Scaling group.
     #
@@ -3567,7 +3737,8 @@ module Aws::AutoScaling
       req.send_request(options)
     end
 
-    # Executes the specified policy.
+    # Executes the specified policy. This can be useful for testing the
+    # design of your scaling policy.
     #
     # @option params [String] :auto_scaling_group_name
     #   The name of the Auto Scaling group.
@@ -3579,11 +3750,9 @@ module Aws::AutoScaling
     #   Indicates whether Amazon EC2 Auto Scaling waits for the cooldown
     #   period to complete before executing the policy.
     #
-    #   This parameter is not supported if the policy type is `StepScaling` or
-    #   `TargetTrackingScaling`.
-    #
-    #   For more information, see [Scaling Cooldowns][1] in the *Amazon EC2
-    #   Auto Scaling User Guide*.
+    #   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*.
     #
     #
     #
@@ -3599,26 +3768,27 @@ module Aws::AutoScaling
     #   If you specify a metric value that doesn't correspond to a step
     #   adjustment for the policy, the call returns an error.
     #
-    #   Conditional: This parameter is required if the policy type is
-    #   `StepScaling` and not supported otherwise.
+    #   Required if the policy type is `StepScaling` and not supported
+    #   otherwise.
     #
     # @option params [Float] :breach_threshold
     #   The breach threshold for the alarm.
     #
-    #   Conditional: This parameter is required if the policy type is
-    #   `StepScaling` and not supported otherwise.
+    #   Required if the policy type is `StepScaling` and not supported
+    #   otherwise.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     #
-    # @example Example: To execute an Auto Scaling policy
+    # @example Example: To execute a scaling policy
     #
-    #   # This example executes the specified Auto Scaling policy for the specified Auto Scaling group.
+    #   # This example executes the specified policy.
     #
     #   resp = client.execute_policy({
     #     auto_scaling_group_name: "my-auto-scaling-group", 
-    #     honor_cooldown: true, 
-    #     policy_name: "ScaleIn", 
+    #     breach_threshold: 50.0, 
+    #     metric_value: 59.0, 
+    #     policy_name: "my-step-scale-out-policy", 
     #   })
     #
     # @example Request syntax with placeholder values
@@ -3778,16 +3948,16 @@ module Aws::AutoScaling
     #
     #   * autoscaling:EC2\_INSTANCE\_TERMINATING
     #
-    #   Conditional: This parameter is required for new lifecycle hooks, but
-    #   optional when updating existing hooks.
+    #   Required for new lifecycle hooks, but optional when updating existing
+    #   hooks.
     #
     # @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.
     #
-    #   Conditional: This parameter is required for new lifecycle hooks, but
-    #   optional when updating existing hooks.
+    #   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
@@ -3940,16 +4110,20 @@ module Aws::AutoScaling
     #   The name of the policy.
     #
     # @option params [String] :policy_type
-    #   The policy type. The valid values are `SimpleScaling`, `StepScaling`,
-    #   and `TargetTrackingScaling`. If the policy type is null, the value is
-    #   treated as `SimpleScaling`.
+    #   One of the following policy types:
+    #
+    #   * `TargetTrackingScaling`
+    #
+    #   * `StepScaling`
+    #
+    #   * `SimpleScaling` (default)
     #
     # @option params [String] :adjustment_type
-    #   Specifies whether the `ScalingAdjustment` parameter is an absolute
-    #   number or a percentage of the current capacity. The valid values are
+    #   Specifies how the scaling adjustment is interpreted (either an
+    #   absolute number or a percentage). The valid values are
     #   `ChangeInCapacity`, `ExactCapacity`, and `PercentChangeInCapacity`.
     #
-    #   Valid only if the policy type is `StepScaling` or `SimpleScaling`. For
+    #   Required if the policy type is `StepScaling` or `SimpleScaling`. For
     #   more information, see [Scaling Adjustment Types][1] in the *Amazon EC2
     #   Auto Scaling User Guide*.
     #
@@ -3962,43 +4136,45 @@ module Aws::AutoScaling
     #   instead.
     #
     # @option params [Integer] :min_adjustment_magnitude
-    #   The minimum value to scale by when scaling by percentages. For
-    #   example, suppose that you create a step scaling policy to scale out an
-    #   Auto Scaling group by 25 percent and you specify a
-    #   `MinAdjustmentMagnitude` of 2. If the group has 4 instances and the
-    #   scaling policy is performed, 25 percent of 4 is 1. However, because
-    #   you specified a `MinAdjustmentMagnitude` of 2, Amazon EC2 Auto Scaling
-    #   scales out the group by 2 instances.
-    #
-    #   Valid only if the policy type is `StepScaling` or `SimpleScaling` and
-    #   the adjustment type is `PercentChangeInCapacity`. For more
-    #   information, see [Scaling Adjustment Types][1] in the *Amazon EC2 Auto
-    #   Scaling User Guide*.
+    #   The minimum value to scale by when the adjustment type is
+    #   `PercentChangeInCapacity`. For example, suppose that you create a step
+    #   scaling policy to scale out an Auto Scaling group by 25 percent and
+    #   you specify a `MinAdjustmentMagnitude` of 2. If the group has 4
+    #   instances and the scaling policy is performed, 25 percent of 4 is 1.
+    #   However, because you specified a `MinAdjustmentMagnitude` of 2, Amazon
+    #   EC2 Auto Scaling scales out the group by 2 instances.
+    #
+    #   Valid only if the policy type is `StepScaling` or `SimpleScaling`. For
+    #   more information, see [Scaling Adjustment Types][1] in the *Amazon EC2
+    #   Auto Scaling User Guide*.
+    #
+    #   <note markdown="1"> Some Auto Scaling groups use instance weights. In this case, set the
+    #   `MinAdjustmentMagnitude` to a value that is at least as large as your
+    #   largest instance weight.
+    #
+    #    </note>
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-scaling-simple-step.html#as-scaling-adjustment
     #
     # @option params [Integer] :scaling_adjustment
-    #   The amount by which a simple scaling policy scales the Auto Scaling
-    #   group in response to an alarm breach. The adjustment is based on the
-    #   value that you specified in the `AdjustmentType` parameter (either an
-    #   absolute number or a percentage). A positive value adds to the current
-    #   capacity and a negative value subtracts from the current capacity. For
-    #   exact capacity, you must specify a positive value.
+    #   The amount by which to scale, based on the specified adjustment type.
+    #   A positive value adds to the current capacity while a negative number
+    #   removes from the current capacity. For exact capacity, you must
+    #   specify a positive value.
     #
-    #   Conditional: If you specify `SimpleScaling` for the policy type, you
-    #   must specify this parameter. (Not used with any other policy type.)
+    #   Required if the policy type is `SimpleScaling`. (Not used with any
+    #   other policy type.)
     #
     # @option params [Integer] :cooldown
-    #   The amount of time, in seconds, after a scaling activity completes
-    #   before any further dynamic scaling activities can start. If this
-    #   parameter is not specified, the default cooldown period for the group
-    #   applies.
+    #   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.
     #
     #   Valid only if the policy type is `SimpleScaling`. For more
-    #   information, see [Scaling Cooldowns][1] in the *Amazon EC2 Auto
-    #   Scaling User Guide*.
+    #   information, see [Scaling Cooldowns for Amazon EC2 Auto Scaling][1] in
+    #   the *Amazon EC2 Auto Scaling User Guide*.
     #
     #
     #
@@ -4015,27 +4191,40 @@ module Aws::AutoScaling
     #   A set of adjustments that enable you to scale based on the size of the
     #   alarm breach.
     #
-    #   Conditional: If you specify `StepScaling` for the policy type, you
-    #   must specify this parameter. (Not used with any other policy type.)
+    #   Required if the policy type is `StepScaling`. (Not used with any other
+    #   policy type.)
     #
     # @option params [Integer] :estimated_instance_warmup
     #   The estimated time, in seconds, until a newly launched instance can
-    #   contribute to the CloudWatch metrics. The default is to use the value
-    #   specified for the default cooldown period for the group.
+    #   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.
     #
-    #   Valid only if the policy type is `StepScaling` or
-    #   `TargetTrackingScaling`.
+    #   Valid only if the policy type is `TargetTrackingScaling` or
+    #   `StepScaling`.
     #
     # @option params [Types::TargetTrackingConfiguration] :target_tracking_configuration
     #   A target tracking scaling policy. Includes support for predefined or
     #   customized metrics.
     #
+    #   The following predefined metrics are available:
+    #
+    #   * `ASGAverageCPUUtilization`
+    #
+    #   * `ASGAverageNetworkIn`
+    #
+    #   * `ASGAverageNetworkOut`
+    #
+    #   * `ALBRequestCountPerTarget`
+    #
+    #   If you specify `ALBRequestCountPerTarget` for the metric, you must
+    #   specify the `ResourceLabel` parameter with the
+    #   `PredefinedMetricSpecification`.
+    #
     #   For more information, see [TargetTrackingConfiguration][1] in the
     #   *Amazon EC2 Auto Scaling API Reference*.
     #
-    #   Conditional: If you specify `TargetTrackingScaling` for the policy
-    #   type, you must specify this parameter. (Not used with any other policy
-    #   type.)
+    #   Required if the policy type is `TargetTrackingScaling`.
     #
     #
     #
@@ -4062,15 +4251,31 @@ module Aws::AutoScaling
     #   # This example adds the specified policy to the specified Auto Scaling group.
     #
     #   resp = client.put_scaling_policy({
-    #     adjustment_type: "ChangeInCapacity", 
     #     auto_scaling_group_name: "my-auto-scaling-group", 
-    #     policy_name: "ScaleIn", 
-    #     scaling_adjustment: -1, 
+    #     policy_name: "alb1000-target-tracking-scaling-policy", 
+    #     policy_type: "TargetTrackingScaling", 
+    #     target_tracking_configuration: {
+    #       predefined_metric_specification: {
+    #         predefined_metric_type: "ALBRequestCountPerTarget", 
+    #         resource_label: "app/EC2Co-EcsEl-1TKLTMITMM0EO/f37c06a68c1748aa/targetgroup/EC2Co-Defau-LDNM7Q3ZH1ZN/6d4ea56ca2d6a18d", 
+    #       }, 
+    #       target_value: 1000.0, 
+    #     }, 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
-    #     policy_arn: "arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:2233f3d7-6290-403b-b632-93c553560106:autoScalingGroupName/my-auto-scaling-group:policyName/ScaleIn", 
+    #     alarms: [
+    #       {
+    #         alarm_arn: "arn:aws:cloudwatch:us-west-2:123456789012:alarm:TargetTracking-my-asg-AlarmHigh-fc0e4183-23ac-497e-9992-691c9980c38e", 
+    #         alarm_name: "TargetTracking-my-asg-AlarmHigh-fc0e4183-23ac-497e-9992-691c9980c38e", 
+    #       }, 
+    #       {
+    #         alarm_arn: "arn:aws:cloudwatch:us-west-2:123456789012:alarm:TargetTracking-my-asg-AlarmLow-61a39305-ed0c-47af-bd9e-471a352ee1a2", 
+    #         alarm_name: "TargetTracking-my-asg-AlarmLow-61a39305-ed0c-47af-bd9e-471a352ee1a2", 
+    #       }, 
+    #     ], 
+    #     policy_arn: "arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:228f02c2-c665-4bfd-aaac-8b04080bea3c:autoScalingGroupName/my-auto-scaling-group:policyName/alb1000-target-tracking-scaling-policy", 
     #   }
     #
     # @example Request syntax with placeholder values
@@ -4326,24 +4531,27 @@ module Aws::AutoScaling
     #   The name of the Auto Scaling group.
     #
     # @option params [Array<String>] :scaling_processes
-    #   One or more of the following processes. If you omit this parameter,
-    #   all processes are specified.
+    #   One or more of the following processes:
     #
     #   * `Launch`
     #
     #   * `Terminate`
     #
-    #   * `HealthCheck`
+    #   * `AddToLoadBalancer`
     #
-    #   * `ReplaceUnhealthy`
+    #   * `AlarmNotification`
     #
     #   * `AZRebalance`
     #
-    #   * `AlarmNotification`
+    #   * `HealthCheck`
+    #
+    #   * `InstanceRefresh`
+    #
+    #   * `ReplaceUnhealthy`
     #
     #   * `ScheduledActions`
     #
-    #   * `AddToLoadBalancer`
+    #   If you omit this parameter, all processes are specified.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -4559,6 +4767,99 @@ module Aws::AutoScaling
       req.send_request(options)
     end
 
+    # Starts a new instance refresh operation, which triggers a rolling
+    # replacement of all previously launched instances in the Auto Scaling
+    # group with a new group of instances.
+    #
+    # If successful, this call creates a new instance refresh request with a
+    # unique ID that you can use to track its progress. To query its status,
+    # call the DescribeInstanceRefreshes API. To describe the instance
+    # refreshes that have already run, call the DescribeInstanceRefreshes
+    # API. To cancel an instance refresh operation in progress, use the
+    # CancelInstanceRefresh API.
+    #
+    # For more information, see [Replacing Auto Scaling Instances Based on
+    # an Instance Refresh][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-refresh.html
+    #
+    # @option params [required, String] :auto_scaling_group_name
+    #   The name of the Auto Scaling group.
+    #
+    # @option params [String] :strategy
+    #   The strategy to use for the instance refresh. The only valid value is
+    #   `Rolling`.
+    #
+    #   A rolling update is an update that is applied to all instances in an
+    #   Auto Scaling group until all instances have been updated. A rolling
+    #   update can fail due to failed health checks or if instances are on
+    #   standby or are protected from scale in. If the rolling update process
+    #   fails, any instances that were already replaced are not rolled back to
+    #   their previous configuration.
+    #
+    # @option params [Types::RefreshPreferences] :preferences
+    #   Set of preferences associated with the instance refresh request.
+    #
+    #   If not provided, the default values are used. For
+    #   `MinHealthyPercentage`, the default value is `90`. For
+    #   `InstanceWarmup`, the default is to use the value specified for the
+    #   health check grace period for the Auto Scaling group.
+    #
+    #   For more information, see [RefreshPreferences][1] in the *Amazon EC2
+    #   Auto Scaling API Reference*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_RefreshPreferences.html
+    #
+    # @return [Types::StartInstanceRefreshAnswer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StartInstanceRefreshAnswer#instance_refresh_id #instance_refresh_id} => String
+    #
+    #
+    # @example Example: To start an instance refresh
+    #
+    #   # This example starts an instance refresh for the specified Auto Scaling group.
+    #
+    #   resp = client.start_instance_refresh({
+    #     auto_scaling_group_name: "my-auto-scaling-group", 
+    #     preferences: {
+    #       instance_warmup: 400, 
+    #       min_healthy_percentage: 50, 
+    #     }, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     instance_refresh_id: "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b", 
+    #   }
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_instance_refresh({
+    #     auto_scaling_group_name: "XmlStringMaxLen255", # required
+    #     strategy: "Rolling", # accepts Rolling
+    #     preferences: {
+    #       min_healthy_percentage: 1,
+    #       instance_warmup: 1,
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.instance_refresh_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/StartInstanceRefresh AWS API Documentation
+    #
+    # @overload start_instance_refresh(params = {})
+    # @param [Hash] params ({})
+    def start_instance_refresh(params = {}, options = {})
+      req = build_request(:start_instance_refresh, params)
+      req.send_request(options)
+    end
+
     # Suspends the specified automatic scaling processes, or all processes,
     # for the specified Auto Scaling group.
     #
@@ -4578,24 +4879,27 @@ module Aws::AutoScaling
     #   The name of the Auto Scaling group.
     #
     # @option params [Array<String>] :scaling_processes
-    #   One or more of the following processes. If you omit this parameter,
-    #   all processes are specified.
+    #   One or more of the following processes:
     #
     #   * `Launch`
     #
     #   * `Terminate`
     #
-    #   * `HealthCheck`
+    #   * `AddToLoadBalancer`
     #
-    #   * `ReplaceUnhealthy`
+    #   * `AlarmNotification`
     #
     #   * `AZRebalance`
     #
-    #   * `AlarmNotification`
+    #   * `HealthCheck`
+    #
+    #   * `InstanceRefresh`
+    #
+    #   * `ReplaceUnhealthy`
     #
     #   * `ScheduledActions`
     #
-    #   * `AddToLoadBalancer`
+    #   If you omit this parameter, all processes are specified.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -4810,13 +5114,11 @@ module Aws::AutoScaling
     # @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 cooldown period is not used when a scaling-specific cooldown is
-    #   specified.
     #
-    #   Cooldown periods are not supported for target tracking scaling
-    #   policies, step scaling policies, or scheduled scaling. For more
-    #   information, see [Scaling Cooldowns][1] in the *Amazon EC2 Auto
-    #   Scaling User Guide*.
+    #   This setting applies when using simple scaling policies, but not when
+    #   using other scaling policies or scheduled scaling. For more
+    #   information, see [Scaling Cooldowns for Amazon EC2 Auto Scaling][1] in
+    #   the *Amazon EC2 Auto Scaling User Guide*.
     #
     #
     #
@@ -4839,8 +5141,7 @@ module Aws::AutoScaling
     #   For more information, see [Health Check Grace Period][1] in the
     #   *Amazon EC2 Auto Scaling User Guide*.
     #
-    #   Conditional: This parameter is required if you are adding an `ELB`
-    #   health check.
+    #   Required if you are adding an `ELB` health check.
     #
     #
     #
@@ -5018,7 +5319,7 @@ module Aws::AutoScaling
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-autoscaling'
-      context[:gem_version] = '1.37.0'
+      context[:gem_version] = '1.42.0'
       Seahorse::Client::Request.new(handlers, context)
     end