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

  • NextTokenNextToken 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.

  • 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