aws-sdk-autoscaling 1.40.0 → 1.45.0

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

@@ -123,6 +123,10 @@ module Aws::AutoScaling
     HonorCooldown = Shapes::BooleanShape.new(name: 'HonorCooldown')
     Instance = Shapes::StructureShape.new(name: 'Instance')
     InstanceIds = Shapes::ListShape.new(name: 'InstanceIds')
+    InstanceMetadataEndpointState = Shapes::StringShape.new(name: 'InstanceMetadataEndpointState')
+    InstanceMetadataHttpPutResponseHopLimit = Shapes::IntegerShape.new(name: 'InstanceMetadataHttpPutResponseHopLimit')
+    InstanceMetadataHttpTokensState = Shapes::StringShape.new(name: 'InstanceMetadataHttpTokensState')
+    InstanceMetadataOptions = Shapes::StructureShape.new(name: 'InstanceMetadataOptions')
     InstanceMonitoring = Shapes::StructureShape.new(name: 'InstanceMonitoring')
     InstanceProtected = Shapes::BooleanShape.new(name: 'InstanceProtected')
     InstanceRefresh = Shapes::StructureShape.new(name: 'InstanceRefresh')
@@ -472,6 +476,7 @@ module Aws::AutoScaling
     CreateLaunchConfigurationType.add_member(:ebs_optimized, Shapes::ShapeRef.new(shape: EbsOptimized, location_name: "EbsOptimized"))
     CreateLaunchConfigurationType.add_member(:associate_public_ip_address, Shapes::ShapeRef.new(shape: AssociatePublicIpAddress, location_name: "AssociatePublicIpAddress"))
     CreateLaunchConfigurationType.add_member(:placement_tenancy, Shapes::ShapeRef.new(shape: XmlStringMaxLen64, location_name: "PlacementTenancy"))
+    CreateLaunchConfigurationType.add_member(:metadata_options, Shapes::ShapeRef.new(shape: InstanceMetadataOptions, location_name: "MetadataOptions"))
     CreateLaunchConfigurationType.struct_class = Types::CreateLaunchConfigurationType
 
     CreateOrUpdateTagsType.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, required: true, location_name: "Tags"))
@@ -697,6 +702,11 @@ module Aws::AutoScaling
 
     InstanceIds.member = Shapes::ShapeRef.new(shape: XmlStringMaxLen19)
 
+    InstanceMetadataOptions.add_member(:http_tokens, Shapes::ShapeRef.new(shape: InstanceMetadataHttpTokensState, location_name: "HttpTokens"))
+    InstanceMetadataOptions.add_member(:http_put_response_hop_limit, Shapes::ShapeRef.new(shape: InstanceMetadataHttpPutResponseHopLimit, location_name: "HttpPutResponseHopLimit"))
+    InstanceMetadataOptions.add_member(:http_endpoint, Shapes::ShapeRef.new(shape: InstanceMetadataEndpointState, location_name: "HttpEndpoint"))
+    InstanceMetadataOptions.struct_class = Types::InstanceMetadataOptions
+
     InstanceMonitoring.add_member(:enabled, Shapes::ShapeRef.new(shape: MonitoringEnabled, location_name: "Enabled"))
     InstanceMonitoring.struct_class = Types::InstanceMonitoring
 
@@ -749,6 +759,7 @@ module Aws::AutoScaling
     LaunchConfiguration.add_member(:ebs_optimized, Shapes::ShapeRef.new(shape: EbsOptimized, location_name: "EbsOptimized"))
     LaunchConfiguration.add_member(:associate_public_ip_address, Shapes::ShapeRef.new(shape: AssociatePublicIpAddress, location_name: "AssociatePublicIpAddress"))
     LaunchConfiguration.add_member(:placement_tenancy, Shapes::ShapeRef.new(shape: XmlStringMaxLen64, location_name: "PlacementTenancy"))
+    LaunchConfiguration.add_member(:metadata_options, Shapes::ShapeRef.new(shape: InstanceMetadataOptions, location_name: "MetadataOptions"))
     LaunchConfiguration.struct_class = Types::LaunchConfiguration
 
     LaunchConfigurationNameType.add_member(:launch_configuration_name, Shapes::ShapeRef.new(shape: ResourceName, required: true, location_name: "LaunchConfigurationName"))

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

@@ -260,6 +260,18 @@ module Aws::AutoScaling
       data[:placement_tenancy]
     end
 
+    # 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 [Types::InstanceMetadataOptions]
+    def metadata_options
+      data[:metadata_options]
+    end
+
     # @!endgroup
 
     # @return [Client]

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

@@ -301,15 +301,15 @@ 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 options [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 options [String] :notification_target_arn
     #   The ARN of the notification target that Amazon EC2 Auto Scaling uses
     #   to notify you when an instance is in the transition state for the

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

@@ -185,8 +185,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>
@@ -203,8 +203,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*.
     #
     #
     #
@@ -260,8 +262,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.
     #
     #
     #
@@ -402,6 +403,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
+    #     },
     #   })
     # @param [Hash] options ({})
     # @option options [required, String] :launch_configuration_name
@@ -618,6 +624,14 @@ module Aws::AutoScaling
     #
     #
     #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-vpc-tenancy
+    # @option options [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 [LaunchConfiguration]
     def create_launch_configuration(options = {})
       @client.create_launch_configuration(options)

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

@@ -47,16 +47,30 @@ module Aws::AutoScaling
       data[:policy_arn]
     end
 
-    # The policy type. The valid values are `SimpleScaling`, `StepScaling`,
-    # and `TargetTrackingScaling`.
+    # One of the following policy types:
+    #
+    # * `TargetTrackingScaling`
+    #
+    # * `StepScaling`
+    #
+    # * `SimpleScaling` (default)
+    #
+    # For more information, 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-scaling-target-tracking.html
+    # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-scaling-simple-step.html
     # @return [String]
     def policy_type
       data[:policy_type]
     end
 
-    # The adjustment type, which specifies how `ScalingAdjustment` is
-    # interpreted. The valid values are `ChangeInCapacity`, `ExactCapacity`,
-    # and `PercentChangeInCapacity`.
+    # Specifies how the scaling adjustment is interpreted (for example, an
+    # absolute number or a percentage). The valid values are
+    # `ChangeInCapacity`, `ExactCapacity`, and `PercentChangeInCapacity`.
     # @return [String]
     def adjustment_type
       data[:adjustment_type]
@@ -69,10 +83,8 @@ module Aws::AutoScaling
       data[:min_adjustment_step]
     end
 
-    # 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 the adjustment type is
+    # `PercentChangeInCapacity`.
     # @return [Integer]
     def min_adjustment_magnitude
       data[:min_adjustment_magnitude]
@@ -86,8 +98,7 @@ module Aws::AutoScaling
       data[:scaling_adjustment]
     end
 
-    # The amount of time, in seconds, after a scaling activity completes
-    # before any further dynamic scaling activities can start.
+    # The duration of the policy's cooldown period, in seconds.
     # @return [Integer]
     def cooldown
       data[:cooldown]
@@ -297,11 +308,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*.
     #
     #
     #
@@ -316,13 +325,13 @@ 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 options [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 [EmptyStructure]
     def execute(options = {})
       options = options.merge(policy_name: @name)

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

@@ -288,8 +288,7 @@ module Aws::AutoScaling
     #   @return [Integer]
     #
     # @!attribute [rw] default_cooldown
-    #   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]
     #
     # @!attribute [rw] availability_zones
@@ -951,9 +950,9 @@ 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 capacity of the group).
+    #   never go 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>
     #   @return [Integer]
@@ -975,8 +974,10 @@ module Aws::AutoScaling
     #   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*.
     #
     #
     #
@@ -1042,8 +1043,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.
     #
     #
     #
@@ -1223,6 +1223,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
+    #         },
     #       }
     #
     # @!attribute [rw] launch_configuration_name
@@ -1478,6 +1483,16 @@ module Aws::AutoScaling
     #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-vpc-tenancy
     #   @return [String]
     #
+    # @!attribute [rw] 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 [Types::InstanceMetadataOptions]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CreateLaunchConfigurationType AWS API Documentation
     #
     class CreateLaunchConfigurationType < Struct.new(
@@ -1498,7 +1513,8 @@ module Aws::AutoScaling
       :iam_instance_profile,
       :ebs_optimized,
       :associate_public_ip_address,
-      :placement_tenancy)
+      :placement_tenancy,
+      :metadata_options)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1856,13 +1872,6 @@ module Aws::AutoScaling
 
     # @!attribute [rw] instance_refreshes
     #   The instance refreshes for the specified group.
-    #
-    #   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
     #   @return [Array<Types::InstanceRefresh>]
     #
     # @!attribute [rw] next_token
@@ -2529,9 +2538,7 @@ module Aws::AutoScaling
     # @!attribute [rw] snapshot_id
     #   The snapshot ID of the volume to use.
     #
-    #   Conditional: This parameter is optional if you specify a volume
-    #   size. If you specify both `SnapshotId` and `VolumeSize`,
-    #   `VolumeSize` must be equal or greater than the size of the snapshot.
+    #   You must specify either a `VolumeSize` or a `SnapshotId`.
     #   @return [String]
     #
     # @!attribute [rw] volume_size
@@ -2545,9 +2552,9 @@ module Aws::AutoScaling
     #   Default: If you create a volume from a snapshot and you don't
     #   specify a volume size, the default is the snapshot size.
     #
-    #   <note markdown="1"> At least one of VolumeSize or SnapshotId is required.
-    #
-    #    </note>
+    #   You must specify either a `VolumeSize` or a `SnapshotId`. If you
+    #   specify both `SnapshotId` and `VolumeSize`, the volume size must be
+    #   equal or greater than the size of the snapshot.
     #   @return [Integer]
     #
     # @!attribute [rw] volume_type
@@ -2575,8 +2582,8 @@ module Aws::AutoScaling
     #   For more information, see [Amazon EBS Volume Types][1] in the
     #   *Amazon EC2 User Guide for Linux Instances*.
     #
-    #   Conditional: This parameter is required when the volume type is
-    #   `io1`. (Not used with `standard`, `gp2`, `st1`, or `sc1` volumes.)
+    #   Required when the volume type is `io1`. (Not used with `standard`,
+    #   `gp2`, `st1`, or `sc1` volumes.)
     #
     #
     #
@@ -2809,11 +2816,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*.
     #
     #
     #
@@ -2830,15 +2835,15 @@ 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.
     #   @return [Float]
     #
     # @!attribute [rw] 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 [Float]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ExecutePolicyType AWS API Documentation
@@ -3013,6 +3018,72 @@ module Aws::AutoScaling
       include Aws::Structure
     end
 
+    # 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
+    #
+    # @note When making an API call, you may pass InstanceMetadataOptions
+    #   data as a hash:
+    #
+    #       {
+    #         http_tokens: "optional", # accepts optional, required
+    #         http_put_response_hop_limit: 1,
+    #         http_endpoint: "disabled", # accepts disabled, enabled
+    #       }
+    #
+    # @!attribute [rw] http_tokens
+    #   The state of token usage for your instance metadata requests. If the
+    #   parameter is not specified in the request, the default state is
+    #   `optional`.
+    #
+    #   If the state is `optional`, you can choose to retrieve instance
+    #   metadata with or without a signed token header on your request. If
+    #   you retrieve the IAM role credentials without a token, the version
+    #   1.0 role credentials are returned. If you retrieve the IAM role
+    #   credentials using a valid signed token, the version 2.0 role
+    #   credentials are returned.
+    #
+    #   If the state is `required`, you must send a signed token header with
+    #   any instance metadata retrieval requests. In this state, retrieving
+    #   the IAM role credentials always returns the version 2.0 credentials;
+    #   the version 1.0 credentials are not available.
+    #   @return [String]
+    #
+    # @!attribute [rw] http_put_response_hop_limit
+    #   The desired HTTP PUT response hop limit for instance metadata
+    #   requests. The larger the number, the further instance metadata
+    #   requests can travel.
+    #
+    #   Default: 1
+    #
+    #   Possible values: Integers from 1 to 64
+    #   @return [Integer]
+    #
+    # @!attribute [rw] http_endpoint
+    #   This parameter enables or disables the HTTP metadata endpoint on
+    #   your instances. If the parameter is not specified, the default state
+    #   is `enabled`.
+    #
+    #   <note markdown="1"> If you specify a value of `disabled`, you will not be able to access
+    #   your instance metadata.
+    #
+    #    </note>
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/InstanceMetadataOptions AWS API Documentation
+    #
+    class InstanceMetadataOptions < Struct.new(
+      :http_tokens,
+      :http_put_response_hop_limit,
+      :http_endpoint)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Describes whether detailed monitoring is enabled for the Auto Scaling
     # instances.
     #
@@ -3464,6 +3535,16 @@ module Aws::AutoScaling
     #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-vpc-tenancy
     #   @return [String]
     #
+    # @!attribute [rw] 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 [Types::InstanceMetadataOptions]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/LaunchConfiguration AWS API Documentation
     #
     class LaunchConfiguration < Struct.new(
@@ -3485,7 +3566,8 @@ module Aws::AutoScaling
       :created_time,
       :ebs_optimized,
       :associate_public_ip_address,
-      :placement_tenancy)
+      :placement_tenancy,
+      :metadata_options)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -4062,6 +4144,16 @@ module Aws::AutoScaling
     #   * `GroupTerminatingInstances`
     #
     #   * `GroupTotalInstances`
+    #
+    #   * `GroupInServiceCapacity`
+    #
+    #   * `GroupPendingCapacity`
+    #
+    #   * `GroupStandbyCapacity`
+    #
+    #   * `GroupTerminatingCapacity`
+    #
+    #   * `GroupTotalCapacity`
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/MetricCollectionType AWS API Documentation
@@ -4123,7 +4215,7 @@ module Aws::AutoScaling
     # You can create a mixed instances policy for a new Auto Scaling group,
     # or you can create it for an existing group by updating the group to
     # specify `MixedInstancesPolicy` as the top-level parameter instead of a
-    # launch configuration or template. For more information, see
+    # launch configuration or launch template. For more information, see
     # CreateAutoScalingGroup and UpdateAutoScalingGroup.
     #
     #
@@ -4160,8 +4252,7 @@ module Aws::AutoScaling
     # @!attribute [rw] launch_template
     #   The launch template and instance types (overrides).
     #
-    #   This parameter must be specified when creating a mixed instances
-    #   policy.
+    #   Required when creating a mixed instances policy.
     #   @return [Types::LaunchTemplate]
     #
     # @!attribute [rw] instances_distribution
@@ -4405,8 +4496,8 @@ 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.
     #   @return [String]
     #
     # @!attribute [rw] role_arn
@@ -4414,8 +4505,8 @@ module Aws::AutoScaling
     #   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.
     #   @return [String]
     #
     # @!attribute [rw] notification_target_arn
@@ -4561,19 +4652,23 @@ module Aws::AutoScaling
     #   @return [String]
     #
     # @!attribute [rw] 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)
     #   @return [String]
     #
     # @!attribute [rw] 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 more information, see [Scaling Adjustment Types][1] in the
-    #   *Amazon EC2 Auto Scaling User Guide*.
+    #   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*.
     #
     #
     #
@@ -4586,18 +4681,23 @@ module Aws::AutoScaling
     #   @return [Integer]
     #
     # @!attribute [rw] 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>
     #
     #
     #
@@ -4605,26 +4705,23 @@ module Aws::AutoScaling
     #   @return [Integer]
     #
     # @!attribute [rw] 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.)
     #   @return [Integer]
     #
     # @!attribute [rw] 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*.
     #
     #
     #
@@ -4643,29 +4740,42 @@ 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.)
     #   @return [Array<Types::StepAdjustment>]
     #
     # @!attribute [rw] 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`.
     #   @return [Integer]
     #
     # @!attribute [rw] 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`.
     #
     #
     #
@@ -4861,10 +4971,7 @@ module Aws::AutoScaling
     #   The number of seconds until a newly launched instance is configured
     #   and ready to use. During this time, Amazon EC2 Auto Scaling does not
     #   immediately move on to the next replacement. The default is to use
-    #   the value specified for the health check grace period for the group.
-    #
-    #   Note: While warming up, a newly launched instance is not counted
-    #   toward the aggregated metrics of the Auto Scaling group.
+    #   the value for the health check grace period defined for the group.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/RefreshPreferences AWS API Documentation
@@ -4933,14 +5040,28 @@ module Aws::AutoScaling
     #   @return [String]
     #
     # @!attribute [rw] policy_type
-    #   The policy type. The valid values are `SimpleScaling`,
-    #   `StepScaling`, and `TargetTrackingScaling`.
+    #   One of the following policy types:
+    #
+    #   * `TargetTrackingScaling`
+    #
+    #   * `StepScaling`
+    #
+    #   * `SimpleScaling` (default)
+    #
+    #   For more information, 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-scaling-target-tracking.html
+    #   [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-scaling-simple-step.html
     #   @return [String]
     #
     # @!attribute [rw] adjustment_type
-    #   The adjustment type, which specifies how `ScalingAdjustment` is
-    #   interpreted. The valid values are `ChangeInCapacity`,
-    #   `ExactCapacity`, and `PercentChangeInCapacity`.
+    #   Specifies how the scaling adjustment is interpreted (for example, an
+    #   absolute number or a percentage). The valid values are
+    #   `ChangeInCapacity`, `ExactCapacity`, and `PercentChangeInCapacity`.
     #   @return [String]
     #
     # @!attribute [rw] min_adjustment_step
@@ -4949,10 +5070,8 @@ module Aws::AutoScaling
     #   @return [Integer]
     #
     # @!attribute [rw] 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 the adjustment type is
+    #   `PercentChangeInCapacity`.
     #   @return [Integer]
     #
     # @!attribute [rw] scaling_adjustment
@@ -4962,8 +5081,7 @@ module Aws::AutoScaling
     #   @return [Integer]
     #
     # @!attribute [rw] cooldown
-    #   The amount of time, in seconds, after a scaling activity completes
-    #   before any further dynamic scaling activities can start.
+    #   The duration of the policy's cooldown period, in seconds.
     #   @return [Integer]
     #
     # @!attribute [rw] step_adjustments
@@ -5399,13 +5517,25 @@ 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
+    #   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.
     #   @return [String]
     #
     # @!attribute [rw] 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::RefreshPreferences]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/StartInstanceRefreshType AWS API Documentation
@@ -5815,9 +5945,9 @@ 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 capacity of the group).
+    #   never go 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>
     #   @return [Integer]
@@ -5834,13 +5964,12 @@ module Aws::AutoScaling
     # @!attribute [rw] 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.
+    #   `300`.
     #
-    #   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*.
     #
     #
     #
@@ -5866,8 +5995,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.
     #
     #
     #