This is the new AWS CloudFormation Template Reference Guide. Please update your bookmarks and links. For help getting started with CloudFormation, see the AWS CloudFormation User Guide.
AWS::VpcLattice::TargetGroup HealthCheckConfig
Describes the health check configuration of a target group. Health check configurations
aren't used for target groups of type LAMBDA or ALB.
Syntax
To declare this entity in your AWS CloudFormation template, use the following syntax:
JSON
{ "Enabled" :Boolean, "HealthCheckIntervalSeconds" :Integer, "HealthCheckTimeoutSeconds" :Integer, "HealthyThresholdCount" :Integer, "Matcher" :Matcher, "Path" :String, "Port" :Integer, "Protocol" :String, "ProtocolVersion" :String, "UnhealthyThresholdCount" :Integer}
YAML
Enabled:BooleanHealthCheckIntervalSeconds:IntegerHealthCheckTimeoutSeconds:IntegerHealthyThresholdCount:IntegerMatcher:MatcherPath:StringPort:IntegerProtocol:StringProtocolVersion:StringUnhealthyThresholdCount:Integer
Properties
Enabled-
Indicates whether health checking is enabled.
Required: No
Type: Boolean
Update requires: No interruption
HealthCheckIntervalSeconds-
The approximate amount of time, in seconds, between health checks of an individual target. The range is 5–300 seconds. The default is 30 seconds.
Required: No
Type: Integer
Minimum:
5Maximum:
300Update requires: No interruption
HealthCheckTimeoutSeconds-
The amount of time, in seconds, to wait before reporting a target as unhealthy. The range is 1–120 seconds. The default is 5 seconds.
Required: No
Type: Integer
Minimum:
1Maximum:
120Update requires: No interruption
HealthyThresholdCount-
The number of consecutive successful health checks required before considering an unhealthy target healthy. The range is 2–10. The default is 5.
Required: No
Type: Integer
Minimum:
2Maximum:
10Update requires: No interruption
Matcher-
The codes to use when checking for a successful response from a target.
Required: No
Type: Matcher
Update requires: No interruption
Path-
The destination for health checks on the targets. If the protocol version is
HTTP/1.1orHTTP/2, specify a valid URI (for example,/path?query). The default path is/. Health checks are not supported if the protocol version isgRPC, however, you can chooseHTTP/1.1orHTTP/2and specify a valid URI.Required: No
Type: String
Pattern:
(^/[a-zA-Z0-9@:%_+.~#?&/=-]*$|(^$))Minimum:
0Maximum:
2048Update requires: No interruption
Port-
The port used when performing health checks on targets. The default setting is the port that a target receives traffic on.
Required: No
Type: Integer
Minimum:
1Maximum:
65535Update requires: No interruption
Protocol-
The protocol used when performing health checks on targets. The possible protocols are
HTTPandHTTPS. The default isHTTP.Required: No
Type: String
Allowed values:
HTTP | HTTPSUpdate requires: No interruption
ProtocolVersion-
The protocol version used when performing health checks on targets. The possible protocol versions are
HTTP1andHTTP2.Required: No
Type: String
Allowed values:
HTTP1 | HTTP2Update requires: No interruption
UnhealthyThresholdCount-
The number of consecutive failed health checks required before considering a target unhealthy. The range is 2–10. The default is 2.
Required: No
Type: Integer
Minimum:
2Maximum:
10Update requires: No interruption