Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

AWS::AppRunner::Service HealthCheckConfiguration

Focus mode
AWS::AppRunner::Service HealthCheckConfiguration - AWS CloudFormation
Filter View

Describes the settings for the health check that AWS App Runner performs to monitor the health of a service.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{ "HealthyThreshold" : Integer, "Interval" : Integer, "Path" : String, "Protocol" : String, "Timeout" : Integer, "UnhealthyThreshold" : Integer }

YAML

HealthyThreshold: Integer Interval: Integer Path: String Protocol: String Timeout: Integer UnhealthyThreshold: Integer

Properties

HealthyThreshold

The number of consecutive checks that must succeed before App Runner decides that the service is healthy.

Default: 1

Required: No

Type: Integer

Minimum: 1

Maximum: 20

Update requires: No interruption

Interval

The time interval, in seconds, between health checks.

Default: 5

Required: No

Type: Integer

Minimum: 1

Maximum: 20

Update requires: No interruption

Path

The URL that health check requests are sent to.

Path is only applicable when you set Protocol to HTTP.

Default: "/"

Required: No

Type: String

Minimum: 1

Update requires: No interruption

Protocol

The IP protocol that App Runner uses to perform health checks for your service.

If you set Protocol to HTTP, App Runner sends health check requests to the HTTP path specified by Path.

Default: TCP

Required: No

Type: String

Allowed values: TCP | HTTP

Update requires: No interruption

Timeout

The time, in seconds, to wait for a health check response before deciding it failed.

Default: 2

Required: No

Type: Integer

Minimum: 1

Maximum: 20

Update requires: No interruption

UnhealthyThreshold

The number of consecutive checks that must fail before App Runner decides that the service is unhealthy.

Default: 5

Required: No

Type: Integer

Minimum: 1

Maximum: 20

Update requires: No interruption

On this page

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.