DescribeAutoScalingGroups
In this article:
DescribeAutoScalingGroups#
Description#
Gets information about Auto Scaling Groups (ASGs).
Request Parameters#
AutoScalingGroupNames — List of ASG names.
Type: Array of strings
Required: No
Filters — Filters the results by the specified tags.
Type: List of Filter objects
Required: No
MaxRecords — The maximum number of ASG records to retrieve.
Type: Integer
Required: No
Default value:
100
Maximum value:
100
NextToken — NextToken returned by a previous call (see Response Elements).
Required: No
Type: String
Supported Filters#
tag-key — Filters the ASGs by the specified tag keys.
tag-value — Filters the ASGs by the specified tag values.
tag:<key> — Filters the ASGs by the specified tag key and corresponding tag values.
Response Elements#
AutoScalingGroups — List of ASGs.
Type: List of AutoScalingGroup objects
NextToken — The token is returned only when the response cannot contain all ASG records that meet the criteria. To retrieve further data, the returned value must be passed as a NextToken parameter in the same request.
Type: String
Examples#
c2-as DescribeAutoScalingGroups
c2-as DescribeAutoScalingGroups MaxRecords 5 NextToken <next_token>
c2-as DescribeAutoScalingGroups AutoScalingGroupNames.1 "asg_name"
c2-as DescribeAutoScalingGroups Filters.1.Name tag-key Filters.1.Values.1 key1
c2-as DescribeAutoScalingGroups Filters.1.Name tag-value Filters.1.Values.1 value1
c2-as DescribeAutoScalingGroups Filters.1.Name tag:key1 Filters.1.Values.1 value1