aws-sdk-autoscaling 1.36.0 → 1.41.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c1ea8c327418e3423e234d451050995d1dab98486db36b5e8b2713196b87d3da
-  data.tar.gz: c3a6fe5e513a3c2af82e4aa6f6befef66f9c0463127ab48f89401ab72f3eae3e
+  metadata.gz: 0a0212772f92a489009f672d3f3368f1ffcaa8923f54453bf195c37b0058c60a
+  data.tar.gz: 8025d59bd8e73f95923cbdad9a64c9dd9dadda9ba33e679683c3ac93f7152fbb
 SHA512:
-  metadata.gz: '04102821b6b81b72841cf084c219327a35aac9ae1d0d16473795edb68dd90409868651493db2616fa3fd333b114f8efbb371b2b4a964e5a54c512a5b8cba749b'
-  data.tar.gz: 3dd50231249f5e11319819eab74fe2eba9d928ac8703e3068e9603433dce0bc0e3dcda1e78529d06b27aa54828176820478b37906fb4043d71f7250f5a4b1815
+  metadata.gz: d7787741e13ea3e023d996ce2780dee1431bfb0ec0ab00b9cc8c254df1d1d00acf0b85e4de4e131af277b4ceda4638aaa13185fc237915857f2cb283b1c5e1da
+  data.tar.gz: 8a102ee668e948b2aaa5bfb9412130d7520f09dffe2c50444b2b2d090472d413c1c36b47d675574c0f8be052411ae26d3da24a38dc309d3ec2ce3deb31225ac0

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.36.0'
+  GEM_VERSION = '1.41.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
@@ -176,7 +180,7 @@ module Aws::AutoScaling
     #     requests fetching endpoints information. Defaults to 60 sec.
     #
     #   @option options [Boolean] :endpoint_discovery (false)
-    #     When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
+    #     When set to `true`, endpoint discovery will be enabled for operations when available.
     #
     #   @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
     #     The log formatter.
@@ -560,6 +564,43 @@ 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 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 +810,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 +874,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.
     #
     #
     #
@@ -2145,6 +2187,84 @@ 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 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
@@ -3582,8 +3702,8 @@ module Aws::AutoScaling
     #   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*.
+    #   For more information, see [Scaling Cooldowns for Amazon EC2 Auto
+    #   Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
     #
     #
     #
@@ -3599,14 +3719,14 @@ 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}.
     #
@@ -3778,16 +3898,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 +4060,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 +4086,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 +4141,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`.
     #
     #
     #
@@ -4326,24 +4465,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 +4701,81 @@ 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 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 +4795,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 +5030,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 +5057,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 +5235,7 @@ module Aws::AutoScaling
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-autoscaling'
-      context[:gem_version] = '1.36.0'
+      context[:gem_version] = '1.41.0'
       Seahorse::Client::Request.new(handlers, context)
     end