describe_load_balancer_policies

describe_load_balancer_policies(**kwargs)

Describes the specified policies.

If you specify a load balancer name, the action returns the descriptions of all policies created for the load balancer. If you specify a policy name associated with your load balancer, the action returns the description of that policy. If you don't specify a load balancer name, the action returns descriptions of the specified sample policies, or descriptions of all sample policies. The names of the sample policies have the ELBSample- prefix.

See also: AWS API Documentation

Request Syntax

response = client.describe_load_balancer_policies(
    LoadBalancerName='string',
    PolicyNames=[
        'string',
    ]
)
Parameters
  • LoadBalancerName (string) -- The name of the load balancer.
  • PolicyNames (list) --

    The names of the policies.

    • (string) --
Return type

dict

Returns

Response Syntax

{
    'PolicyDescriptions': [
        {
            'PolicyName': 'string',
            'PolicyTypeName': 'string',
            'PolicyAttributeDescriptions': [
                {
                    'AttributeName': 'string',
                    'AttributeValue': 'string'
                },
            ]
        },
    ]
}

Response Structure

  • (dict) --

    Contains the output of DescribeLoadBalancerPolicies.

    • PolicyDescriptions (list) --

      Information about the policies.

      • (dict) --

        Information about a policy.

        • PolicyName (string) --

          The name of the policy.

        • PolicyTypeName (string) --

          The name of the policy type.

        • PolicyAttributeDescriptions (list) --

          The policy attributes.

          • (dict) --

            Information about a policy attribute.

            • AttributeName (string) --

              The name of the attribute.

            • AttributeValue (string) --

              The value of the attribute.

Exceptions

  • ElasticLoadBalancing.Client.exceptions.AccessPointNotFoundException
  • ElasticLoadBalancing.Client.exceptions.PolicyNotFoundException

Examples

This example describes the specified policy associated with the specified load balancer.

response = client.describe_load_balancer_policies(
    LoadBalancerName='my-load-balancer',
    PolicyNames=[
        'my-authentication-policy',
    ],
)

print(response)

Expected Output:

{
    'PolicyDescriptions': [
        {
            'PolicyAttributeDescriptions': [
                {
                    'AttributeName': 'PublicKeyPolicyName',
                    'AttributeValue': 'my-PublicKey-policy',
                },
            ],
            'PolicyName': 'my-authentication-policy',
            'PolicyTypeName': 'BackendServerAuthenticationPolicyType',
        },
    ],
    'ResponseMetadata': {
        '...': '...',
    },
}