This is the new Amazon CloudFormation Template Reference Guide. Please update your bookmarks and links. For help getting started with CloudFormation, see the Amazon CloudFormation User Guide.
AWS::ApplicationAutoScaling::ScalingPolicy PredictiveScalingPolicyConfiguration
Represents a predictive scaling policy configuration. Predictive scaling is supported on Amazon ECS services.
Syntax
To declare this entity in your Amazon CloudFormation template, use the following syntax:
JSON
{ "MaxCapacityBreachBehavior" :String, "MaxCapacityBuffer" :Integer, "MetricSpecifications" :[ PredictiveScalingMetricSpecification, ... ], "Mode" :String, "SchedulingBufferTime" :Integer}
YAML
MaxCapacityBreachBehavior:StringMaxCapacityBuffer:IntegerMetricSpecifications:- PredictiveScalingMetricSpecificationMode:StringSchedulingBufferTime:Integer
Properties
MaxCapacityBreachBehavior-
Defines the behavior that should be applied if the forecast capacity approaches or exceeds the maximum capacity. Defaults to
HonorMaxCapacityif not specified.Required: No
Type: String
Allowed values:
HonorMaxCapacity | IncreaseMaxCapacityUpdate 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
MaxCapacityBreachBehaviorproperty is set toIncreaseMaxCapacity, and cannot be used otherwise.Required: No
Type: Integer
Minimum:
0Maximum:
100Update 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
ForecastOnlyif not specified.Required: No
Type: String
Allowed values:
ForecastOnly | ForecastAndScaleUpdate 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:
0Maximum:
3600Update requires: No interruption