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

DescribeTags

Description

Lists the Auto Scaling group tags.

You can use filters to limit results when describing tags. For example, you can query for tags of a particular Auto Scaling group. You can specify multiple values for a filter. A tag must match at least one of the specified values for it to be included in the results.

You can also specify multiple filters. The result includes information for a particular tag only if it matches all your filters. If there's no match, no special message is returned.

Request Parameters

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

Filters.member.N

The value of the filter type used to identify the tags to be returned. For example, you can filter so that tags are returned according to Auto Scaling group, the key and value, or whether the new tag will be applied to instances launched after the tag is created (PropagateAtLaunch).

Type: Filter list

Required: No

MaxRecords

The maximum number of records to return.

Type: Integer

Required: No

NextToken

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

Type: String

Required: No

Response Elements

The following elements are returned in a structure named DescribeTagsResult.

NextToken

A string used to mark the start of the next batch of returned results.

Type: String

Tags

The list of tags.

Type: TagDescription list

Errors

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

InvalidNextToken

The NextToken value is invalid.

HTTP Status Code: 400

Examples

Sample Request

https://autoscaling.amazonaws.com/?Version=2011-01-01&Action=DescribeTags
&AUTHPARAMS 

Sample Response

<DescribeTagsResponse xmlns="http://autoscaling.amazonaws.com/doc/2011-01-01/">
  <DescribeTagsResult>
    <Tags>      
      <member>
        <ResourceId>my-test-asg</ResourceId>
        <PropagateAtLaunch>true</PropagateAtLaunch>
        <Value>1.0</Value>
        <Key>version</Key>
        <ResourceType>auto-scaling-group</ResourceType>
      </member>
    </Tags>
  </DescribeTagsResult>
  <ResponseMetadata>
    <RequestId>086265fd-bf3e-11e2-85fc-fbb1EXAMPLE</RequestId>
  </ResponseMetadata>
</DescribeTagsResponse>