AWS::ApplicationAutoScaling::ScalingPolicy TargetTrackingScalingPolicyConfiguration
TargetTrackingScalingPolicyConfiguration
is a property of the AWS::ApplicationAutoScaling::ScalingPolicy resource that specifies a target
tracking scaling policy configuration for Application Auto Scaling. Use a target tracking
scaling policy to adjust the capacity of the specified scalable target in response to actual
workloads, so that resource utilization remains at or near the target utilization value.
For more information, see Target tracking scaling policies in the Application Auto Scaling User Guide.
Syntax
To declare this entity in your AWS CloudFormation template, use the following syntax:
JSON
{ "CustomizedMetricSpecification" :
CustomizedMetricSpecification
, "DisableScaleIn" :Boolean
, "PredefinedMetricSpecification" :PredefinedMetricSpecification
, "ScaleInCooldown" :Integer
, "ScaleOutCooldown" :Integer
, "TargetValue" :Number
}
YAML
CustomizedMetricSpecification:
CustomizedMetricSpecification
DisableScaleIn:Boolean
PredefinedMetricSpecification:PredefinedMetricSpecification
ScaleInCooldown:Integer
ScaleOutCooldown:Integer
TargetValue:Number
Properties
CustomizedMetricSpecification
-
A customized metric. You can specify either a predefined metric or a customized metric.
Required: No
Type: CustomizedMetricSpecification
Update requires: No interruption
DisableScaleIn
-
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 scaling policy won't remove capacity from the scalable target. Otherwise, scale in is enabled and the target tracking scaling policy can remove capacity from the scalable target. The default value isfalse
.Required: No
Type: Boolean
Update requires: No interruption
PredefinedMetricSpecification
-
A predefined metric. You can specify either a predefined metric or a customized metric.
Required: No
Type: PredefinedMetricSpecification
Update requires: No interruption
ScaleInCooldown
-
The amount of time, in seconds, after a scale-in activity completes before another scale-in activity can start. For more information and for default values, see Define cooldown periods in the Application Auto Scaling User Guide.
Required: No
Type: Integer
Update requires: No interruption
ScaleOutCooldown
-
The amount of time, in seconds, to wait for a previous scale-out activity to take effect. For more information and for default values, see Define cooldown periods in the Application Auto Scaling User Guide.
Required: No
Type: Integer
Update requires: No interruption
TargetValue
-
The target value for the metric. Although this property accepts numbers of type Double, it won't accept values that are either too small or too large. Values must be in the range of -2^360 to 2^360. The value must be a valid number based on the choice of metric. For example, if the metric is CPU utilization, then the target value is a percent value that represents how much of the CPU can be used before scaling out.
Required: Yes
Type: Number
Update requires: No interruption
See also
-
Getting started in the Application Auto Scaling User Guide