AWS CloudFormation
User Guide (API Version 2010-05-15)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Go to the Kindle Store to download this guide in Kindle format.Did this page help you?  Yes | No |  Tell us about it...

ElasticLoadBalancing HealthCheck Type

The ElasticLoadBalancing HealthCheck is an embedded property of the AWS::ElasticLoadBalancing::LoadBalancer type.

Syntax

{
   "HealthyThreshold" : String,
   "Interval" : String,
   "Target" : String,
   "Timeout" : String,
   "UnhealthyThreshold" : String
}

Properties

HealthyThreshold

Specifies the number of consecutive health probe successes required before moving the instance to the Healthy state.

Required: Yes

Type: String

Interval

Specifies the approximate interval, in seconds, between health checks of an individual instance.

Required: Yes

Type: String

Target

Specifies the instance being checked. The protocol is either TCP or HTTP. The range of valid ports is 1 through 65535.

Required: Yes

Type: String

Note

TCP is the default, specified as a TCP: port pair—for example, "TCP:5000". In this case a healthcheck simply attempts to open a TCP connection to the instance on the specified port. Failure to connect within the configured timeout is considered unhealthy.

For HTTP, the situation is different. HTTP is specified as a HTTP:port;/;PathToPing; grouping—for example, "HTTP:80/weather/us/wa/seattle". In this case, a HTTP GET request is issued to the instance on the given port and path. Any answer other than "200 OK" within the timeout period is considered unhealthy.

The total length of the HTTP ping target needs to be 1024 16-bit Unicode characters or fewer.

Timeout

Specifies the amount of time, in seconds, during which no response means a failed health probe. This value must be less than the value for Interval.

Required: Yes

Type: String

UnhealthyThreshold

Specifies the number of consecutive health probe failures required before moving the instance to the Unhealthy state.

Required: Yes

Type: String