AWS::ApplicationAutoScaling::ScalingPolicy PredictiveScalingPolicyConfiguration
Represents a predictive scaling policy configuration.
Syntax
To declare this entity in your AWS CloudFormation template, use the following syntax:
JSON
{ "MaxCapacityBreachBehavior" :
String
, "MaxCapacityBuffer" :Integer
, "MetricSpecifications" :[ PredictiveScalingMetricSpecification, ... ]
, "Mode" :String
, "SchedulingBufferTime" :Integer
}
YAML
MaxCapacityBreachBehavior:
String
MaxCapacityBuffer:Integer
MetricSpecifications:- PredictiveScalingMetricSpecification
Mode:String
SchedulingBufferTime:Integer
Properties
MaxCapacityBreachBehavior
-
Defines the behavior that should be applied if the forecast capacity approaches or exceeds the maximum capacity. Defaults to
HonorMaxCapacity
if not specified.Required: No
Type: String
Allowed values:
HonorMaxCapacity | IncreaseMaxCapacity
Update requires: No interruption
MaxCapacityBuffer
-
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.
Required if the
MaxCapacityBreachBehavior
property is set toIncreaseMaxCapacity
, and cannot be used otherwise.Required: No
Type: Integer
Minimum:
0
Maximum:
100
Update requires: No interruption
MetricSpecifications
-
This structure includes the metrics and target utilization to use for predictive scaling.
This is an array, but we currently only support a single metric specification. That is, you can specify a target value and a single metric pair, or a target value and one scaling metric and one load metric.
Required: Yes
Type: Array of PredictiveScalingMetricSpecification
Update requires: No interruption
Mode
-
The predictive scaling mode. Defaults to
ForecastOnly
if not specified.Required: No
Type: String
Allowed values:
ForecastOnly | ForecastAndScale
Update requires: No interruption
SchedulingBufferTime
-
The amount of time, in seconds, that the start time can be advanced.
The value must be less than the forecast interval duration of 3600 seconds (60 minutes). Defaults to 300 seconds if not specified.
Required: No
Type: Integer
Minimum:
0
Maximum:
3600
Update requires: No interruption