aws-sdk-autoscaling 1.40.0 → 1.45.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 21162b28994033fe0561bd454630f85ec3e09bfaf1d19030a2a600a2e9246b47
-  data.tar.gz: 20d545494b188d07ac04240ee6d7dffad9614b38d7a4c4f26de204d4d6762969
+  metadata.gz: 49f61c96c0e1335511bafaeab330a090cc8762b3f3ea328210bb2fe47d36bdaf
+  data.tar.gz: a766f6338b30fd0f293d70f563113e1c364fd1f8d3c8241c8f31bb521ffa792c
 SHA512:
-  metadata.gz: d29d595273b5ab4103bdc7c01c128fe0f32b062b3e647303e9d4d1421d12d9ab5be3961295149216bbcd73ff97043c62250c21e1ce582abd2368ce7afbc9c218
-  data.tar.gz: 113b4092ff01627ad2e23a85869cca40bfe5bc2be421dc3055554b59b8a455b6843de3fc29ddb9d0b9a0a3eef983b31ff26702204d6535b6031b19631219c8a2
+  metadata.gz: f79d129000173f7ea8affaf93511b0066546f6d6c155e0c9da5e5cd8ff90d5c4af6004db128e61d65a796584ae01e561d2f2d54cbee6fa60593fd64cc3c0b9cf
+  data.tar.gz: c120c9a2e71e6825d6cfbcf83380035a4f7533ccc8dcca89f146a799d4dc4bb3dc41d3fc84bc1855e5c2e91179e0e3d1509ac467b5891fd31f850860c80944b7

data/lib/aws-sdk-autoscaling.rb

@@ -55,9 +55,9 @@ require_relative 'aws-sdk-autoscaling/customizations'
 #
 # See {Errors} for more information.
 #
-# @service
+# @!group service
 module Aws::AutoScaling
 
-  GEM_VERSION = '1.40.0'
+  GEM_VERSION = '1.45.0'
 
 end

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

@@ -77,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]
@@ -585,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 (for example, 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*.
     #
@@ -604,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*.
     #
     #
     #
@@ -653,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`.
     #
     #
     #
@@ -938,8 +956,8 @@ module Aws::AutoScaling
     #   <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
+    #   above `MaxSize` by more than your largest instance weight (weights
+    #   that define how many units each instance contributes to the desired
     #   capacity of the group).
     #
     #    </note>
@@ -953,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*.
     #
     #
     #
@@ -979,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

@@ -85,13 +85,28 @@ module Aws::AutoScaling
     #     * `Aws::Credentials` - Used for configuring static, non-refreshing
     #       credentials.
     #
+    #     * `Aws::SharedCredentials` - Used for loading static credentials from a
+    #       shared file, such as `~/.aws/config`.
+    #
+    #     * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+    #
+    #     * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
+    #       assume a role after providing credentials via the web.
+    #
+    #     * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
+    #       access token generated from `aws login`.
+    #
+    #     * `Aws::ProcessCredentials` - Used for loading credentials from a
+    #       process that outputs to stdout.
+    #
     #     * `Aws::InstanceProfileCredentials` - Used for loading credentials
     #       from an EC2 IMDS on an EC2 instance.
     #
-    #     * `Aws::SharedCredentials` - Used for loading credentials from a
-    #       shared file, such as `~/.aws/config`.
+    #     * `Aws::ECSCredentials` - Used for loading credentials from
+    #       instances running in ECS.
     #
-    #     * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+    #     * `Aws::CognitoIdentityCredentials` - Used for loading credentials
+    #       from the Cognito Identity service.
     #
     #     When `:credentials` are not configured directly, the following
     #     locations will be searched for credentials:
@@ -101,10 +116,10 @@ module Aws::AutoScaling
     #     * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
     #     * `~/.aws/credentials`
     #     * `~/.aws/config`
-    #     * EC2 IMDS instance profile - When used by default, the timeouts are
-    #       very aggressive. Construct and pass an instance of
-    #       `Aws::InstanceProfileCredentails` to enable retries and extended
-    #       timeouts.
+    #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
+    #       are very aggressive. Construct and pass an instance of
+    #       `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
+    #       enable retries and extended timeouts.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -582,6 +597,20 @@ module Aws::AutoScaling
     #
     #   * {Types::CancelInstanceRefreshAnswer#instance_refresh_id #instance_refresh_id} => String
     #
+    #
+    # @example Example: To cancel an instance refresh
+    #
+    #   # This example cancels an instance refresh operation in progress.
+    #
+    #   resp = client.cancel_instance_refresh({
+    #     auto_scaling_group_name: "my-auto-scaling-group", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     instance_refresh_id: "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.cancel_instance_refresh({
@@ -698,6 +727,13 @@ module Aws::AutoScaling
     # Scaling User Guide*. For more information, see [Auto Scaling
     # Groups][4] in the *Amazon EC2 Auto Scaling User Guide*.
     #
+    # Every Auto Scaling group has three size parameters (`DesiredCapacity`,
+    # `MaxSize`, and `MinSize`). Usually, you set these sizes based on a
+    # specific number of instances. However, if you configure a mixed
+    # instances policy that defines weights for the instance types, you must
+    # specify these sizes with the same units that you use for weighting
+    # instances.
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-account-limits.html
@@ -790,8 +826,8 @@ module Aws::AutoScaling
     #   <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
+    #   above `MaxSize` by more than your largest instance weight (weights
+    #   that define how many units each instance contributes to the desired
     #   capacity of the group).
     #
     #    </note>
@@ -810,8 +846,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*.
     #
     #
     #
@@ -872,8 +910,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.
     #
     #
     #
@@ -986,46 +1023,50 @@ module Aws::AutoScaling
     #
     #   resp = client.create_auto_scaling_group({
     #     auto_scaling_group_name: "my-auto-scaling-group", 
-    #     launch_configuration_name: "my-launch-config", 
+    #     launch_template: {
+    #       launch_template_id: "lt-0a20c965061f64abc", 
+    #       version: "$Latest", 
+    #     }, 
+    #     max_instance_lifetime: 2592000, 
     #     max_size: 3, 
     #     min_size: 1, 
-    #     vpc_zone_identifier: "subnet-4176792c", 
+    #     vpc_zone_identifier: "subnet-057fa0918fEXAMPLE", 
     #   })
     #
-    # @example Example: To create an Auto Scaling group with an attached load balancer
+    # @example Example: To create an Auto Scaling group with an attached target group
     #
-    #   # This example creates an Auto Scaling group and attaches the specified Classic Load Balancer.
+    #   # This example creates an Auto Scaling group and attaches the specified target group.
     #
     #   resp = client.create_auto_scaling_group({
     #     auto_scaling_group_name: "my-auto-scaling-group", 
-    #     availability_zones: [
-    #       "us-west-2c", 
-    #     ], 
     #     health_check_grace_period: 120, 
     #     health_check_type: "ELB", 
     #     launch_configuration_name: "my-launch-config", 
-    #     load_balancer_names: [
-    #       "my-load-balancer", 
-    #     ], 
     #     max_size: 3, 
     #     min_size: 1, 
+    #     target_group_arns: [
+    #       "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", 
+    #     ], 
+    #     vpc_zone_identifier: "subnet-057fa0918fEXAMPLE, subnet-610acd08EXAMPLE", 
     #   })
     #
-    # @example Example: To create an Auto Scaling group with an attached target group
+    # @example Example: To create an Auto Scaling group with an attached load balancer
     #
-    #   # This example creates an Auto Scaling group and attaches the specified target group.
+    #   # This example creates an Auto Scaling group and attaches the specified Classic Load Balancer.
     #
     #   resp = client.create_auto_scaling_group({
     #     auto_scaling_group_name: "my-auto-scaling-group", 
+    #     availability_zones: [
+    #       "us-west-2c", 
+    #     ], 
     #     health_check_grace_period: 120, 
     #     health_check_type: "ELB", 
     #     launch_configuration_name: "my-launch-config", 
+    #     load_balancer_names: [
+    #       "my-load-balancer", 
+    #     ], 
     #     max_size: 3, 
     #     min_size: 1, 
-    #     target_group_arns: [
-    #       "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", 
-    #     ], 
-    #     vpc_zone_identifier: "subnet-4176792c, subnet-65ea5f08", 
     #   })
     #
     # @example Request syntax with placeholder values
@@ -1355,6 +1396,15 @@ module Aws::AutoScaling
     #
     #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-vpc-tenancy
     #
+    # @option params [Types::InstanceMetadataOptions] :metadata_options
+    #   The metadata options for the instances. For more information, see
+    #   [Instance Metadata and User Data][1] in the *Amazon EC2 User Guide for
+    #   Linux Instances*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     #
@@ -1409,6 +1459,11 @@ module Aws::AutoScaling
     #     ebs_optimized: false,
     #     associate_public_ip_address: false,
     #     placement_tenancy: "XmlStringMaxLen64",
+    #     metadata_options: {
+    #       http_tokens: "optional", # accepts optional, required
+    #       http_put_response_hop_limit: 1,
+    #       http_endpoint: "disabled", # accepts disabled, enabled
+    #     },
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CreateLaunchConfiguration AWS API Documentation
@@ -1688,7 +1743,7 @@ module Aws::AutoScaling
     #
     #   resp = client.delete_policy({
     #     auto_scaling_group_name: "my-auto-scaling-group", 
-    #     policy_name: "ScaleIn", 
+    #     policy_name: "my-step-scale-out-policy", 
     #   })
     #
     # @example Request syntax with placeholder values
@@ -1857,7 +1912,7 @@ module Aws::AutoScaling
     #   * {Types::DescribeAdjustmentTypesAnswer#adjustment_types #adjustment_types} => Array&lt;Types::AdjustmentType&gt;
     #
     #
-    # @example Example: To describe the Auto Scaling adjustment types
+    # @example Example: To describe the Amazon EC2 Auto Scaling adjustment types
     #
     #   # This example describes the available adjustment types.
     #
@@ -2207,6 +2262,13 @@ module Aws::AutoScaling
     #
     # * `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.
     #
@@ -2226,6 +2288,38 @@ module Aws::AutoScaling
     #   * {Types::DescribeInstanceRefreshesAnswer#instance_refreshes #instance_refreshes} => Array&lt;Types::InstanceRefresh&gt;
     #   * {Types::DescribeInstanceRefreshesAnswer#next_token #next_token} => String
     #
+    #
+    # @example Example: To list instance refreshes
+    #
+    #   # This example describes the instance refreshes for the specified Auto Scaling group.
+    #
+    #   resp = client.describe_instance_refreshes({
+    #     auto_scaling_group_name: "my-auto-scaling-group", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     instance_refreshes: [
+    #       {
+    #         auto_scaling_group_name: "my-auto-scaling-group", 
+    #         instance_refresh_id: "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b", 
+    #         instances_to_update: 5, 
+    #         percentage_complete: 0, 
+    #         start_time: Time.parse("2020-06-02T18:11:27Z"), 
+    #         status: "InProgress", 
+    #       }, 
+    #       {
+    #         auto_scaling_group_name: "my-auto-scaling-group", 
+    #         end_time: Time.parse("2020-06-02T16:53:37Z"), 
+    #         instance_refresh_id: "dd7728d0-5bc4-4575-96a3-1b2c52bf8bb1", 
+    #         instances_to_update: 0, 
+    #         percentage_complete: 100, 
+    #         start_time: Time.parse("2020-06-02T16:43:19Z"), 
+    #         status: "Successful", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_instance_refreshes({
@@ -2353,6 +2447,9 @@ module Aws::AutoScaling
     #   resp.launch_configurations[0].ebs_optimized #=> Boolean
     #   resp.launch_configurations[0].associate_public_ip_address #=> Boolean
     #   resp.launch_configurations[0].placement_tenancy #=> String
+    #   resp.launch_configurations[0].metadata_options.http_tokens #=> String, one of "optional", "required"
+    #   resp.launch_configurations[0].metadata_options.http_put_response_hop_limit #=> Integer
+    #   resp.launch_configurations[0].metadata_options.http_endpoint #=> String, one of "disabled", "enabled"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLaunchConfigurations AWS API Documentation
@@ -2774,7 +2871,7 @@ module Aws::AutoScaling
     # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
     #
     #
-    # @example Example: To describe Auto Scaling policies
+    # @example Example: To describe scaling policies
     #
     #   # This example describes the policies for the specified Auto Scaling group.
     #
@@ -3679,7 +3776,8 @@ module Aws::AutoScaling
       req.send_request(options)
     end
 
-    # Executes the specified policy.
+    # Executes the specified policy. This can be useful for testing the
+    # design of your scaling policy.
     #
     # @option params [String] :auto_scaling_group_name
     #   The name of the Auto Scaling group.
@@ -3691,11 +3789,9 @@ module Aws::AutoScaling
     #   Indicates whether Amazon EC2 Auto Scaling waits for the cooldown
     #   period to complete before executing the policy.
     #
-    #   This parameter is not supported if the policy type is `StepScaling` or
-    #   `TargetTrackingScaling`.
-    #
-    #   For more information, see [Scaling Cooldowns][1] in the *Amazon EC2
-    #   Auto Scaling User Guide*.
+    #   Valid only if the policy type is `SimpleScaling`. For more
+    #   information, see [Scaling Cooldowns for Amazon EC2 Auto Scaling][1] in
+    #   the *Amazon EC2 Auto Scaling User Guide*.
     #
     #
     #
@@ -3711,26 +3807,27 @@ module Aws::AutoScaling
     #   If you specify a metric value that doesn't correspond to a step
     #   adjustment for the policy, the call returns an error.
     #
-    #   Conditional: This parameter is required if the policy type is
-    #   `StepScaling` and not supported otherwise.
+    #   Required if the policy type is `StepScaling` and not supported
+    #   otherwise.
     #
     # @option params [Float] :breach_threshold
     #   The breach threshold for the alarm.
     #
-    #   Conditional: This parameter is required if the policy type is
-    #   `StepScaling` and not supported otherwise.
+    #   Required if the policy type is `StepScaling` and not supported
+    #   otherwise.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     #
-    # @example Example: To execute an Auto Scaling policy
+    # @example Example: To execute a scaling policy
     #
-    #   # This example executes the specified Auto Scaling policy for the specified Auto Scaling group.
+    #   # This example executes the specified policy.
     #
     #   resp = client.execute_policy({
     #     auto_scaling_group_name: "my-auto-scaling-group", 
-    #     honor_cooldown: true, 
-    #     policy_name: "ScaleIn", 
+    #     breach_threshold: 50.0, 
+    #     metric_value: 59.0, 
+    #     policy_name: "my-step-scale-out-policy", 
     #   })
     #
     # @example Request syntax with placeholder values
@@ -3890,16 +3987,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
@@ -4052,16 +4149,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 (for example, 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*.
     #
@@ -4074,43 +4175,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*.
     #
     #
     #
@@ -4127,27 +4230,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`.
     #
     #
     #
@@ -4174,15 +4290,31 @@ module Aws::AutoScaling
     #   # This example adds the specified policy to the specified Auto Scaling group.
     #
     #   resp = client.put_scaling_policy({
-    #     adjustment_type: "ChangeInCapacity", 
     #     auto_scaling_group_name: "my-auto-scaling-group", 
-    #     policy_name: "ScaleIn", 
-    #     scaling_adjustment: -1, 
+    #     policy_name: "alb1000-target-tracking-scaling-policy", 
+    #     policy_type: "TargetTrackingScaling", 
+    #     target_tracking_configuration: {
+    #       predefined_metric_specification: {
+    #         predefined_metric_type: "ALBRequestCountPerTarget", 
+    #         resource_label: "app/EC2Co-EcsEl-1TKLTMITMM0EO/f37c06a68c1748aa/targetgroup/EC2Co-Defau-LDNM7Q3ZH1ZN/6d4ea56ca2d6a18d", 
+    #       }, 
+    #       target_value: 1000.0, 
+    #     }, 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
-    #     policy_arn: "arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:2233f3d7-6290-403b-b632-93c553560106:autoScalingGroupName/my-auto-scaling-group:policyName/ScaleIn", 
+    #     alarms: [
+    #       {
+    #         alarm_arn: "arn:aws:cloudwatch:us-west-2:123456789012:alarm:TargetTracking-my-asg-AlarmHigh-fc0e4183-23ac-497e-9992-691c9980c38e", 
+    #         alarm_name: "TargetTracking-my-asg-AlarmHigh-fc0e4183-23ac-497e-9992-691c9980c38e", 
+    #       }, 
+    #       {
+    #         alarm_arn: "arn:aws:cloudwatch:us-west-2:123456789012:alarm:TargetTracking-my-asg-AlarmLow-61a39305-ed0c-47af-bd9e-471a352ee1a2", 
+    #         alarm_name: "TargetTracking-my-asg-AlarmLow-61a39305-ed0c-47af-bd9e-471a352ee1a2", 
+    #       }, 
+    #     ], 
+    #     policy_arn: "arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:228f02c2-c665-4bfd-aaac-8b04080bea3c:autoScalingGroupName/my-auto-scaling-group:policyName/alb1000-target-tracking-scaling-policy", 
     #   }
     #
     # @example Request syntax with placeholder values
@@ -4682,7 +4814,7 @@ module Aws::AutoScaling
     # 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 active instance refresh operation, use the
+    # API. To cancel an instance refresh operation in progress, use the
     # CancelInstanceRefresh API.
     #
     # For more information, see [Replacing Auto Scaling Instances Based on
@@ -4702,17 +4834,47 @@ module Aws::AutoScaling
     #   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
+    #   standby or are protected from scale in. If the rolling update process
     #   fails, any instances that were already replaced are not rolled back to
     #   their previous configuration.
     #
     # @option params [Types::RefreshPreferences] :preferences
     #   Set of preferences associated with the instance refresh request.
     #
+    #   If not provided, the default values are used. For
+    #   `MinHealthyPercentage`, the default value is `90`. For
+    #   `InstanceWarmup`, the default is to use the value specified for the
+    #   health check grace period for the Auto Scaling group.
+    #
+    #   For more information, see [RefreshPreferences][1] in the *Amazon EC2
+    #   Auto Scaling API Reference*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_RefreshPreferences.html
+    #
     # @return [Types::StartInstanceRefreshAnswer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::StartInstanceRefreshAnswer#instance_refresh_id #instance_refresh_id} => String
     #
+    #
+    # @example Example: To start an instance refresh
+    #
+    #   # This example starts an instance refresh for the specified Auto Scaling group.
+    #
+    #   resp = client.start_instance_refresh({
+    #     auto_scaling_group_name: "my-auto-scaling-group", 
+    #     preferences: {
+    #       instance_warmup: 400, 
+    #       min_healthy_percentage: 50, 
+    #     }, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     instance_refresh_id: "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.start_instance_refresh({
@@ -4974,8 +5136,8 @@ module Aws::AutoScaling
     #   <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
+    #   above `MaxSize` by more than your largest instance weight (weights
+    #   that define how many units each instance contributes to the desired
     #   capacity of the group).
     #
     #    </note>
@@ -4991,13 +5153,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*.
     #
     #
     #
@@ -5020,8 +5180,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.
     #
     #
     #
@@ -5199,7 +5358,7 @@ module Aws::AutoScaling
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-autoscaling'
-      context[:gem_version] = '1.40.0'
+      context[:gem_version] = '1.45.0'
       Seahorse::Client::Request.new(handlers, context)
     end