aws-sdk-autoscaling 1.39.0 → 1.44.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e5404e2eb252f0a163fb5a8cea3469cbabcaf0157f7738ddd49359e33b143be9
-  data.tar.gz: d5c9927c514ec92b68c5a0de74df7c6735dc2d81e78cdbe6ab99dd2486803b96
+  metadata.gz: d9338aef7407ed1a6a177b908711fdb67c437ebb2f6665583ba9ad4e1b47b77b
+  data.tar.gz: 822b50f1ae3f3c8a26e10516402a1d415c48c45acee361af5ec7169bea64d2f2
 SHA512:
-  metadata.gz: c5c654365fe64a802102c863e32b49252333caf20c4f54060617a449118c4785d900263c314563122920f87e90cf741b4188ba5cb4aaf906c79dc8f6653b356d
-  data.tar.gz: 7b457015127c2fe627e4896dc36246fad672409992b8a7fc664536442cb3e7ecb8115b1e47e8fcb32896687ec90099316eeb8ac73595064ba401b9cba5e3dbe0
+  metadata.gz: 7d8d5844e9c901ddacc8a8fdef0d4d38c7db11e387e381c13b22b1a58dc6ca428fee5e46d49a56cd50bc1b3d87632627ba32be52d0681aa4441c73ccce73f52b
+  data.tar.gz: 7a10202d63836e53c5aea8474401f123bfe717bbc8bfa45161957fc0f8f6a94f2f1048d209c9f17f09d51ae3513528c675191b047cd786dc449cc39a5ae932f6

data/lib/aws-sdk-autoscaling.rb

@@ -58,6 +58,6 @@ require_relative 'aws-sdk-autoscaling/customizations'
 # @service
 module Aws::AutoScaling
 
-  GEM_VERSION = '1.39.0'
+  GEM_VERSION = '1.44.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

@@ -582,6 +582,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 +712,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 +811,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 +831,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 +895,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 +1008,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 +1381,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 +1444,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 +1728,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 +1897,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 +2247,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 +2273,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 +2432,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 +2856,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 +3761,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 +3774,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 +3792,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 +3972,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 +4134,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 +4160,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 +4215,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 +4275,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 +4799,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 +4819,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 +5121,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 +5138,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 +5165,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 +5343,7 @@ module Aws::AutoScaling
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-autoscaling'
-      context[:gem_version] = '1.39.0'
+      context[:gem_version] = '1.44.0'
       Seahorse::Client::Request.new(handlers, context)
     end