aws-sdk-autoscaling 1.33.0 → 1.38.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b91119d5438f8a9221c54356341819b776df8f50ac29cccbac7af0f38fa83c3
-  data.tar.gz: e2f581c53ec372865c1bd6ffc29dd8ed21695ca35d73b9b1af7141520235a508
+  metadata.gz: b7d9b1c93029c64b83d30c6944636ab2f2f56e8f0b699fcc3e2e78eae68e9e04
+  data.tar.gz: 1057ebd629a55d49ad47097a34dcd26dea073daf829027e9a0ea0b7be3e2a0e0
 SHA512:
-  metadata.gz: 1e3fb49c1e46cc9b4e0a2def902ca57e1232b61668c206626f272c5b1ea5aa9a76bff1026508595b9830849bc39742368061d98d2a6a2e159c1d760195290bfc
-  data.tar.gz: 7b54eaead6ad303be8aad389fd6b4d086b7d7835ab201bfedd3089212050d70651a7b713d1dfd5338ba55546b891e3d70dc3f4f9da16fddec46b306e811a6c38
+  metadata.gz: 70326812f5eab793cf8b61102ac24c6f44adea620226f3217f63ca853e084845f486ef881f1b6d60b71cbab691187f71f3036b8ff1f80c4dddbe38fc0a5e84fe
+  data.tar.gz: 31f0072da91a0af36a99dfd617d3d58a207004f755d266a6249eab903ee291915b1b59f525e0bbbd80df48854cfc141da570df482309b45a85d030ea9e008202

data/lib/aws-sdk-autoscaling.rb

@@ -56,6 +56,6 @@ require_relative 'aws-sdk-autoscaling/customizations'
 # @service
 module Aws::AutoScaling
 
-  GEM_VERSION = '1.33.0'
+  GEM_VERSION = '1.38.1'
 
 end

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

@@ -127,7 +127,8 @@ module Aws::AutoScaling
     # Waiter polls an API operation until a resource enters a desired
     # state.
     #
-    # @note The waiting operation is performed on a copy. The original resource remains unchanged
+    # @note The waiting operation is performed on a copy. The original resource
+    #   remains unchanged.
     #
     # ## Basic Usage
     #
@@ -140,13 +141,15 @@ module Aws::AutoScaling
     #
     # ## Example
     #
-    #     instance.wait_until(max_attempts:10, delay:5) {|instance| instance.state.name == 'running' }
+    #     instance.wait_until(max_attempts:10, delay:5) do |instance|
+    #       instance.state.name == 'running'
+    #     end
     #
     # ## Configuration
     #
     # You can configure the maximum number of polling attempts, and the
-    # delay (in seconds) between each polling attempt. The waiting condition is set
-    # by passing a block to {#wait_until}:
+    # delay (in seconds) between each polling attempt. The waiting condition is
+    # set by passing a block to {#wait_until}:
     #
     #     # poll for ~25 seconds
     #     resource.wait_until(max_attempts:5,delay:5) {|resource|...}
@@ -177,17 +180,16 @@ module Aws::AutoScaling
     #       # resource did not enter the desired state in time
     #     end
     #
+    # @yieldparam [Resource] resource to be used in the waiting condition.
     #
-    # @yield param [Resource] resource to be used in the waiting condition
-    #
-    # @raise [Aws::Waiters::Errors::FailureStateError] Raised when the waiter terminates
-    #   because the waiter has entered a state that it will not transition
-    #   out of, preventing success.
+    # @raise [Aws::Waiters::Errors::FailureStateError] Raised when the waiter
+    #   terminates because the waiter has entered a state that it will not
+    #   transition out of, preventing success.
     #
     #   yet successful.
     #
-    # @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is encountered
-    #   while polling for a resource that is not expected.
+    # @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is
+    #   encountered while polling for a resource that is not expected.
     #
     # @raise [NotImplementedError] Raised when the resource does not
     #

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

@@ -149,8 +149,8 @@ module Aws::AutoScaling
       data[:enabled_metrics]
     end
 
-    # The current state of the group when DeleteAutoScalingGroup is in
-    # progress.
+    # The current state of the group when the DeleteAutoScalingGroup
+    # operation is in progress.
     # @return [String]
     def status
       data[:status]
@@ -179,7 +179,7 @@ module Aws::AutoScaling
     # The maximum amount of time, in seconds, that an instance can be in
     # service.
     #
-    # Valid Range: Minimum value of 604800.
+    # Valid Range: Minimum value of 0.
     # @return [Integer]
     def max_instance_lifetime
       data[:max_instance_lifetime]
@@ -290,7 +290,8 @@ module Aws::AutoScaling
     # Waiter polls an API operation until a resource enters a desired
     # state.
     #
-    # @note The waiting operation is performed on a copy. The original resource remains unchanged
+    # @note The waiting operation is performed on a copy. The original resource
+    #   remains unchanged.
     #
     # ## Basic Usage
     #
@@ -303,13 +304,15 @@ module Aws::AutoScaling
     #
     # ## Example
     #
-    #     instance.wait_until(max_attempts:10, delay:5) {|instance| instance.state.name == 'running' }
+    #     instance.wait_until(max_attempts:10, delay:5) do |instance|
+    #       instance.state.name == 'running'
+    #     end
     #
     # ## Configuration
     #
     # You can configure the maximum number of polling attempts, and the
-    # delay (in seconds) between each polling attempt. The waiting condition is set
-    # by passing a block to {#wait_until}:
+    # delay (in seconds) between each polling attempt. The waiting condition is
+    # set by passing a block to {#wait_until}:
     #
     #     # poll for ~25 seconds
     #     resource.wait_until(max_attempts:5,delay:5) {|resource|...}
@@ -340,17 +343,16 @@ module Aws::AutoScaling
     #       # resource did not enter the desired state in time
     #     end
     #
+    # @yieldparam [Resource] resource to be used in the waiting condition.
     #
-    # @yield param [Resource] resource to be used in the waiting condition
-    #
-    # @raise [Aws::Waiters::Errors::FailureStateError] Raised when the waiter terminates
-    #   because the waiter has entered a state that it will not transition
-    #   out of, preventing success.
+    # @raise [Aws::Waiters::Errors::FailureStateError] Raised when the waiter
+    #   terminates because the waiter has entered a state that it will not
+    #   transition out of, preventing success.
     #
     #   yet successful.
     #
-    # @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is encountered
-    #   while polling for a resource that is not expected.
+    # @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is
+    #   encountered while polling for a resource that is not expected.
     #
     # @raise [NotImplementedError] Raised when the resource does not
     #
@@ -449,8 +451,7 @@ module Aws::AutoScaling
     #   })
     # @param [Hash] options ({})
     # @option options [Array<String>] :metrics
-    #   One or more of the following metrics. If you omit this parameter, all
-    #   metrics are disabled.
+    #   Specifies one or more of the following metrics:
     #
     #   * `GroupMinSize`
     #
@@ -467,6 +468,18 @@ module Aws::AutoScaling
     #   * `GroupTerminatingInstances`
     #
     #   * `GroupTotalInstances`
+    #
+    #   * `GroupInServiceCapacity`
+    #
+    #   * `GroupPendingCapacity`
+    #
+    #   * `GroupStandbyCapacity`
+    #
+    #   * `GroupTerminatingCapacity`
+    #
+    #   * `GroupTotalCapacity`
+    #
+    #   If you omit this parameter, all metrics are disabled.
     # @return [EmptyStructure]
     def disable_metrics_collection(options = {})
       options = options.merge(auto_scaling_group_name: @name)
@@ -482,8 +495,8 @@ module Aws::AutoScaling
     #   })
     # @param [Hash] options ({})
     # @option options [Array<String>] :metrics
-    #   One or more of the following metrics. If you omit this parameter, all
-    #   metrics are enabled.
+    #   Specifies which group-level metrics to start collecting. You can
+    #   specify one or more of the following metrics:
     #
     #   * `GroupMinSize`
     #
@@ -500,6 +513,21 @@ module Aws::AutoScaling
     #   * `GroupTerminatingInstances`
     #
     #   * `GroupTotalInstances`
+    #
+    #   The instance weighting feature supports the following additional
+    #   metrics:
+    #
+    #   * `GroupInServiceCapacity`
+    #
+    #   * `GroupPendingCapacity`
+    #
+    #   * `GroupStandbyCapacity`
+    #
+    #   * `GroupTerminatingCapacity`
+    #
+    #   * `GroupTotalCapacity`
+    #
+    #   If you omit this parameter, all metrics are enabled.
     # @option options [required, String] :granularity
     #   The granularity to associate with the metrics to collect. The only
     #   valid value is `1Minute`.
@@ -574,20 +602,22 @@ module Aws::AutoScaling
     #   Available for backward compatibility. Use `MinAdjustmentMagnitude`
     #   instead.
     # @option options [Integer] :min_adjustment_magnitude
-    #   The minimum number of instances to scale. If the value of
-    #   `AdjustmentType` is `PercentChangeInCapacity`, the scaling policy
-    #   changes the `DesiredCapacity` of the Auto Scaling group by at least
-    #   this many instances. Otherwise, the error is `ValidationError`.
-    #
-    #   This property replaces the `MinAdjustmentStep` property. 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 `SimpleScaling` or `StepScaling`.
+    #   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*.
+    #
+    #
+    #
+    #   [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
@@ -656,7 +686,7 @@ module Aws::AutoScaling
     # @return [ScalingPolicy]
     def put_scaling_policy(options = {})
       options = options.merge(auto_scaling_group_name: @name)
-      resp = @client.put_scaling_policy(options)
+      @client.put_scaling_policy(options)
       ScalingPolicy.new(
         name: options[:policy_name],
         client: @client
@@ -708,16 +738,18 @@ module Aws::AutoScaling
     #
     #   [1]: http://crontab.org
     # @option options [Integer] :min_size
-    #   The minimum number of instances in the Auto Scaling group.
+    #   The minimum size of the Auto Scaling group.
     # @option options [Integer] :max_size
-    #   The maximum number of instances in the Auto Scaling group.
+    #   The maximum size of the Auto Scaling group.
     # @option options [Integer] :desired_capacity
-    #   The number of EC2 instances that should be running in the Auto Scaling
-    #   group.
+    #   The desired capacity is the initial capacity of the Auto Scaling group
+    #   after the scheduled action runs and the capacity it attempts to
+    #   maintain. It can scale beyond this capacity if you add more scaling
+    #   conditions.
     # @return [ScheduledAction]
     def put_scheduled_update_group_action(options = {})
       options = options.merge(auto_scaling_group_name: @name)
-      resp = @client.put_scheduled_update_group_action(options)
+      @client.put_scheduled_update_group_action(options)
       ScheduledAction.new(
         name: options[:scheduled_action_name],
         client: @client
@@ -764,8 +796,9 @@ module Aws::AutoScaling
     #   })
     # @param [Hash] options ({})
     # @option options [required, Integer] :desired_capacity
-    #   The number of EC2 instances that should be running in the Auto Scaling
-    #   group.
+    #   The desired capacity is the initial capacity of the Auto Scaling group
+    #   after this operation completes and the capacity it attempts to
+    #   maintain.
     # @option options [Boolean] :honor_cooldown
     #   Indicates whether Amazon EC2 Auto Scaling waits for the cooldown
     #   period to complete before initiating a scaling activity to set your
@@ -893,10 +926,22 @@ module Aws::AutoScaling
     #   The minimum size of the Auto Scaling group.
     # @option options [Integer] :max_size
     #   The maximum size of the Auto Scaling group.
+    #
+    #   <note markdown="1"> With a mixed instances policy that uses instance weighting, Amazon EC2
+    #   Auto Scaling may need to go above `MaxSize` to meet your capacity
+    #   requirements. In this event, Amazon EC2 Auto Scaling will never go
+    #   above `MaxSize` by more than your maximum instance weight (weights
+    #   that define how many capacity units each instance contributes to the
+    #   capacity of the group).
+    #
+    #    </note>
     # @option options [Integer] :desired_capacity
-    #   The number of EC2 instances that should be running in the Auto Scaling
-    #   group. This number must be greater than or equal to the minimum size
-    #   of the group and less than or equal to the maximum size of the group.
+    #   The desired capacity is the initial capacity of the Auto Scaling group
+    #   after this operation completes and the capacity it attempts to
+    #   maintain.
+    #
+    #   This number must be greater than or equal to the minimum size of the
+    #   group and less than or equal to the maximum size of the group.
     # @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`.
@@ -982,13 +1027,17 @@ module Aws::AutoScaling
     #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-service-linked-role.html
     # @option options [Integer] :max_instance_lifetime
     #   The maximum amount of time, in seconds, that an instance can be in
-    #   service.
+    #   service. The default is null.
+    #
+    #   This parameter is optional, but if you specify a value for it, you
+    #   must specify a value of at least 604,800 seconds (7 days). To clear a
+    #   previously set value, specify a new value of 0.
     #
     #   For more information, see [Replacing Auto Scaling Instances Based on
     #   Maximum Instance Lifetime][1] in the *Amazon EC2 Auto Scaling User
     #   Guide*.
     #
-    #   Valid Range: Minimum value of 604800.
+    #   Valid Range: Minimum value of 0.
     #
     #
     #
@@ -996,7 +1045,7 @@ module Aws::AutoScaling
     # @return [AutoScalingGroup]
     def update(options = {})
       options = options.merge(auto_scaling_group_name: @name)
-      resp = @client.update_auto_scaling_group(options)
+      @client.update_auto_scaling_group(options)
       AutoScalingGroup.new(
         name: options[:auto_scaling_group_name],
         client: @client
@@ -1291,8 +1340,8 @@ module Aws::AutoScaling
 
     def yield_waiter_and_warn(waiter, &block)
       if !@waiter_block_warned
-        msg = "pass options to configure the waiter; "
-        msg << "yielding the waiter is deprecated"
+        msg = "pass options to configure the waiter; "\
+              "yielding the waiter is deprecated"
         warn(msg)
         @waiter_block_warned = true
       end
@@ -1300,7 +1349,9 @@ module Aws::AutoScaling
     end
 
     def separate_params_and_options(options)
-      opts = Set.new([:client, :max_attempts, :delay, :before_attempt, :before_wait])
+      opts = Set.new(
+        [:client, :max_attempts, :delay, :before_attempt, :before_wait]
+      )
       waiter_opts = {}
       waiter_params = {}
       options.each_pair do |key, value|

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

@@ -24,6 +24,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 +70,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)
 
@@ -105,7 +107,7 @@ module Aws::AutoScaling
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
     #     used to determine the service `:endpoint`. When not passed,
-    #     a default `:region` is search for in the following locations:
+    #     a default `:region` is searched for in the following locations:
     #
     #     * `Aws.config[:region]`
     #     * `ENV['AWS_REGION']`
@@ -161,7 +163,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 avalid 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 +178,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.
@@ -269,8 +271,7 @@ module Aws::AutoScaling
     #
     #   @option options [Integer] :http_read_timeout (60) The default
     #     number of seconds to wait for response data.  This value can
-    #     safely be set
-    #     per-request on the session yielded by {#session_for}.
+    #     safely be set per-request on the session.
     #
     #   @option options [Float] :http_idle_timeout (5) The number of
     #     seconds a connection is allowed to sit idle before it is
@@ -282,7 +283,7 @@ module Aws::AutoScaling
     #     request body.  This option has no effect unless the request has
     #     "Expect" header set to "100-continue".  Defaults to `nil` which
     #     disables this behaviour.  This value can safely be set per
-    #     request on the session yielded by {#session_for}.
+    #     request on the session.
     #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
@@ -369,9 +370,9 @@ module Aws::AutoScaling
     # Attaches one or more target groups to the specified Auto Scaling
     # group.
     #
-    # To describe the target groups for an Auto Scaling group, use
-    # DescribeLoadBalancerTargetGroups. To detach the target group from the
-    # Auto Scaling group, use DetachLoadBalancerTargetGroups.
+    # To describe the target groups for an Auto Scaling group, call the
+    # DescribeLoadBalancerTargetGroups API. To detach the target group from
+    # the Auto Scaling group, call the DetachLoadBalancerTargetGroups API.
     #
     # With Application Load Balancers and Network Load Balancers, instances
     # are registered as targets with a target group. With Classic Load
@@ -420,15 +421,18 @@ module Aws::AutoScaling
       req.send_request(options)
     end
 
-    # Attaches one or more Classic Load Balancers to the specified Auto
-    # Scaling group.
+    # <note markdown="1"> To attach an Application Load Balancer or a Network Load Balancer, use
+    # the AttachLoadBalancerTargetGroups API operation instead.
     #
-    # To attach an Application Load Balancer or a Network Load Balancer
-    # instead, see AttachLoadBalancerTargetGroups.
+    #  </note>
     #
-    # To describe the load balancers for an Auto Scaling group, use
-    # DescribeLoadBalancers. To detach the load balancer from the Auto
-    # Scaling group, use DetachLoadBalancers.
+    # Attaches one or more Classic Load Balancers to the specified Auto
+    # Scaling group. Amazon EC2 Auto Scaling registers the running instances
+    # with these Classic Load Balancers.
+    #
+    # To describe the load balancers for an Auto Scaling group, call the
+    # DescribeLoadBalancers API. To detach the load balancer from the Auto
+    # Scaling group, call the DetachLoadBalancers API.
     #
     # For more information, see [Attaching a Load Balancer to Your Auto
     # Scaling Group][1] in the *Amazon EC2 Auto Scaling User Guide*.
@@ -645,34 +649,49 @@ module Aws::AutoScaling
     # Creates an Auto Scaling group with the specified name and attributes.
     #
     # If you exceed your maximum limit of Auto Scaling groups, the call
-    # fails. For information about viewing this limit, see
-    # DescribeAccountLimits. For information about updating this limit, see
-    # [Amazon EC2 Auto Scaling Service Quotas][1] in the *Amazon EC2 Auto
-    # Scaling User Guide*.
+    # fails. To query this limit, call the DescribeAccountLimits API. For
+    # information about updating this limit, see [Amazon EC2 Auto Scaling
+    # Service Quotas][1] in the *Amazon EC2 Auto Scaling User Guide*.
+    #
+    # For introductory exercises for creating an Auto Scaling group, see
+    # [Getting Started with Amazon EC2 Auto Scaling][2] and [Tutorial: Set
+    # Up a Scaled and Load-Balanced Application][3] in the *Amazon EC2 Auto
+    # Scaling User Guide*. For more information, see [Auto Scaling
+    # Groups][4] in the *Amazon EC2 Auto Scaling User Guide*.
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-account-limits.html
+    # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/GettingStartedTutorial.html
+    # [3]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-register-lbs-with-asg.html
+    # [4]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/AutoScalingGroup.html
     #
     # @option params [required, String] :auto_scaling_group_name
     #   The name of the Auto Scaling group. This name must be unique per
     #   Region per account.
     #
     # @option params [String] :launch_configuration_name
-    #   The name of the launch configuration.
+    #   The name of the launch configuration to use when an instance is
+    #   launched. To get the launch configuration name, use the
+    #   DescribeLaunchConfigurations API operation. New launch configurations
+    #   can be created with the CreateLaunchConfiguration API.
     #
-    #   If you do not specify `LaunchConfigurationName`, you must specify one
-    #   of the following parameters: `InstanceId`, `LaunchTemplate`, or
+    #   You must specify one of the following parameters in your request:
+    #   `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
     #   `MixedInstancesPolicy`.
     #
     # @option params [Types::LaunchTemplateSpecification] :launch_template
-    #   The launch template to use to launch instances.
+    #   Parameters used to specify the launch template and version to use when
+    #   an instance is launched.
     #
     #   For more information, see [LaunchTemplateSpecification][1] in the
     #   *Amazon EC2 Auto Scaling API Reference*.
     #
-    #   If you do not specify `LaunchTemplate`, you must specify one of the
-    #   following parameters: `InstanceId`, `LaunchConfigurationName`, or
+    #   You can alternatively associate a launch template to the Auto Scaling
+    #   group by using the `MixedInstancesPolicy` parameter.
+    #
+    #   You must specify one of the following parameters in your request:
+    #   `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
     #   `MixedInstancesPolicy`.
     #
     #
@@ -707,23 +726,21 @@ module Aws::AutoScaling
     #
     # @option params [String] :instance_id
     #   The ID of the instance used to create a launch configuration for the
-    #   group.
+    #   group. To get the instance ID, use the Amazon EC2
+    #   [DescribeInstances][1] API operation.
     #
     #   When you specify an ID of an instance, Amazon EC2 Auto Scaling creates
     #   a new launch configuration and associates it with the group. This
     #   launch configuration derives its attributes from the specified
     #   instance, except for the block device mapping.
     #
-    #   For more information, see [Create an Auto Scaling Group Using an EC2
-    #   Instance][1] in the *Amazon EC2 Auto Scaling User Guide*.
-    #
     #   You must specify one of the following parameters in your request:
     #   `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
     #   `MixedInstancesPolicy`.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-from-instance.html
+    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html
     #
     # @option params [required, Integer] :min_size
     #   The minimum size of the group.
@@ -731,12 +748,24 @@ module Aws::AutoScaling
     # @option params [required, Integer] :max_size
     #   The maximum size of the group.
     #
+    #   <note markdown="1"> With a mixed instances policy that uses instance weighting, Amazon EC2
+    #   Auto Scaling may need to go above `MaxSize` to meet your capacity
+    #   requirements. In this event, Amazon EC2 Auto Scaling will never go
+    #   above `MaxSize` by more than your maximum instance weight (weights
+    #   that define how many capacity units each instance contributes to the
+    #   capacity of the group).
+    #
+    #    </note>
+    #
     # @option params [Integer] :desired_capacity
-    #   The number of Amazon EC2 instances that the Auto Scaling group
-    #   attempts to maintain. This number must be greater than or equal to the
-    #   minimum size of the group and less than or equal to the maximum size
-    #   of the group. If you do not specify a desired capacity, the default is
-    #   the minimum size of the group.
+    #   The desired capacity is the initial capacity of the Auto Scaling group
+    #   at the time of its creation and the capacity it attempts to maintain.
+    #   It can scale beyond this capacity if you configure automatic scaling.
+    #
+    #   This number must be greater than or equal to the minimum size of the
+    #   group and less than or equal to the maximum size of the group. If you
+    #   do not specify a desired capacity, the default is the minimum size of
+    #   the group.
     #
     # @option params [Integer] :default_cooldown
     #   The amount of time, in seconds, after a scaling activity completes
@@ -862,7 +891,15 @@ module Aws::AutoScaling
     #   One or more lifecycle hooks.
     #
     # @option params [Array<Types::Tag>] :tags
-    #   One or more tags.
+    #   One or more tags. You can tag your Auto Scaling group and propagate
+    #   the tags to the Amazon EC2 instances it launches.
+    #
+    #   Tags are not propagated to Amazon EBS volumes. To add tags to Amazon
+    #   EBS volumes, specify the tags in a launch template but use caution. If
+    #   the launch template specifies an instance tag with a key that is also
+    #   specified for the Auto Scaling group, Amazon EC2 Auto Scaling
+    #   overrides the value of that instance tag with the value specified by
+    #   the Auto Scaling group.
     #
     #   For more information, see [Tagging Auto Scaling Groups and
     #   Instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
@@ -885,13 +922,17 @@ module Aws::AutoScaling
     #
     # @option params [Integer] :max_instance_lifetime
     #   The maximum amount of time, in seconds, that an instance can be in
-    #   service.
+    #   service. The default is null.
+    #
+    #   This parameter is optional, but if you specify a value for it, you
+    #   must specify a value of at least 604,800 seconds (7 days). To clear a
+    #   previously set value, specify a new value of 0.
     #
     #   For more information, see [Replacing Auto Scaling Instances Based on
     #   Maximum Instance Lifetime][1] in the *Amazon EC2 Auto Scaling User
     #   Guide*.
     #
-    #   Valid Range: Minimum value of 604800.
+    #   Valid Range: Minimum value of 0.
     #
     #
     #
@@ -1031,10 +1072,9 @@ module Aws::AutoScaling
     # Creates a launch configuration.
     #
     # If you exceed your maximum limit of launch configurations, the call
-    # fails. For information about viewing this limit, see
-    # DescribeAccountLimits. For information about updating this limit, see
-    # [Amazon EC2 Auto Scaling Service Quotas][1] in the *Amazon EC2 Auto
-    # Scaling User Guide*.
+    # fails. To query this limit, call the DescribeAccountLimits API. For
+    # information about updating this limit, see [Amazon EC2 Auto Scaling
+    # Service Quotas][1] in the *Amazon EC2 Auto Scaling User Guide*.
     #
     # For more information, see [Launch Configurations][2] in the *Amazon
     # EC2 Auto Scaling User Guide*.
@@ -1416,13 +1456,13 @@ module Aws::AutoScaling
     # associated action.
     #
     # To remove instances from the Auto Scaling group before deleting it,
-    # call DetachInstances with the list of instances and the option to
-    # decrement the desired capacity. This ensures that Amazon EC2 Auto
+    # call the DetachInstances API with the list of instances and the option
+    # to decrement the desired capacity. This ensures that Amazon EC2 Auto
     # Scaling does not launch replacement instances.
     #
     # To terminate all instances before deleting the Auto Scaling group,
-    # call UpdateAutoScalingGroup and set the minimum size and desired
-    # capacity of the Auto Scaling group to zero.
+    # call the UpdateAutoScalingGroup API and set the minimum size and
+    # desired capacity of the Auto Scaling group to zero.
     #
     # @option params [required, String] :auto_scaling_group_name
     #   The name of the Auto Scaling group.
@@ -1760,7 +1800,18 @@ module Aws::AutoScaling
       req.send_request(options)
     end
 
-    # Describes the policy adjustment types for use with PutScalingPolicy.
+    # Describes the available adjustment types for Amazon EC2 Auto Scaling
+    # scaling policies. These settings apply to step scaling policies and
+    # simple scaling policies; they do not apply to target tracking scaling
+    # policies.
+    #
+    # The following adjustment types are supported:
+    #
+    # * ChangeInCapacity
+    #
+    # * ExactCapacity
+    #
+    # * PercentChangeInCapacity
     #
     # @return [Types::DescribeAdjustmentTypesAnswer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1825,6 +1876,8 @@ module Aws::AutoScaling
     #   * {Types::AutoScalingGroupsType#auto_scaling_groups #auto_scaling_groups} => Array&lt;Types::AutoScalingGroup&gt;
     #   * {Types::AutoScalingGroupsType#next_token #next_token} => String
     #
+    # 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 an Auto Scaling group
     #
@@ -1956,6 +2009,13 @@ module Aws::AutoScaling
     #   resp.auto_scaling_groups[0].max_instance_lifetime #=> Integer
     #   resp.next_token #=> String
     #
+    #
+    # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
+    #
+    #   * group_exists
+    #   * group_in_service
+    #   * group_not_exists
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeAutoScalingGroups AWS API Documentation
     #
     # @overload describe_auto_scaling_groups(params = {})
@@ -1985,6 +2045,8 @@ module Aws::AutoScaling
     #   * {Types::AutoScalingInstancesType#auto_scaling_instances #auto_scaling_instances} => Array&lt;Types::AutoScalingInstanceDetails&gt;
     #   * {Types::AutoScalingInstancesType#next_token #next_token} => String
     #
+    # 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 one or more Auto Scaling instances
     #
@@ -2104,6 +2166,8 @@ module Aws::AutoScaling
     #   * {Types::LaunchConfigurationsType#launch_configurations #launch_configurations} => Array&lt;Types::LaunchConfiguration&gt;
     #   * {Types::LaunchConfigurationsType#next_token #next_token} => String
     #
+    # 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 launch configurations
     #
@@ -2363,8 +2427,8 @@ module Aws::AutoScaling
     # Describes the load balancers for the specified Auto Scaling group.
     #
     # This operation describes only Classic Load Balancers. If you have
-    # Application Load Balancers or Network Load Balancers, use
-    # DescribeLoadBalancerTargetGroups instead.
+    # Application Load Balancers or Network Load Balancers, use the
+    # DescribeLoadBalancerTargetGroups API instead.
     #
     # @option params [required, String] :auto_scaling_group_name
     #   The name of the Auto Scaling group.
@@ -2429,8 +2493,8 @@ module Aws::AutoScaling
     # Scaling.
     #
     # The `GroupStandbyInstances` metric is not returned by default. You
-    # must explicitly request this metric when calling
-    # EnableMetricsCollection.
+    # must explicitly request this metric when calling the
+    # EnableMetricsCollection API.
     #
     # @return [Types::DescribeMetricCollectionTypesAnswer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2515,6 +2579,8 @@ module Aws::AutoScaling
     #   * {Types::DescribeNotificationConfigurationsAnswer#notification_configurations #notification_configurations} => Array&lt;Types::NotificationConfiguration&gt;
     #   * {Types::DescribeNotificationConfigurationsAnswer#next_token #next_token} => String
     #
+    # 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 notification configurations
     #
@@ -2595,6 +2661,8 @@ module Aws::AutoScaling
     #   * {Types::PoliciesType#scaling_policies #scaling_policies} => Array&lt;Types::ScalingPolicy&gt;
     #   * {Types::PoliciesType#next_token #next_token} => String
     #
+    # 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
     #
@@ -2710,6 +2778,8 @@ module Aws::AutoScaling
     #   * {Types::ActivitiesType#activities #activities} => Array&lt;Types::Activity&gt;
     #   * {Types::ActivitiesType#next_token #next_token} => String
     #
+    # 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 the scaling activities for an Auto Scaling group
     #
@@ -2769,8 +2839,8 @@ module Aws::AutoScaling
       req.send_request(options)
     end
 
-    # Describes the scaling process types for use with ResumeProcesses and
-    # SuspendProcesses.
+    # Describes the scaling process types for use with the ResumeProcesses
+    # and SuspendProcesses APIs.
     #
     # @return [Types::ProcessesType] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2830,7 +2900,7 @@ module Aws::AutoScaling
 
     # Describes the actions scheduled for your Auto Scaling group that
     # haven't run or that have not reached their end time. To describe the
-    # actions that have already run, use DescribeScalingActivities.
+    # actions that have already run, call the DescribeScalingActivities API.
     #
     # @option params [String] :auto_scaling_group_name
     #   The name of the Auto Scaling group.
@@ -2862,6 +2932,8 @@ module Aws::AutoScaling
     #   * {Types::ScheduledActionsType#scheduled_update_group_actions #scheduled_update_group_actions} => Array&lt;Types::ScheduledUpdateGroupAction&gt;
     #   * {Types::ScheduledActionsType#next_token #next_token} => String
     #
+    # 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 scheduled actions
     #
@@ -2934,6 +3006,13 @@ module Aws::AutoScaling
     # for a particular tag only if it matches all the filters. If there's
     # no match, no special message is returned.
     #
+    # For more information, see [Tagging Auto Scaling Groups and
+    # Instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html
+    #
     # @option params [Array<Types::Filter>] :filters
     #   One or more filters to scope the tags to return. The maximum number of
     #   filters per filter type (for example, `auto-scaling-group`) is 1000.
@@ -2951,6 +3030,8 @@ module Aws::AutoScaling
     #   * {Types::TagsType#tags #tags} => Array&lt;Types::TagDescription&gt;
     #   * {Types::TagsType#next_token #next_token} => String
     #
+    # 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 tags
     #
@@ -3206,13 +3287,13 @@ module Aws::AutoScaling
     # Scaling group.
     #
     # This operation detaches only Classic Load Balancers. If you have
-    # Application Load Balancers or Network Load Balancers, use
-    # DetachLoadBalancerTargetGroups instead.
+    # Application Load Balancers or Network Load Balancers, use the
+    # DetachLoadBalancerTargetGroups API instead.
     #
     # When you detach a load balancer, it enters the `Removing` state while
     # deregistering the instances in the group. When all instances are
     # deregistered, then you can no longer describe the load balancer using
-    # DescribeLoadBalancers. The instances remain running.
+    # the DescribeLoadBalancers API call. The instances remain running.
     #
     # @option params [required, String] :auto_scaling_group_name
     #   The name of the Auto Scaling group.
@@ -3257,8 +3338,7 @@ module Aws::AutoScaling
     #   The name of the Auto Scaling group.
     #
     # @option params [Array<String>] :metrics
-    #   One or more of the following metrics. If you omit this parameter, all
-    #   metrics are disabled.
+    #   Specifies one or more of the following metrics:
     #
     #   * `GroupMinSize`
     #
@@ -3276,6 +3356,18 @@ module Aws::AutoScaling
     #
     #   * `GroupTotalInstances`
     #
+    #   * `GroupInServiceCapacity`
+    #
+    #   * `GroupPendingCapacity`
+    #
+    #   * `GroupStandbyCapacity`
+    #
+    #   * `GroupTerminatingCapacity`
+    #
+    #   * `GroupTotalCapacity`
+    #
+    #   If you omit this parameter, all metrics are disabled.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     #
@@ -3318,8 +3410,8 @@ module Aws::AutoScaling
     #   The name of the Auto Scaling group.
     #
     # @option params [Array<String>] :metrics
-    #   One or more of the following metrics. If you omit this parameter, all
-    #   metrics are enabled.
+    #   Specifies which group-level metrics to start collecting. You can
+    #   specify one or more of the following metrics:
     #
     #   * `GroupMinSize`
     #
@@ -3337,6 +3429,21 @@ module Aws::AutoScaling
     #
     #   * `GroupTotalInstances`
     #
+    #   The instance weighting feature supports the following additional
+    #   metrics:
+    #
+    #   * `GroupInServiceCapacity`
+    #
+    #   * `GroupPendingCapacity`
+    #
+    #   * `GroupStandbyCapacity`
+    #
+    #   * `GroupTerminatingCapacity`
+    #
+    #   * `GroupTotalCapacity`
+    #
+    #   If you omit this parameter, all metrics are enabled.
+    #
     # @option params [required, String] :granularity
     #   The granularity to associate with the metrics to collect. The only
     #   valid value is `1Minute`.
@@ -3638,11 +3745,11 @@ module Aws::AutoScaling
     #     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
-    #     RecordLifecycleActionHeartbeat.
+    #     keep the instance in a pending state using the
+    #     RecordLifecycleActionHeartbeat API call.
     #
     # 5.  If you finish before the timeout period ends, complete the
-    #     lifecycle action using CompleteLifecycleAction.
+    #     lifecycle action using the CompleteLifecycleAction API call.
     #
     # For more information, see [Amazon EC2 Auto Scaling Lifecycle Hooks][1]
     # in the *Amazon EC2 Auto Scaling User Guide*.
@@ -3650,9 +3757,10 @@ module Aws::AutoScaling
     # If you exceed your maximum limit of lifecycle hooks, which by default
     # is 50 per Auto Scaling group, the call fails.
     #
-    # You can view the lifecycle hooks for an Auto Scaling group using
-    # DescribeLifecycleHooks. If you are no longer using a lifecycle hook,
-    # you can delete it using DeleteLifecycleHook.
+    # You can view the lifecycle hooks for an Auto Scaling group using the
+    # DescribeLifecycleHooks API call. If you are no longer using a
+    # lifecycle hook, you can delete it by calling the DeleteLifecycleHook
+    # API.
     #
     #
     #
@@ -3710,8 +3818,8 @@ module Aws::AutoScaling
     #
     #   If the lifecycle hook times out, Amazon EC2 Auto Scaling performs the
     #   action that you specified in the `DefaultResult` parameter. You can
-    #   prevent the lifecycle hook from timing out by calling
-    #   RecordLifecycleActionHeartbeat.
+    #   prevent the lifecycle hook from timing out by calling the
+    #   RecordLifecycleActionHeartbeat API.
     #
     # @option params [String] :default_result
     #   Defines the action the Auto Scaling group should take when the
@@ -3779,9 +3887,9 @@ module Aws::AutoScaling
     #   Service (Amazon SNS) topic.
     #
     # @option params [required, Array<String>] :notification_types
-    #   The type of event that causes the notification to be sent. For more
-    #   information about notification types supported by Amazon EC2 Auto
-    #   Scaling, see DescribeAutoScalingNotificationTypes.
+    #   The type of event that causes the notification to be sent. To query
+    #   the notification types supported by Amazon EC2 Auto Scaling, call the
+    #   DescribeAutoScalingNotificationTypes API.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -3818,12 +3926,14 @@ module Aws::AutoScaling
     # Creates or updates a scaling policy for an Auto Scaling group.
     #
     # For more information about using scaling policies to scale your Auto
-    # Scaling group automatically, see [Dynamic Scaling][1] in the *Amazon
-    # EC2 Auto Scaling User Guide*.
+    # Scaling group, see [Target Tracking Scaling Policies][1] and [Step and
+    # Simple Scaling Policies][2] in the *Amazon EC2 Auto Scaling User
+    # Guide*.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-scale-based-on-demand.html
+    # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-scaling-target-tracking.html
+    # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-scaling-simple-step.html
     #
     # @option params [required, String] :auto_scaling_group_name
     #   The name of the Auto Scaling group.
@@ -3854,20 +3964,22 @@ module Aws::AutoScaling
     #   instead.
     #
     # @option params [Integer] :min_adjustment_magnitude
-    #   The minimum number of instances to scale. If the value of
-    #   `AdjustmentType` is `PercentChangeInCapacity`, the scaling policy
-    #   changes the `DesiredCapacity` of the Auto Scaling group by at least
-    #   this many instances. Otherwise, the error is `ValidationError`.
+    #   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*.
     #
-    #   This property replaces the `MinAdjustmentStep` property. 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 `SimpleScaling` or `StepScaling`.
+    #
+    #   [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
@@ -4073,14 +4185,16 @@ module Aws::AutoScaling
     #   [1]: http://crontab.org
     #
     # @option params [Integer] :min_size
-    #   The minimum number of instances in the Auto Scaling group.
+    #   The minimum size of the Auto Scaling group.
     #
     # @option params [Integer] :max_size
-    #   The maximum number of instances in the Auto Scaling group.
+    #   The maximum size of the Auto Scaling group.
     #
     # @option params [Integer] :desired_capacity
-    #   The number of EC2 instances that should be running in the Auto Scaling
-    #   group.
+    #   The desired capacity is the initial capacity of the Auto Scaling group
+    #   after the scheduled action runs and the capacity it attempts to
+    #   maintain. It can scale beyond this capacity if you add more scaling
+    #   conditions.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -4124,7 +4238,7 @@ module Aws::AutoScaling
 
     # Records a heartbeat for the lifecycle action associated with the
     # specified token or instance. This extends the timeout by the length of
-    # time defined using PutLifecycleHook.
+    # time defined using the PutLifecycleHook API call.
     #
     # This step is a part of the procedure for adding a lifecycle hook to an
     # Auto Scaling group:
@@ -4265,19 +4379,25 @@ module Aws::AutoScaling
 
     # Sets the size of the specified Auto Scaling group.
     #
-    # For more information about desired capacity, see [What Is Amazon EC2
-    # Auto Scaling?][1] in the *Amazon EC2 Auto Scaling User Guide*.
+    # If a scale-in activity occurs as a result of a new `DesiredCapacity`
+    # value that is lower than the current size of the group, the Auto
+    # Scaling group uses its termination policy to determine which instances
+    # to terminate.
+    #
+    # For more information, see [Manual Scaling][1] in the *Amazon EC2 Auto
+    # Scaling User Guide*.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/what-is-amazon-ec2-auto-scaling.html
+    # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-manual-scaling.html
     #
     # @option params [required, String] :auto_scaling_group_name
     #   The name of the Auto Scaling group.
     #
     # @option params [required, Integer] :desired_capacity
-    #   The number of EC2 instances that should be running in the Auto Scaling
-    #   group.
+    #   The desired capacity is the initial capacity of the Auto Scaling group
+    #   after this operation completes and the capacity it attempts to
+    #   maintain.
     #
     # @option params [Boolean] :honor_cooldown
     #   Indicates whether Amazon EC2 Auto Scaling waits for the cooldown
@@ -4341,7 +4461,12 @@ module Aws::AutoScaling
     #   not respect the grace period associated with the group.
     #
     #   For more information about the health check grace period, see
-    #   CreateAutoScalingGroup.
+    #   [CreateAutoScalingGroup][1] in the *Amazon EC2 Auto Scaling API
+    #   Reference*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_CreateAutoScalingGroup.html
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -4440,12 +4565,12 @@ module Aws::AutoScaling
     # for the specified Auto Scaling group.
     #
     # If you suspend either the `Launch` or `Terminate` process types, it
-    # can prevent other process types from functioning properly.
-    #
-    # To resume processes that have been suspended, use ResumeProcesses.
+    # can prevent other process types from functioning properly. For more
+    # information, see [Suspending and Resuming Scaling Processes][1] in the
+    # *Amazon EC2 Auto Scaling User Guide*.
     #
-    # For more information, see [Suspending and Resuming Scaling
-    # Processes][1] in the *Amazon EC2 Auto Scaling User Guide*.
+    # To resume processes that have been suspended, call the ResumeProcesses
+    # API.
     #
     #
     #
@@ -4505,10 +4630,12 @@ module Aws::AutoScaling
     end
 
     # Terminates the specified instance and optionally adjusts the desired
-    # group size. This call simply makes a termination request. The instance
-    # is not terminated immediately. When an instance is terminated, the
-    # instance status changes to `terminated`. You can't connect to or
-    # start an instance after you've terminated it.
+    # group size.
+    #
+    # This call simply makes a termination request. The instance is not
+    # terminated immediately. When an instance is terminated, the instance
+    # status changes to `terminated`. You can't connect to or start an
+    # instance after you've terminated it.
     #
     # If you do not specify the option to decrement the desired capacity,
     # Amazon EC2 Auto Scaling launches instances to replace the ones that
@@ -4601,7 +4728,7 @@ module Aws::AutoScaling
     # Note the following about changing `DesiredCapacity`, `MaxSize`, or
     # `MinSize`\:
     #
-    # * If a scale-in event occurs as a result of a new `DesiredCapacity`
+    # * If a scale-in activity occurs as a result of a new `DesiredCapacity`
     #   value that is lower than the current size of the group, the Auto
     #   Scaling group uses its termination policy to determine which
     #   instances to terminate.
@@ -4616,10 +4743,11 @@ module Aws::AutoScaling
     #   current size of the group, this sets the group's `DesiredCapacity`
     #   to the new `MaxSize` value.
     #
-    # To see which parameters have been set, use DescribeAutoScalingGroups.
-    # You can also view the scaling policies for an Auto Scaling group using
-    # DescribePolicies. If the group has scaling policies, you can update
-    # them using PutScalingPolicy.
+    # To see which parameters have been set, call the
+    # DescribeAutoScalingGroups API. To view the scaling policies for an
+    # Auto Scaling group, call the DescribePolicies API. If the group has
+    # scaling policies, you can update them by calling the PutScalingPolicy
+    # API.
     #
     # @option params [required, String] :auto_scaling_group_name
     #   The name of the Auto Scaling group.
@@ -4664,10 +4792,22 @@ module Aws::AutoScaling
     # @option params [Integer] :max_size
     #   The maximum size of the Auto Scaling group.
     #
+    #   <note markdown="1"> With a mixed instances policy that uses instance weighting, Amazon EC2
+    #   Auto Scaling may need to go above `MaxSize` to meet your capacity
+    #   requirements. In this event, Amazon EC2 Auto Scaling will never go
+    #   above `MaxSize` by more than your maximum instance weight (weights
+    #   that define how many capacity units each instance contributes to the
+    #   capacity of the group).
+    #
+    #    </note>
+    #
     # @option params [Integer] :desired_capacity
-    #   The number of EC2 instances that should be running in the Auto Scaling
-    #   group. This number must be greater than or equal to the minimum size
-    #   of the group and less than or equal to the maximum size of the group.
+    #   The desired capacity is the initial capacity of the Auto Scaling group
+    #   after this operation completes and the capacity it attempts to
+    #   maintain.
+    #
+    #   This number must be greater than or equal to the minimum size of the
+    #   group and less than or equal to the maximum size of the group.
     #
     # @option params [Integer] :default_cooldown
     #   The amount of time, in seconds, after a scaling activity completes
@@ -4763,13 +4903,17 @@ module Aws::AutoScaling
     #
     # @option params [Integer] :max_instance_lifetime
     #   The maximum amount of time, in seconds, that an instance can be in
-    #   service.
+    #   service. The default is null.
+    #
+    #   This parameter is optional, but if you specify a value for it, you
+    #   must specify a value of at least 604,800 seconds (7 days). To clear a
+    #   previously set value, specify a new value of 0.
     #
     #   For more information, see [Replacing Auto Scaling Instances Based on
     #   Maximum Instance Lifetime][1] in the *Amazon EC2 Auto Scaling User
     #   Guide*.
     #
-    #   Valid Range: Minimum value of 604800.
+    #   Valid Range: Minimum value of 0.
     #
     #
     #
@@ -4876,7 +5020,7 @@ module Aws::AutoScaling
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-autoscaling'
-      context[:gem_version] = '1.33.0'
+      context[:gem_version] = '1.38.1'
       Seahorse::Client::Request.new(handlers, context)
     end
 
@@ -4942,11 +5086,11 @@ module Aws::AutoScaling
     # The following table lists the valid waiter names, the operations they call,
     # and the default `:delay` and `:max_attempts` values.
     #
-    # | waiter_name      | params                          | :delay   | :max_attempts |
-    # | ---------------- | ------------------------------- | -------- | ------------- |
-    # | group_exists     | {#describe_auto_scaling_groups} | 5        | 10            |
-    # | group_in_service | {#describe_auto_scaling_groups} | 15       | 40            |
-    # | group_not_exists | {#describe_auto_scaling_groups} | 15       | 40            |
+    # | waiter_name      | params                                | :delay   | :max_attempts |
+    # | ---------------- | ------------------------------------- | -------- | ------------- |
+    # | group_exists     | {Client#describe_auto_scaling_groups} | 5        | 10            |
+    # | group_in_service | {Client#describe_auto_scaling_groups} | 15       | 40            |
+    # | group_not_exists | {Client#describe_auto_scaling_groups} | 15       | 40            |
     #
     # @raise [Errors::FailureStateError] Raised when the waiter terminates
     #   because the waiter has entered a state that it will not transition