Elastic Load Balancing
API Reference (API Version 2012-06-01)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did this page help you?  Yes | No |  Tell us about it...

DescribeInstanceHealth

Description

Returns the current state of the instances of the specified LoadBalancer. If no instances are specified, the state of all the instances for the LoadBalancer is returned.

Note

The client must have created the specified input LoadBalancer in order to retrieve this information; the client must provide the same account credentials as those that were used to create the LoadBalancer.

Request Parameters

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

Instances.member.N

A list of instance IDs whose states are being queried.

Type: Instance list

Required: No

LoadBalancerName

The name associated with the LoadBalancer. The name must be unique within the client AWS account.

Type: String

Required: Yes

Response Elements

The following element is returned in a DescribeInstanceHealthResult structure.

InstanceStates

A list containing health information for the specified instances.

Type: InstanceState list

Errors

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

AccessPointNotFound

The specified LoadBalancer could not be found.

HTTP Status Code: 400

InvalidEndPoint

The specified EndPoint is not valid.

HTTP Status Code: 400