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



Returns a description of each Auto Scaling instance in the InstanceIds list. If a list is not provided, the service returns the full details of all instances up to a maximum of 50. By default, the service returns a list of 20 items.

This action supports pagination by returning a token if there are more pages to retrieve. To get the next page, call this action again with the returned token as the NextToken parameter.

Request Parameters

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


The list of Auto Scaling instances to describe. If this list is omitted, all auto scaling instances are described. The list of requested instances cannot contain more than 50 items. If unknown instances are requested, they are ignored with no error.

Type: String list

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

Required: No


The maximum number of Auto Scaling instances to be described with each call.

Type: Integer

Required: No


The token returned by a previous call to indicate that there is more data available.

Type: String

Required: No

Response Elements

The following elements are returned in a structure named DescribeAutoScalingInstancesResult.


A list of Auto Scaling instances.

Type: AutoScalingInstanceDetails list


A string that marks the start of the next batch of returned results.

Type: String


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


The NextToken value is invalid.

HTTP Status Code: 400


Sample Request

Sample Response

<DescribeAutoScalingInstancesResponse xmlns="">