Request Parameters Response Elements Errors Examples See Also

DescribeTags

Describes the tags for the specified Elastic Load Balancing resources. You can describe the tags for one or more Application Load Balancers, Network Load Balancers, Gateway Load Balancers, target groups, listeners, or rules.

Request Parameters

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

ResourceArns.member.N

The Amazon Resource Names (ARN) of the resources. You can specify up to 20 resources in a single call.

Type: Array of strings

Required: Yes

Response Elements

The following element is returned by the service.

TagDescriptions.member.N

Information about the tags.

Type: Array of TagDescription objects

Errors

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

ListenerNotFound

The specified listener does not exist.

HTTP Status Code: 400

LoadBalancerNotFound

The specified load balancer does not exist.

HTTP Status Code: 400

RuleNotFound

The specified rule does not exist.

HTTP Status Code: 400

TargetGroupNotFound

The specified target group does not exist.

HTTP Status Code: 400

TrustStoreNotFound

The specified trust store does not exist.

HTTP Status Code: 400

Examples

Describe the tags assigned to a load balancer

This example describes the tags assigned to the specified load balancer.

Sample Request


https://elasticloadbalancing.amazonaws.com/?Action=DescribeTags
&ResourceArns.member.1=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
&Version=2015-12-01
&AUTHPARAMS

Sample Response


<DescribeTagsResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <DescribeTagsResult> 
    <TagDescriptions> 
      <member> 
        <ResourceArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188</ResourceArn> 
        <Tags> 
          <member> 
            <Value>lima</Value> 
            <Key>project</Key> 
          </member> 
          <member> 
            <Value>digital-media</Value> 
            <Key>department</Key> 
          </member> 
        </Tags> 
      </member> 
    </TagDescriptions> 
  </DescribeTagsResult> 
  <ResponseMetadata> 
    <RequestId>34f144db-f2d9-11e5-a53c-67205c0d10fd</RequestId> 
  </ResponseMetadata>
</DescribeTagsResponse>