aws-sdk-autoscalingplans 1.7.0 → 1.8.0

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

@@ -24,7 +24,7 @@ module Aws::AutoScalingPlans
     #       }
     #
     # @!attribute [rw] cloud_formation_stack_arn
-    #   The Amazon Resource Name (ARN) of a CloudFormation stack.
+    #   The Amazon Resource Name (ARN) of a AWS CloudFormation stack.
     #   @return [String]
     #
     # @!attribute [rw] tag_filters
@@ -85,6 +85,28 @@ module Aws::AutoScalingPlans
     #                 estimated_instance_warmup: 1,
     #               },
     #             ],
+    #             predefined_load_metric_specification: {
+    #               predefined_load_metric_type: "ASGTotalCPUUtilization", # required, accepts ASGTotalCPUUtilization, ASGTotalNetworkIn, ASGTotalNetworkOut, ALBTargetGroupRequestCount
+    #               resource_label: "ResourceLabel",
+    #             },
+    #             customized_load_metric_specification: {
+    #               metric_name: "MetricName", # required
+    #               namespace: "MetricNamespace", # required
+    #               dimensions: [
+    #                 {
+    #                   name: "MetricDimensionName", # required
+    #                   value: "MetricDimensionValue", # required
+    #                 },
+    #               ],
+    #               statistic: "Average", # required, accepts Average, Minimum, Maximum, SampleCount, Sum
+    #               unit: "MetricUnit",
+    #             },
+    #             scheduled_action_buffer_time: 1,
+    #             predictive_scaling_max_capacity_behavior: "SetForecastCapacityToMaxCapacity", # accepts SetForecastCapacityToMaxCapacity, SetMaxCapacityToForecastCapacity, SetMaxCapacityAboveForecastCapacity
+    #             predictive_scaling_max_capacity_buffer: 1,
+    #             predictive_scaling_mode: "ForecastAndScale", # accepts ForecastAndScale, ForecastOnly
+    #             scaling_policy_update_behavior: "KeepExternalPolicies", # accepts KeepExternalPolicies, ReplaceExternalPolicies
+    #             disable_dynamic_scaling: false,
     #           },
     #         ],
     #       }
@@ -113,7 +135,9 @@ module Aws::AutoScalingPlans
     end
 
     # @!attribute [rw] scaling_plan_version
-    #   The version of the scaling plan. This value is always 1.
+    #   The version number of the scaling plan. This value is always 1.
+    #
+    #   Currently, you cannot specify multiple scaling plan versions.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-plans-2018-01-06/CreateScalingPlanResponse AWS API Documentation
@@ -123,7 +147,92 @@ module Aws::AutoScalingPlans
       include Aws::Structure
     end
 
-    # Represents a customized metric for a target tracking policy.
+    # Represents a CloudWatch metric of your choosing that can be used for
+    # predictive scaling.
+    #
+    # For predictive scaling to work with a customized load metric
+    # specification, AWS Auto Scaling needs access to the `Sum` and
+    # `Average` statistics that CloudWatch computes from metric data.
+    # Statistics are calculations used to aggregate data over specified time
+    # periods. For more information, see the [Amazon CloudWatch User
+    # Guide][1].
+    #
+    # When you choose a load metric, make sure that the required `Sum` and
+    # `Average` statistics for your metric are available in CloudWatch and
+    # that they provide relevant data for predictive scaling. The `Sum`
+    # statistic must represent the total load on the resource, and the
+    # `Average` statistic must represent the average load per capacity unit
+    # of the resource. For example, there is a metric that counts the number
+    # of requests processed by your Auto Scaling group. If the `Sum`
+    # statistic represents the total request count processed by the group,
+    # then the `Average` statistic for the specified metric must represent
+    # the average request count processed by each instance of the group.
+    #
+    # For information about terminology, see [Amazon CloudWatch
+    # Concepts][2].
+    #
+    #
+    #
+    # [1]: http://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html
+    # [2]: http://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html
+    #
+    # @note When making an API call, you may pass CustomizedLoadMetricSpecification
+    #   data as a hash:
+    #
+    #       {
+    #         metric_name: "MetricName", # required
+    #         namespace: "MetricNamespace", # required
+    #         dimensions: [
+    #           {
+    #             name: "MetricDimensionName", # required
+    #             value: "MetricDimensionValue", # required
+    #           },
+    #         ],
+    #         statistic: "Average", # required, accepts Average, Minimum, Maximum, SampleCount, Sum
+    #         unit: "MetricUnit",
+    #       }
+    #
+    # @!attribute [rw] metric_name
+    #   The name of the metric.
+    #   @return [String]
+    #
+    # @!attribute [rw] namespace
+    #   The namespace of the metric.
+    #   @return [String]
+    #
+    # @!attribute [rw] dimensions
+    #   The dimensions of the metric.
+    #   @return [Array<Types::MetricDimension>]
+    #
+    # @!attribute [rw] statistic
+    #   The statistic of the metric. Currently, the value must always be
+    #   `Sum`.
+    #   @return [String]
+    #
+    # @!attribute [rw] unit
+    #   The unit of the metric.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-plans-2018-01-06/CustomizedLoadMetricSpecification AWS API Documentation
+    #
+    class CustomizedLoadMetricSpecification < Struct.new(
+      :metric_name,
+      :namespace,
+      :dimensions,
+      :statistic,
+      :unit)
+      include Aws::Structure
+    end
+
+    # Represents a CloudWatch metric of your choosing that can be used for
+    # dynamic scaling as part of a target tracking scaling policy.
+    #
+    # For information about terminology, see [Amazon CloudWatch
+    # Concepts][1].
+    #
+    #
+    #
+    # [1]: http://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html
     #
     # @note When making an API call, you may pass CustomizedScalingMetricSpecification
     #   data as a hash:
@@ -172,6 +281,25 @@ module Aws::AutoScalingPlans
       include Aws::Structure
     end
 
+    # Represents a single value in the forecast data used for predictive
+    # scaling.
+    #
+    # @!attribute [rw] timestamp
+    #   The time stamp for the data point in UTC format.
+    #   @return [Time]
+    #
+    # @!attribute [rw] value
+    #   The value of the data point.
+    #   @return [Float]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-plans-2018-01-06/Datapoint AWS API Documentation
+    #
+    class Datapoint < Struct.new(
+      :timestamp,
+      :value)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass DeleteScalingPlanRequest
     #   data as a hash:
     #
@@ -185,7 +313,7 @@ module Aws::AutoScalingPlans
     #   @return [String]
     #
     # @!attribute [rw] scaling_plan_version
-    #   The version of the scaling plan.
+    #   The version number of the scaling plan.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-plans-2018-01-06/DeleteScalingPlanRequest AWS API Documentation
@@ -215,11 +343,11 @@ module Aws::AutoScalingPlans
     #   @return [String]
     #
     # @!attribute [rw] scaling_plan_version
-    #   The version of the scaling plan.
+    #   The version number of the scaling plan.
     #   @return [Integer]
     #
     # @!attribute [rw] max_results
-    #   The maximum number of scalable resources to return. This value can
+    #   The maximum number of scalable resources to return. The value must
     #   be between 1 and 50. The default value is 50.
     #   @return [Integer]
     #
@@ -281,8 +409,8 @@ module Aws::AutoScalingPlans
     #   @return [Array<String>]
     #
     # @!attribute [rw] scaling_plan_version
-    #   The version of the scaling plan. If you specify a scaling plan
-    #   version, you must also specify a scaling plan name.
+    #   The version number of the scaling plan. If you specify a scaling
+    #   plan version, you must also specify a scaling plan name.
     #   @return [Integer]
     #
     # @!attribute [rw] application_sources
@@ -327,6 +455,123 @@ module Aws::AutoScalingPlans
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass GetScalingPlanResourceForecastDataRequest
+    #   data as a hash:
+    #
+    #       {
+    #         scaling_plan_name: "ScalingPlanName", # required
+    #         scaling_plan_version: 1, # required
+    #         service_namespace: "autoscaling", # required, accepts autoscaling, ecs, ec2, rds, dynamodb
+    #         resource_id: "XmlString", # required
+    #         scalable_dimension: "autoscaling:autoScalingGroup:DesiredCapacity", # required, accepts autoscaling:autoScalingGroup:DesiredCapacity, ecs:service:DesiredCount, ec2:spot-fleet-request:TargetCapacity, rds:cluster:ReadReplicaCount, dynamodb:table:ReadCapacityUnits, dynamodb:table:WriteCapacityUnits, dynamodb:index:ReadCapacityUnits, dynamodb:index:WriteCapacityUnits
+    #         forecast_data_type: "CapacityForecast", # required, accepts CapacityForecast, LoadForecast, ScheduledActionMinCapacity, ScheduledActionMaxCapacity
+    #         start_time: Time.now, # required
+    #         end_time: Time.now, # required
+    #       }
+    #
+    # @!attribute [rw] scaling_plan_name
+    #   The name of the scaling plan.
+    #   @return [String]
+    #
+    # @!attribute [rw] scaling_plan_version
+    #   The version number of the scaling plan.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] service_namespace
+    #   The namespace of the AWS service.
+    #   @return [String]
+    #
+    # @!attribute [rw] resource_id
+    #   The ID of the resource. This string consists of the resource type
+    #   and unique identifier.
+    #
+    #   * Auto Scaling group - The resource type is `autoScalingGroup` and
+    #     the unique identifier is the name of the Auto Scaling group.
+    #     Example: `autoScalingGroup/my-asg`.
+    #
+    #   * ECS service - The resource type is `service` and the unique
+    #     identifier is the cluster name and service name. Example:
+    #     `service/default/sample-webapp`.
+    #
+    #   * Spot Fleet request - The resource type is `spot-fleet-request` and
+    #     the unique identifier is the Spot Fleet request ID. Example:
+    #     `spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE`.
+    #
+    #   * DynamoDB table - The resource type is `table` and the unique
+    #     identifier is the resource ID. Example: `table/my-table`.
+    #
+    #   * DynamoDB global secondary index - The resource type is `index` and
+    #     the unique identifier is the resource ID. Example:
+    #     `table/my-table/index/my-table-index`.
+    #
+    #   * Aurora DB cluster - The resource type is `cluster` and the unique
+    #     identifier is the cluster name. Example: `cluster:my-db-cluster`.
+    #   @return [String]
+    #
+    # @!attribute [rw] scalable_dimension
+    #   The scalable dimension for the resource.
+    #   @return [String]
+    #
+    # @!attribute [rw] forecast_data_type
+    #   The type of forecast data to get.
+    #
+    #   * `LoadForecast`\: The load metric forecast.
+    #
+    #   * `CapacityForecast`\: The capacity forecast.
+    #
+    #   * `ScheduledActionMinCapacity`\: The minimum capacity for each
+    #     scheduled scaling action. This data is calculated as the larger of
+    #     two values: the capacity forecast or the minimum capacity in the
+    #     scaling instruction.
+    #
+    #   * `ScheduledActionMaxCapacity`\: The maximum capacity for each
+    #     scheduled scaling action. The calculation used is determined by
+    #     the predictive scaling maximum capacity behavior setting in the
+    #     scaling instruction.
+    #   @return [String]
+    #
+    # @!attribute [rw] start_time
+    #   The inclusive start time of the time range for the forecast data to
+    #   get. The date and time can be at most 56 days before the current
+    #   date and time.
+    #   @return [Time]
+    #
+    # @!attribute [rw] end_time
+    #   The exclusive end time of the time range for the forecast data to
+    #   get. The maximum time duration between the start and end time is
+    #   seven days.
+    #
+    #   Although this parameter can accept a date and time that is more than
+    #   two days in the future, the availability of forecast data has
+    #   limits. AWS Auto Scaling only issues forecasts for periods of two
+    #   days in advance.
+    #   @return [Time]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-plans-2018-01-06/GetScalingPlanResourceForecastDataRequest AWS API Documentation
+    #
+    class GetScalingPlanResourceForecastDataRequest < Struct.new(
+      :scaling_plan_name,
+      :scaling_plan_version,
+      :service_namespace,
+      :resource_id,
+      :scalable_dimension,
+      :forecast_data_type,
+      :start_time,
+      :end_time)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] datapoints
+    #   The data points to return.
+    #   @return [Array<Types::Datapoint>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-plans-2018-01-06/GetScalingPlanResourceForecastDataResponse AWS API Documentation
+    #
+    class GetScalingPlanResourceForecastDataResponse < Struct.new(
+      :datapoints)
+      include Aws::Structure
+    end
+
     # Represents a dimension for a customized metric.
     #
     # @note When making an API call, you may pass MetricDimension
@@ -353,7 +598,48 @@ module Aws::AutoScalingPlans
       include Aws::Structure
     end
 
-    # Represents a predefined metric for a target tracking policy.
+    # Represents a predefined metric that can be used for predictive
+    # scaling.
+    #
+    # @note When making an API call, you may pass PredefinedLoadMetricSpecification
+    #   data as a hash:
+    #
+    #       {
+    #         predefined_load_metric_type: "ASGTotalCPUUtilization", # required, accepts ASGTotalCPUUtilization, ASGTotalNetworkIn, ASGTotalNetworkOut, ALBTargetGroupRequestCount
+    #         resource_label: "ResourceLabel",
+    #       }
+    #
+    # @!attribute [rw] predefined_load_metric_type
+    #   The metric type.
+    #   @return [String]
+    #
+    # @!attribute [rw] resource_label
+    #   Identifies the resource associated with the metric type. You can't
+    #   specify a resource label unless the metric type is
+    #   `ALBRequestCountPerTarget` and there is a target group for an
+    #   Application Load Balancer attached to the Auto Scaling group.
+    #
+    #   The format is
+    #   app/&lt;load-balancer-name&gt;/&lt;load-balancer-id&gt;/targetgroup/&lt;target-group-name&gt;/&lt;target-group-id&gt;,
+    #   where:
+    #
+    #   * app/&lt;load-balancer-name&gt;/&lt;load-balancer-id&gt; is the
+    #     final portion of the load balancer ARN.
+    #
+    #   * targetgroup/&lt;target-group-name&gt;/&lt;target-group-id&gt; is
+    #     the final portion of the target group ARN.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-plans-2018-01-06/PredefinedLoadMetricSpecification AWS API Documentation
+    #
+    class PredefinedLoadMetricSpecification < Struct.new(
+      :predefined_load_metric_type,
+      :resource_label)
+      include Aws::Structure
+    end
+
+    # Represents a predefined metric that can be used for dynamic scaling as
+    # part of a target tracking scaling policy.
     #
     # @note When making an API call, you may pass PredefinedScalingMetricSpecification
     #   data as a hash:
@@ -365,7 +651,7 @@ module Aws::AutoScalingPlans
     #
     # @!attribute [rw] predefined_scaling_metric_type
     #   The metric type. The `ALBRequestCountPerTarget` metric type applies
-    #   only to Auto Scaling groups, Sport Fleet requests, and ECS services.
+    #   only to Auto Scaling groups, Spot Fleet requests, and ECS services.
     #   @return [String]
     #
     # @!attribute [rw] resource_label
@@ -380,7 +666,7 @@ module Aws::AutoScalingPlans
     #   where:
     #
     #   * app/&lt;load-balancer-name&gt;/&lt;load-balancer-id&gt; is the
-    #     final portion of the load balancer ARN
+    #     final portion of the load balancer ARN.
     #
     #   * targetgroup/&lt;target-group-name&gt;/&lt;target-group-id&gt; is
     #     the final portion of the target group ARN.
@@ -394,7 +680,33 @@ module Aws::AutoScalingPlans
       include Aws::Structure
     end
 
-    # Specifies the scaling configuration for a scalable resource.
+    # Describes a scaling instruction for a scalable resource.
+    #
+    # The scaling instruction is used in combination with a scaling plan,
+    # which is a set of instructions for configuring dynamic scaling and
+    # predictive scaling for the scalable resources in your application.
+    # Each scaling instruction applies to one resource.
+    #
+    # AWS Auto Scaling creates target tracking scaling policies based on the
+    # scaling instructions. Target tracking scaling policies adjust the
+    # capacity of your scalable resource as required to maintain resource
+    # utilization at the target value that you specified.
+    #
+    # AWS Auto Scaling also configures predictive scaling for your Amazon
+    # EC2 Auto Scaling groups using a subset of parameters, including the
+    # load metric, the scaling metric, the target value for the scaling
+    # metric, the predictive scaling mode (forecast and scale or forecast
+    # only), and the desired behavior when the forecast capacity exceeds the
+    # maximum capacity of the resource. With predictive scaling, AWS Auto
+    # Scaling generates forecasts with traffic predictions for the two days
+    # ahead and schedules scaling actions that proactively add and remove
+    # resource capacity to match the forecast.
+    #
+    # For more information, see the [AWS Auto Scaling User Guide][1].
+    #
+    #
+    #
+    # [1]: http://docs.aws.amazon.com/autoscaling/plans/userguide/what-is-aws-auto-scaling.html
     #
     # @note When making an API call, you may pass ScalingInstruction
     #   data as a hash:
@@ -430,6 +742,28 @@ module Aws::AutoScalingPlans
     #             estimated_instance_warmup: 1,
     #           },
     #         ],
+    #         predefined_load_metric_specification: {
+    #           predefined_load_metric_type: "ASGTotalCPUUtilization", # required, accepts ASGTotalCPUUtilization, ASGTotalNetworkIn, ASGTotalNetworkOut, ALBTargetGroupRequestCount
+    #           resource_label: "ResourceLabel",
+    #         },
+    #         customized_load_metric_specification: {
+    #           metric_name: "MetricName", # required
+    #           namespace: "MetricNamespace", # required
+    #           dimensions: [
+    #             {
+    #               name: "MetricDimensionName", # required
+    #               value: "MetricDimensionValue", # required
+    #             },
+    #           ],
+    #           statistic: "Average", # required, accepts Average, Minimum, Maximum, SampleCount, Sum
+    #           unit: "MetricUnit",
+    #         },
+    #         scheduled_action_buffer_time: 1,
+    #         predictive_scaling_max_capacity_behavior: "SetForecastCapacityToMaxCapacity", # accepts SetForecastCapacityToMaxCapacity, SetMaxCapacityToForecastCapacity, SetMaxCapacityAboveForecastCapacity
+    #         predictive_scaling_max_capacity_buffer: 1,
+    #         predictive_scaling_mode: "ForecastAndScale", # accepts ForecastAndScale, ForecastOnly
+    #         scaling_policy_update_behavior: "KeepExternalPolicies", # accepts KeepExternalPolicies, ReplaceExternalPolicies
+    #         disable_dynamic_scaling: false,
     #       }
     #
     # @!attribute [rw] service_namespace
@@ -448,8 +782,8 @@ module Aws::AutoScalingPlans
     #     identifier is the cluster name and service name. Example:
     #     `service/default/sample-webapp`.
     #
-    #   * Spot fleet request - The resource type is `spot-fleet-request` and
-    #     the unique identifier is the Spot fleet request ID. Example:
+    #   * Spot Fleet request - The resource type is `spot-fleet-request` and
+    #     the unique identifier is the Spot Fleet request ID. Example:
     #     `spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE`.
     #
     #   * DynamoDB table - The resource type is `table` and the unique
@@ -473,7 +807,7 @@ module Aws::AutoScalingPlans
     #     service.
     #
     #   * `ec2:spot-fleet-request:TargetCapacity` - The target capacity of a
-    #     Spot fleet request.
+    #     Spot Fleet request.
     #
     #   * `dynamodb:table:ReadCapacityUnits` - The provisioned read capacity
     #     for a DynamoDB table.
@@ -493,17 +827,129 @@ module Aws::AutoScalingPlans
     #   @return [String]
     #
     # @!attribute [rw] min_capacity
-    #   The minimum value to scale to in response to a scale in event.
+    #   The minimum capacity of the resource.
     #   @return [Integer]
     #
     # @!attribute [rw] max_capacity
-    #   The maximum value to scale to in response to a scale out event.
+    #   The maximum capacity of the resource. The exception to this upper
+    #   limit is if you specify a non-default setting for
+    #   **PredictiveScalingMaxCapacityBehavior**.
     #   @return [Integer]
     #
     # @!attribute [rw] target_tracking_configurations
-    #   The target tracking scaling policies (up to 10).
+    #   The structure that defines new target tracking configurations (up to
+    #   10). Each of these structures includes a specific scaling metric and
+    #   a target value for the metric, along with various parameters to use
+    #   with dynamic scaling.
+    #
+    #   With predictive scaling and dynamic scaling, the resource scales
+    #   based on the target tracking configuration that provides the largest
+    #   capacity for both scale in and scale out.
+    #
+    #   Condition: The scaling metric must be unique across target tracking
+    #   configurations.
     #   @return [Array<Types::TargetTrackingConfiguration>]
     #
+    # @!attribute [rw] predefined_load_metric_specification
+    #   The predefined load metric to use for predictive scaling. This
+    #   parameter or a **CustomizedLoadMetricSpecification** is required
+    #   when configuring predictive scaling, and cannot be used otherwise.
+    #   @return [Types::PredefinedLoadMetricSpecification]
+    #
+    # @!attribute [rw] customized_load_metric_specification
+    #   The customized load metric to use for predictive scaling. This
+    #   parameter or a **PredefinedLoadMetricSpecification** is required
+    #   when configuring predictive scaling, and cannot be used otherwise.
+    #   @return [Types::CustomizedLoadMetricSpecification]
+    #
+    # @!attribute [rw] scheduled_action_buffer_time
+    #   The amount of time, in seconds, to buffer the run time of scheduled
+    #   scaling actions when scaling out. For example, if the forecast says
+    #   to add capacity at 10:00 AM, and the buffer time is 5 minutes, then
+    #   the run time of the corresponding scheduled scaling action will be
+    #   9:55 AM. The intention is to give resources time to be provisioned.
+    #   For example, it can take a few minutes to launch an EC2 instance.
+    #   The actual amount of time required depends on several factors, such
+    #   as the size of the instance and whether there are startup scripts to
+    #   complete.
+    #
+    #   The value must be less than the forecast interval duration of 3600
+    #   seconds (60 minutes). The default is 300 seconds.
+    #
+    #   Only valid when configuring predictive scaling.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] predictive_scaling_max_capacity_behavior
+    #   Defines the behavior that should be applied if the forecast capacity
+    #   approaches or exceeds the maximum capacity specified for the
+    #   resource. The default value is `SetForecastCapacityToMaxCapacity`.
+    #
+    #   The following are possible values:
+    #
+    #   * `SetForecastCapacityToMaxCapacity` - AWS Auto Scaling cannot scale
+    #     resource capacity higher than the maximum capacity. The maximum
+    #     capacity is enforced as a hard limit.
+    #
+    #   * `SetMaxCapacityToForecastCapacity` - AWS Auto Scaling may scale
+    #     resource capacity higher than the maximum capacity to equal but
+    #     not exceed forecast capacity.
+    #
+    #   * `SetMaxCapacityAboveForecastCapacity` - AWS Auto Scaling may scale
+    #     resource capacity higher than the maximum capacity by a specified
+    #     buffer value. The intention is to give the target tracking scaling
+    #     policy extra capacity if unexpected traffic occurs.
+    #
+    #   Only valid when configuring predictive scaling.
+    #   @return [String]
+    #
+    # @!attribute [rw] predictive_scaling_max_capacity_buffer
+    #   The size of the capacity buffer to use when the forecast capacity is
+    #   close to or exceeds the maximum capacity. The value is specified as
+    #   a percentage relative to the forecast capacity. For example, if the
+    #   buffer is 10, this means a 10 percent buffer, such that if the
+    #   forecast capacity is 50, and the maximum capacity is 40, then the
+    #   effective maximum capacity is 55.
+    #
+    #   Only valid when configuring predictive scaling. Required if the
+    #   **PredictiveScalingMaxCapacityBehavior** is set to
+    #   `SetMaxCapacityAboveForecastCapacity`, and cannot be used otherwise.
+    #
+    #   The range is 1-100.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] predictive_scaling_mode
+    #   The predictive scaling mode. The default value is
+    #   `ForecastAndScale`. Otherwise, AWS Auto Scaling forecasts capacity
+    #   but does not create any scheduled scaling actions based on the
+    #   capacity forecast.
+    #   @return [String]
+    #
+    # @!attribute [rw] scaling_policy_update_behavior
+    #   Controls whether a resource's externally created scaling policies
+    #   are kept or replaced.
+    #
+    #   The default value is `KeepExternalPolicies`. If the parameter is set
+    #   to `ReplaceExternalPolicies`, any scaling policies that are external
+    #   to AWS Auto Scaling are deleted and new target tracking scaling
+    #   policies created.
+    #
+    #   Only valid when configuring dynamic scaling.
+    #
+    #   Condition: The number of existing policies to be replaced must be
+    #   less than or equal to 50. If there are more than 50 policies to be
+    #   replaced, AWS Auto Scaling keeps all existing policies and does not
+    #   create new ones.
+    #   @return [String]
+    #
+    # @!attribute [rw] disable_dynamic_scaling
+    #   Controls whether dynamic scaling by AWS Auto Scaling is disabled.
+    #   When dynamic scaling is enabled, AWS Auto Scaling creates target
+    #   tracking scaling policies based on the specified target tracking
+    #   configurations.
+    #
+    #   The default is enabled (`false`).
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-plans-2018-01-06/ScalingInstruction AWS API Documentation
     #
     class ScalingInstruction < Struct.new(
@@ -512,7 +958,15 @@ module Aws::AutoScalingPlans
       :scalable_dimension,
       :min_capacity,
       :max_capacity,
-      :target_tracking_configurations)
+      :target_tracking_configurations,
+      :predefined_load_metric_specification,
+      :customized_load_metric_specification,
+      :scheduled_action_buffer_time,
+      :predictive_scaling_max_capacity_behavior,
+      :predictive_scaling_max_capacity_buffer,
+      :predictive_scaling_mode,
+      :scaling_policy_update_behavior,
+      :disable_dynamic_scaling)
       include Aws::Structure
     end
 
@@ -523,7 +977,7 @@ module Aws::AutoScalingPlans
     #   @return [String]
     #
     # @!attribute [rw] scaling_plan_version
-    #   The version of the scaling plan.
+    #   The version number of the scaling plan.
     #   @return [Integer]
     #
     # @!attribute [rw] application_source
@@ -549,6 +1003,10 @@ module Aws::AutoScalingPlans
     #   * `DeletionInProgress` - The scaling plan is being deleted.
     #
     #   * `DeletionFailed` - The scaling plan could not be deleted.
+    #
+    #   * `UpdateInProgress` - The scaling plan is being updated.
+    #
+    #   * `UpdateFailed` - The scaling plan could not be updated.
     #   @return [String]
     #
     # @!attribute [rw] status_message
@@ -556,11 +1014,12 @@ module Aws::AutoScalingPlans
     #   @return [String]
     #
     # @!attribute [rw] status_start_time
-    #   The Unix timestamp when the scaling plan entered the current status.
+    #   The Unix time stamp when the scaling plan entered the current
+    #   status.
     #   @return [Time]
     #
     # @!attribute [rw] creation_time
-    #   The Unix timestamp when the scaling plan was created.
+    #   The Unix time stamp when the scaling plan was created.
     #   @return [Time]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-plans-2018-01-06/ScalingPlan AWS API Documentation
@@ -584,7 +1043,7 @@ module Aws::AutoScalingPlans
     #   @return [String]
     #
     # @!attribute [rw] scaling_plan_version
-    #   The version of the scaling plan.
+    #   The version number of the scaling plan.
     #   @return [Integer]
     #
     # @!attribute [rw] service_namespace
@@ -603,8 +1062,8 @@ module Aws::AutoScalingPlans
     #     identifier is the cluster name and service name. Example:
     #     `service/default/sample-webapp`.
     #
-    #   * Spot fleet request - The resource type is `spot-fleet-request` and
-    #     the unique identifier is the Spot fleet request ID. Example:
+    #   * Spot Fleet request - The resource type is `spot-fleet-request` and
+    #     the unique identifier is the Spot Fleet request ID. Example:
     #     `spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE`.
     #
     #   * DynamoDB table - The resource type is `table` and the unique
@@ -628,7 +1087,7 @@ module Aws::AutoScalingPlans
     #     service.
     #
     #   * `ec2:spot-fleet-request:TargetCapacity` - The target capacity of a
-    #     Spot fleet request.
+    #     Spot Fleet request.
     #
     #   * `dynamodb:table:ReadCapacityUnits` - The provisioned read capacity
     #     for a DynamoDB table.
@@ -733,7 +1192,8 @@ module Aws::AutoScalingPlans
       include Aws::Structure
     end
 
-    # Represents a target tracking scaling policy.
+    # Describes a target tracking configuration. Used with
+    # ScalingInstruction and ScalingPolicy.
     #
     # @note When making an API call, you may pass TargetTrackingConfiguration
     #   data as a hash:
@@ -776,21 +1236,23 @@ module Aws::AutoScalingPlans
     #   @return [Float]
     #
     # @!attribute [rw] disable_scale_in
-    #   Indicates whether scale in by the target tracking policy is
+    #   Indicates whether scale in by the target tracking scaling policy is
     #   disabled. If the value is `true`, scale in is disabled and the
-    #   target tracking policy won't remove capacity from the scalable
-    #   resource. Otherwise, scale in is enabled and the target tracking
-    #   policy can remove capacity from the scalable resource. The default
-    #   value is `false`.
+    #   target tracking scaling policy doesn't remove capacity from the
+    #   scalable resource. Otherwise, scale in is enabled and the target
+    #   tracking scaling policy can remove capacity from the scalable
+    #   resource.
+    #
+    #   The default value is `false`.
     #   @return [Boolean]
     #
     # @!attribute [rw] scale_out_cooldown
-    #   The amount of time, in seconds, after a scale out activity completes
-    #   before another scale out activity can start. This value is not used
+    #   The amount of time, in seconds, after a scale-out activity completes
+    #   before another scale-out activity can start. This value is not used
     #   if the scalable resource is an Auto Scaling group.
     #
     #   While the cooldown period is in effect, the capacity that has been
-    #   added by the previous scale out event that initiated the cooldown is
+    #   added by the previous scale-out event that initiated the cooldown is
     #   calculated as part of the desired capacity for the next scale out.
     #   The intention is to continuously (but not excessively) scale out.
     #   @return [Integer]
@@ -803,7 +1265,7 @@ module Aws::AutoScalingPlans
     #   The cooldown period is used to block subsequent scale in requests
     #   until it has expired. The intention is to scale in conservatively to
     #   protect your application's availability. However, if another alarm
-    #   triggers a scale out policy during the cooldown period after a
+    #   triggers a scale-out policy during the cooldown period after a
     #   scale-in, AWS Auto Scaling scales out your scalable target
     #   immediately.
     #   @return [Integer]
@@ -831,6 +1293,8 @@ module Aws::AutoScalingPlans
     #   data as a hash:
     #
     #       {
+    #         scaling_plan_name: "ScalingPlanName", # required
+    #         scaling_plan_version: 1, # required
     #         application_source: {
     #           cloud_formation_stack_arn: "XmlString",
     #           tag_filters: [
@@ -840,7 +1304,6 @@ module Aws::AutoScalingPlans
     #             },
     #           ],
     #         },
-    #         scaling_plan_name: "ScalingPlanName", # required
     #         scaling_instructions: [
     #           {
     #             service_namespace: "autoscaling", # required, accepts autoscaling, ecs, ec2, rds, dynamodb
@@ -873,34 +1336,55 @@ module Aws::AutoScalingPlans
     #                 estimated_instance_warmup: 1,
     #               },
     #             ],
+    #             predefined_load_metric_specification: {
+    #               predefined_load_metric_type: "ASGTotalCPUUtilization", # required, accepts ASGTotalCPUUtilization, ASGTotalNetworkIn, ASGTotalNetworkOut, ALBTargetGroupRequestCount
+    #               resource_label: "ResourceLabel",
+    #             },
+    #             customized_load_metric_specification: {
+    #               metric_name: "MetricName", # required
+    #               namespace: "MetricNamespace", # required
+    #               dimensions: [
+    #                 {
+    #                   name: "MetricDimensionName", # required
+    #                   value: "MetricDimensionValue", # required
+    #                 },
+    #               ],
+    #               statistic: "Average", # required, accepts Average, Minimum, Maximum, SampleCount, Sum
+    #               unit: "MetricUnit",
+    #             },
+    #             scheduled_action_buffer_time: 1,
+    #             predictive_scaling_max_capacity_behavior: "SetForecastCapacityToMaxCapacity", # accepts SetForecastCapacityToMaxCapacity, SetMaxCapacityToForecastCapacity, SetMaxCapacityAboveForecastCapacity
+    #             predictive_scaling_max_capacity_buffer: 1,
+    #             predictive_scaling_mode: "ForecastAndScale", # accepts ForecastAndScale, ForecastOnly
+    #             scaling_policy_update_behavior: "KeepExternalPolicies", # accepts KeepExternalPolicies, ReplaceExternalPolicies
+    #             disable_dynamic_scaling: false,
     #           },
     #         ],
-    #         scaling_plan_version: 1, # required
     #       }
     #
-    # @!attribute [rw] application_source
-    #   A CloudFormation stack or set of tags.
-    #   @return [Types::ApplicationSource]
-    #
     # @!attribute [rw] scaling_plan_name
     #   The name of the scaling plan.
     #   @return [String]
     #
+    # @!attribute [rw] scaling_plan_version
+    #   The version number of the scaling plan.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] application_source
+    #   A CloudFormation stack or set of tags.
+    #   @return [Types::ApplicationSource]
+    #
     # @!attribute [rw] scaling_instructions
     #   The scaling instructions.
     #   @return [Array<Types::ScalingInstruction>]
     #
-    # @!attribute [rw] scaling_plan_version
-    #   The version number.
-    #   @return [Integer]
-    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-plans-2018-01-06/UpdateScalingPlanRequest AWS API Documentation
     #
     class UpdateScalingPlanRequest < Struct.new(
-      :application_source,
       :scaling_plan_name,
-      :scaling_instructions,
-      :scaling_plan_version)
+      :scaling_plan_version,
+      :application_source,
+      :scaling_instructions)
       include Aws::Structure
     end