Auto Scaling
API Reference (API Version 2011-01-01)


Sets the size of the specified Auto Scaling group.

For more information about desired capacity, see What Is Auto Scaling? in the Auto Scaling User Guide.

Request Parameters

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


The name of the Auto Scaling group.

Type: String

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

Pattern: [\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*

Required: Yes


The number of EC2 instances that should be running in the Auto Scaling group.

Type: Integer

Required: Yes


By default, SetDesiredCapacity overrides any cooldown period associated with the Auto Scaling group. Specify True to make Auto Scaling to wait for the cool-down period associated with the Auto Scaling group to complete before initiating a scaling activity to set your Auto Scaling group to its new capacity.

Type: Boolean

Required: No


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


You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

HTTP Status Code: 500


The operation can't be performed because there are scaling activities in progress.

HTTP Status Code: 400


Sample Request

Copy &AutoScalingGroupName=my-asg &HonorCooldown=false &DesiredCapacity=2 &Version=2011-01-01 &AUTHPARAMS

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: