Auto Scaling
API Reference (API Version 2011-01-01)
Did this page help you?  Yes | No |  Tell us about it...
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.



Creates or updates a policy for an Auto Scaling group. To update an existing policy, use the existing policy name and set the parameters you want to change. Any existing parameter not changed in an update to an existing policy is not changed in this update request.

Request Parameters

For information about the common parameters that all actions use, see Common Parameters.


Specifies whether the ScalingAdjustment is an absolute number or a percentage of the current capacity. Valid values are ChangeInCapacity, ExactCapacity, and PercentChangeInCapacity.

For more information, see Dynamic Scaling in the Auto Scaling Developer Guide.

Type: String

Length constraints: Minimum length of 1. Maximum length of 255.

Required: Yes


The name or ARN of the group.

Type: String

Length constraints: Minimum length of 1. Maximum length of 1600.

Required: Yes


The amount of time, in seconds, after a scaling activity completes and before the next scaling activity can start.

For more information, see Understanding Auto Scaling Cooldowns in the Auto Scaling Developer Guide.

Type: Integer

Required: No


Used with AdjustmentType with the value PercentChangeInCapacity, the scaling policy changes the DesiredCapacity of the Auto Scaling group by at least the number of instances specified in the value.

You will get a ValidationError if you use MinAdjustmentStep on a policy with an AdjustmentType other than PercentChangeInCapacity.

Type: Integer

Required: No


The name of the policy.

Type: String

Length constraints: Minimum length of 1. Maximum length of 255.

Required: 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.

Type: Integer

Required: Yes

Response Elements

The following element is returned in a structure named PutScalingPolicyResult.


The Amazon Resource Name (ARN) of the policy.

Type: String


For information about the errors that are common to all actions, see Common Errors.


The limit for the number of Auto Scaling groups or launch configurations has already been reached.

HTTP Status Code: 400


Sample Request

Sample Response

<PutScalingPolicyResponse xmlns="">