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>
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: