Skip to content

describe_tags

describe_tags(
    *,
    config_overrides: Optional[ElasticLoadBalancingv2ClientConfig] = None,
    resource_arns: Optional[ResourceArns] = None,
) -> DescribeTagsOutput

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.

Parameters:

  • resource_arns (Optional[ResourceArns], default: None ) –

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

Raises:

Examples:

To describe the tags assigned to a load balancer This example describes the tags assigned to the specified load balancer.

>>> client.describe_tags(resource_arns=['arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188'])
Source code in docs_src/capo_elastic_load_balancing_v2/_services/elastic_load_balancingv2.py
def describe_tags(
    self,
    *,
    config_overrides: Optional[ElasticLoadBalancingv2ClientConfig] = None,
    resource_arns: Optional[
        "capo_elastic_load_balancing_v2.types.resource_arns.ResourceArns"
    ] = None,
) -> "capo_elastic_load_balancing_v2.types.describe_tags_output.DescribeTagsOutput":
    """<p>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.</p>

    Args:
        resource_arns: <p>The Amazon Resource Names (ARN) of the resources. You can specify up to 20 resources in a single call.</p>

    Raises:
        capo_elastic_load_balancing_v2.errors.listener_not_found_exception.ListenerNotFoundException: <p>The specified listener does not exist.</p>
        capo_elastic_load_balancing_v2.errors.load_balancer_not_found_exception.LoadBalancerNotFoundException: <p>The specified load balancer does not exist.</p>
        capo_elastic_load_balancing_v2.errors.rule_not_found_exception.RuleNotFoundException: <p>The specified rule does not exist.</p>
        capo_elastic_load_balancing_v2.errors.target_group_not_found_exception.TargetGroupNotFoundException: <p>The specified target group does not exist.</p>
        capo_elastic_load_balancing_v2.errors.trust_store_not_found_exception.TrustStoreNotFoundException: <p>The specified trust store does not exist.</p>
        capo_elastic_load_balancing_v2.errors.UnknownServiceError: The service returned an error code this client does not model.

    Examples:
        To describe the tags assigned to a load balancer
        This example describes the tags assigned to the specified load balancer.

        >>> client.describe_tags(resource_arns=['arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188'])
    """

    def _handler(
        req: "OperationRequest[capo_elastic_load_balancing_v2.types.describe_tags_input.DescribeTagsInput]",
    ) -> OperationResponse[
        "capo_elastic_load_balancing_v2.types.describe_tags_output.DescribeTagsOutput"
    ]:
        import capo_elastic_load_balancing_v2._operations.elastic_load_balancing_v10.describe_tags

        output, http_response = (
            capo_elastic_load_balancing_v2._operations.elastic_load_balancing_v10.describe_tags.describe_tags(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("DescribeTags")
    )
    input_: capo_elastic_load_balancing_v2.types.describe_tags_input.DescribeTagsInput = {}
    if resource_arns is not None:
        input_["resource_arns"] = resource_arns

    response = execute_pipeline(
        OperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    response.response.close()
    return response.output