         | Did this page help you? Yes No Tell us about it... |
AWS::AutoScaling::ScalingPolicy
The AWS::AutoScaling::ScalingPolicy resource adds a scaling policy to an Auto Scaling group. A scaling policy specifies whether to scale the Auto Scaling group up or down and by how much. For more information on scaling policies, see Scaling by Policy in the Auto Scaling Developer Guide.
You can use a scaling policy together with an Amazon CloudWatch alarm. An Amazon CloudWatch alarm can automatically initiate actions on your behalf, based on parameters you specify. A scaling policy is one type of action that an alarm can initiate. For a snippet showing how to create an Auto Scaling policy that is triggered by an Amazon CloudWatch alarm, see Auto Scaling Policy Triggered by Amazon CloudWatch Alarm.
This type supports updates. For more information about updating this resource, see PutScalingPolicy. For more information on updating stacks, see Updating a Stack.
When you specify an AWS::AutoScaling::ScalingPolicy type as an argument to the Ref function,
AWS CloudFormation returns the policy name.
| Property | Type | Required | Notes |
|---|---|---|---|
|
AdjustmentType |
String |
Yes |
Specifies whether the |
|
AutoScalingGroupName |
String |
Yes |
The name or Amazon Resource Name (ARN) of the Auto Scaling Group that you want to attach the policy to. |
|
Cooldown |
String |
No |
The amount of time, in seconds, after a scaling activity completes before any further trigger-related scaling activities can start. |
|
ScalingAdjustment |
String |
Yes |
The number of instances by which to scale. AdjustmentType determines the interpretation of this number (e.g., as an absolute number or as a percentage of the existing Auto Scaling group size). A positive increment adds to the current capacity and a negative value removes from the current capacity. |
