Request Parameters Response Elements Errors Examples See Also

DescribeLoadBalancers

Describes the specified load balancers or all of your load balancers.

To describe the listeners for a load balancer, use DescribeListeners. To describe the attributes for a load balancer, use DescribeLoadBalancerAttributes.

Request Parameters

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

LoadBalancerArns.member.N

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

Type: Array of strings

Required: No

Marker

The marker for the next set of results. (You received this marker from a previous call.)

Type: String

Required: No

Names.member.N

The names of the load balancers.

Type: Array of strings

Required: No

PageSize

The maximum number of results to return with this call.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 400.

Required: No

Response Elements

The following elements are returned by the service.

LoadBalancers.member.N

Information about the load balancers.

Type: Array of LoadBalancer objects

NextMarker

If there are additional results, this is the marker for the next set of results. Otherwise, this is null.

Type: String

Errors

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

LoadBalancerNotFound

The specified load balancer does not exist.

HTTP Status Code: 400

Examples

Describe a load balancer

This example describes the specified load balancer.

Sample Request


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

Sample Response



  
     
       
        arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 
        internet-facing 
        my-load-balancer 
        vpc-3ac0fb5f 
        Z2P70J7EXAMPLE 
        2016-03-25T21:26:12.920Z 
         
           
            subnet-8360a9e7 
            us-west-2a 
           
           
            subnet-b7d581c0 
            us-west-2b 
           
         
         
          sg-5943793c 
         
        my-load-balancer-424835706.us-west-2.elb.amazonaws.com 
         
          active 
         
        application 
       
     
   
   
    6581c0ac-f39f-11e5-bb98-57195a6eb84a

Describe all load balancers

This example describes all of your load balancers.

Sample Request


https://elasticloadbalancing.amazonaws.com/?Action=DescribeLoadBalancers
&Version=2015-12-01
&AUTHPARAMS