:doc:`ElasticLoadBalancingv2 <../../elbv2>` / Client / describe_tags

*************
describe_tags
*************



.. py:method:: ElasticLoadBalancingv2.Client.describe_tags(**kwargs)

  

  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.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/elasticloadbalancingv2-2015-12-01/DescribeTags>`_  


  **Request Syntax**
  ::

    response = client.describe_tags(
        ResourceArns=[
            'string',
        ]
    )
    
  :type ResourceArns: list
  :param ResourceArns: **[REQUIRED]** 

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

    

  
    - *(string) --* 

    

  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'TagDescriptions': [
              {
                  'ResourceArn': 'string',
                  'Tags': [
                      {
                          'Key': 'string',
                          'Value': 'string'
                      },
                  ]
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **TagDescriptions** *(list) --* 

        Information about the tags.

        
        

        - *(dict) --* 

          The tags associated with a resource.

          
          

          - **ResourceArn** *(string) --* 

            The Amazon Resource Name (ARN) of the resource.

            
          

          - **Tags** *(list) --* 

            Information about the tags.

            
            

            - *(dict) --* 

              Information about a tag.

              
              

              - **Key** *(string) --* 

                The key of the tag.

                
              

              - **Value** *(string) --* 

                The value of the tag.

                
          
        
      
    
  
  **Exceptions**
  
  *   :py:class:`ElasticLoadBalancingv2.Client.exceptions.LoadBalancerNotFoundException`

  
  *   :py:class:`ElasticLoadBalancingv2.Client.exceptions.TargetGroupNotFoundException`

  
  *   :py:class:`ElasticLoadBalancingv2.Client.exceptions.ListenerNotFoundException`

  
  *   :py:class:`ElasticLoadBalancingv2.Client.exceptions.RuleNotFoundException`

  
  *   :py:class:`ElasticLoadBalancingv2.Client.exceptions.TrustStoreNotFoundException`

  

  **Examples**

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

    response = client.describe_tags(
        ResourceArns=[
            'arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188',
        ],
    )
    
    print(response)

  
  Expected Output:
  ::

    {
        'TagDescriptions': [
            {
                'ResourceArn': 'arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188',
                'Tags': [
                    {
                        'Key': 'project',
                        'Value': 'lima',
                    },
                    {
                        'Key': 'department',
                        'Value': 'digital-media',
                    },
                ],
            },
        ],
        'ResponseMetadata': {
            '...': '...',
        },
    }

  