Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. AWS
  3. API Docs
  4. route53
  5. HealthCheck
AWS v6.76.0 published on Tuesday, Apr 8, 2025 by Pulumi
pulumi/pulumi-aws

aws.route53.HealthCheck

Explore with Pulumi AI

AWS v6.76.0 published on Tuesday, Apr 8, 2025 by Pulumi
pulumi/pulumi-aws

Provides a Route53 health check.

Example Usage

Connectivity and HTTP Status Code Check

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.route53.HealthCheck("example", {
    fqdn: "example.com",
    port: 80,
    type: "HTTP",
    resourcePath: "/",
    failureThreshold: 5,
    requestInterval: 30,
    tags: {
        Name: "tf-test-health-check",
    },
});
Copy
import pulumi
import pulumi_aws as aws

example = aws.route53.HealthCheck("example",
    fqdn="example.com",
    port=80,
    type="HTTP",
    resource_path="/",
    failure_threshold=5,
    request_interval=30,
    tags={
        "Name": "tf-test-health-check",
    })
Copy
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/route53"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := route53.NewHealthCheck(ctx, "example", &route53.HealthCheckArgs{
			Fqdn:             pulumi.String("example.com"),
			Port:             pulumi.Int(80),
			Type:             pulumi.String("HTTP"),
			ResourcePath:     pulumi.String("/"),
			FailureThreshold: pulumi.Int(5),
			RequestInterval:  pulumi.Int(30),
			Tags: pulumi.StringMap{
				"Name": pulumi.String("tf-test-health-check"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var example = new Aws.Route53.HealthCheck("example", new()
    {
        Fqdn = "example.com",
        Port = 80,
        Type = "HTTP",
        ResourcePath = "/",
        FailureThreshold = 5,
        RequestInterval = 30,
        Tags = 
        {
            { "Name", "tf-test-health-check" },
        },
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.route53.HealthCheck;
import com.pulumi.aws.route53.HealthCheckArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new HealthCheck("example", HealthCheckArgs.builder()
            .fqdn("example.com")
            .port(80)
            .type("HTTP")
            .resourcePath("/")
            .failureThreshold("5")
            .requestInterval("30")
            .tags(Map.of("Name", "tf-test-health-check"))
            .build());

    }
}
Copy
resources:
  example:
    type: aws:route53:HealthCheck
    properties:
      fqdn: example.com
      port: 80
      type: HTTP
      resourcePath: /
      failureThreshold: '5'
      requestInterval: '30'
      tags:
        Name: tf-test-health-check
Copy

Connectivity and String Matching Check

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.route53.HealthCheck("example", {
    failureThreshold: 5,
    fqdn: "example.com",
    port: 443,
    requestInterval: 30,
    resourcePath: "/",
    searchString: "example",
    type: "HTTPS_STR_MATCH",
});
Copy
import pulumi
import pulumi_aws as aws

example = aws.route53.HealthCheck("example",
    failure_threshold=5,
    fqdn="example.com",
    port=443,
    request_interval=30,
    resource_path="/",
    search_string="example",
    type="HTTPS_STR_MATCH")
Copy
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/route53"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := route53.NewHealthCheck(ctx, "example", &route53.HealthCheckArgs{
			FailureThreshold: pulumi.Int(5),
			Fqdn:             pulumi.String("example.com"),
			Port:             pulumi.Int(443),
			RequestInterval:  pulumi.Int(30),
			ResourcePath:     pulumi.String("/"),
			SearchString:     pulumi.String("example"),
			Type:             pulumi.String("HTTPS_STR_MATCH"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var example = new Aws.Route53.HealthCheck("example", new()
    {
        FailureThreshold = 5,
        Fqdn = "example.com",
        Port = 443,
        RequestInterval = 30,
        ResourcePath = "/",
        SearchString = "example",
        Type = "HTTPS_STR_MATCH",
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.route53.HealthCheck;
import com.pulumi.aws.route53.HealthCheckArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new HealthCheck("example", HealthCheckArgs.builder()
            .failureThreshold("5")
            .fqdn("example.com")
            .port(443)
            .requestInterval("30")
            .resourcePath("/")
            .searchString("example")
            .type("HTTPS_STR_MATCH")
            .build());

    }
}
Copy
resources:
  example:
    type: aws:route53:HealthCheck
    properties:
      failureThreshold: '5'
      fqdn: example.com
      port: 443
      requestInterval: '30'
      resourcePath: /
      searchString: example
      type: HTTPS_STR_MATCH
Copy

Aggregate Check

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const parent = new aws.route53.HealthCheck("parent", {
    type: "CALCULATED",
    childHealthThreshold: 1,
    childHealthchecks: [child.id],
    tags: {
        Name: "tf-test-calculated-health-check",
    },
});
Copy
import pulumi
import pulumi_aws as aws

parent = aws.route53.HealthCheck("parent",
    type="CALCULATED",
    child_health_threshold=1,
    child_healthchecks=[child["id"]],
    tags={
        "Name": "tf-test-calculated-health-check",
    })
Copy
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/route53"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := route53.NewHealthCheck(ctx, "parent", &route53.HealthCheckArgs{
			Type:                 pulumi.String("CALCULATED"),
			ChildHealthThreshold: pulumi.Int(1),
			ChildHealthchecks: pulumi.StringArray{
				child.Id,
			},
			Tags: pulumi.StringMap{
				"Name": pulumi.String("tf-test-calculated-health-check"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var parent = new Aws.Route53.HealthCheck("parent", new()
    {
        Type = "CALCULATED",
        ChildHealthThreshold = 1,
        ChildHealthchecks = new[]
        {
            child.Id,
        },
        Tags = 
        {
            { "Name", "tf-test-calculated-health-check" },
        },
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.route53.HealthCheck;
import com.pulumi.aws.route53.HealthCheckArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var parent = new HealthCheck("parent", HealthCheckArgs.builder()
            .type("CALCULATED")
            .childHealthThreshold(1)
            .childHealthchecks(child.id())
            .tags(Map.of("Name", "tf-test-calculated-health-check"))
            .build());

    }
}
Copy
resources:
  parent:
    type: aws:route53:HealthCheck
    properties:
      type: CALCULATED
      childHealthThreshold: 1
      childHealthchecks:
        - ${child.id}
      tags:
        Name: tf-test-calculated-health-check
Copy

CloudWatch Alarm Check

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const foobar = new aws.cloudwatch.MetricAlarm("foobar", {
    name: "test-foobar5",
    comparisonOperator: "GreaterThanOrEqualToThreshold",
    evaluationPeriods: 2,
    metricName: "CPUUtilization",
    namespace: "AWS/EC2",
    period: 120,
    statistic: "Average",
    threshold: 80,
    alarmDescription: "This metric monitors ec2 cpu utilization",
});
const foo = new aws.route53.HealthCheck("foo", {
    type: "CLOUDWATCH_METRIC",
    cloudwatchAlarmName: foobar.name,
    cloudwatchAlarmRegion: "us-west-2",
    insufficientDataHealthStatus: "Healthy",
});
Copy
import pulumi
import pulumi_aws as aws

foobar = aws.cloudwatch.MetricAlarm("foobar",
    name="test-foobar5",
    comparison_operator="GreaterThanOrEqualToThreshold",
    evaluation_periods=2,
    metric_name="CPUUtilization",
    namespace="AWS/EC2",
    period=120,
    statistic="Average",
    threshold=80,
    alarm_description="This metric monitors ec2 cpu utilization")
foo = aws.route53.HealthCheck("foo",
    type="CLOUDWATCH_METRIC",
    cloudwatch_alarm_name=foobar.name,
    cloudwatch_alarm_region="us-west-2",
    insufficient_data_health_status="Healthy")
Copy
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/cloudwatch"
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/route53"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		foobar, err := cloudwatch.NewMetricAlarm(ctx, "foobar", &cloudwatch.MetricAlarmArgs{
			Name:               pulumi.String("test-foobar5"),
			ComparisonOperator: pulumi.String("GreaterThanOrEqualToThreshold"),
			EvaluationPeriods:  pulumi.Int(2),
			MetricName:         pulumi.String("CPUUtilization"),
			Namespace:          pulumi.String("AWS/EC2"),
			Period:             pulumi.Int(120),
			Statistic:          pulumi.String("Average"),
			Threshold:          pulumi.Float64(80),
			AlarmDescription:   pulumi.String("This metric monitors ec2 cpu utilization"),
		})
		if err != nil {
			return err
		}
		_, err = route53.NewHealthCheck(ctx, "foo", &route53.HealthCheckArgs{
			Type:                         pulumi.String("CLOUDWATCH_METRIC"),
			CloudwatchAlarmName:          foobar.Name,
			CloudwatchAlarmRegion:        pulumi.String("us-west-2"),
			InsufficientDataHealthStatus: pulumi.String("Healthy"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var foobar = new Aws.CloudWatch.MetricAlarm("foobar", new()
    {
        Name = "test-foobar5",
        ComparisonOperator = "GreaterThanOrEqualToThreshold",
        EvaluationPeriods = 2,
        MetricName = "CPUUtilization",
        Namespace = "AWS/EC2",
        Period = 120,
        Statistic = "Average",
        Threshold = 80,
        AlarmDescription = "This metric monitors ec2 cpu utilization",
    });

    var foo = new Aws.Route53.HealthCheck("foo", new()
    {
        Type = "CLOUDWATCH_METRIC",
        CloudwatchAlarmName = foobar.Name,
        CloudwatchAlarmRegion = "us-west-2",
        InsufficientDataHealthStatus = "Healthy",
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.cloudwatch.MetricAlarm;
import com.pulumi.aws.cloudwatch.MetricAlarmArgs;
import com.pulumi.aws.route53.HealthCheck;
import com.pulumi.aws.route53.HealthCheckArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var foobar = new MetricAlarm("foobar", MetricAlarmArgs.builder()
            .name("test-foobar5")
            .comparisonOperator("GreaterThanOrEqualToThreshold")
            .evaluationPeriods("2")
            .metricName("CPUUtilization")
            .namespace("AWS/EC2")
            .period("120")
            .statistic("Average")
            .threshold("80")
            .alarmDescription("This metric monitors ec2 cpu utilization")
            .build());

        var foo = new HealthCheck("foo", HealthCheckArgs.builder()
            .type("CLOUDWATCH_METRIC")
            .cloudwatchAlarmName(foobar.name())
            .cloudwatchAlarmRegion("us-west-2")
            .insufficientDataHealthStatus("Healthy")
            .build());

    }
}
Copy
resources:
  foobar:
    type: aws:cloudwatch:MetricAlarm
    properties:
      name: test-foobar5
      comparisonOperator: GreaterThanOrEqualToThreshold
      evaluationPeriods: '2'
      metricName: CPUUtilization
      namespace: AWS/EC2
      period: '120'
      statistic: Average
      threshold: '80'
      alarmDescription: This metric monitors ec2 cpu utilization
  foo:
    type: aws:route53:HealthCheck
    properties:
      type: CLOUDWATCH_METRIC
      cloudwatchAlarmName: ${foobar.name}
      cloudwatchAlarmRegion: us-west-2
      insufficientDataHealthStatus: Healthy
Copy

CloudWatch Alarm Check With Triggers

The triggers argument allows the Route53 health check to be synchronized when a change to the upstream CloudWatch alarm is made. In the configuration below, the health check will be synchronized any time the threshold of the alarm is changed.

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.cloudwatch.MetricAlarm("example", {
    name: "example",
    comparisonOperator: "GreaterThanOrEqualToThreshold",
    evaluationPeriods: 2,
    metricName: "CPUUtilization",
    namespace: "AWS/EC2",
    period: 120,
    statistic: "Average",
    threshold: 80,
    alarmDescription: "This metric monitors ec2 cpu utilization",
});
const exampleHealthCheck = new aws.route53.HealthCheck("example", {
    type: "CLOUDWATCH_METRIC",
    cloudwatchAlarmName: example.name,
    cloudwatchAlarmRegion: "us-west-2",
    insufficientDataHealthStatus: "Healthy",
    triggers: {
        threshold: example.threshold,
    },
});
Copy
import pulumi
import pulumi_aws as aws

example = aws.cloudwatch.MetricAlarm("example",
    name="example",
    comparison_operator="GreaterThanOrEqualToThreshold",
    evaluation_periods=2,
    metric_name="CPUUtilization",
    namespace="AWS/EC2",
    period=120,
    statistic="Average",
    threshold=80,
    alarm_description="This metric monitors ec2 cpu utilization")
example_health_check = aws.route53.HealthCheck("example",
    type="CLOUDWATCH_METRIC",
    cloudwatch_alarm_name=example.name,
    cloudwatch_alarm_region="us-west-2",
    insufficient_data_health_status="Healthy",
    triggers={
        "threshold": example.threshold,
    })
Copy
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/cloudwatch"
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/route53"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		example, err := cloudwatch.NewMetricAlarm(ctx, "example", &cloudwatch.MetricAlarmArgs{
			Name:               pulumi.String("example"),
			ComparisonOperator: pulumi.String("GreaterThanOrEqualToThreshold"),
			EvaluationPeriods:  pulumi.Int(2),
			MetricName:         pulumi.String("CPUUtilization"),
			Namespace:          pulumi.String("AWS/EC2"),
			Period:             pulumi.Int(120),
			Statistic:          pulumi.String("Average"),
			Threshold:          pulumi.Float64(80),
			AlarmDescription:   pulumi.String("This metric monitors ec2 cpu utilization"),
		})
		if err != nil {
			return err
		}
		_, err = route53.NewHealthCheck(ctx, "example", &route53.HealthCheckArgs{
			Type:                         pulumi.String("CLOUDWATCH_METRIC"),
			CloudwatchAlarmName:          example.Name,
			CloudwatchAlarmRegion:        pulumi.String("us-west-2"),
			InsufficientDataHealthStatus: pulumi.String("Healthy"),
			Triggers: pulumi.StringMap{
				"threshold": example.Threshold,
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var example = new Aws.CloudWatch.MetricAlarm("example", new()
    {
        Name = "example",
        ComparisonOperator = "GreaterThanOrEqualToThreshold",
        EvaluationPeriods = 2,
        MetricName = "CPUUtilization",
        Namespace = "AWS/EC2",
        Period = 120,
        Statistic = "Average",
        Threshold = 80,
        AlarmDescription = "This metric monitors ec2 cpu utilization",
    });

    var exampleHealthCheck = new Aws.Route53.HealthCheck("example", new()
    {
        Type = "CLOUDWATCH_METRIC",
        CloudwatchAlarmName = example.Name,
        CloudwatchAlarmRegion = "us-west-2",
        InsufficientDataHealthStatus = "Healthy",
        Triggers = 
        {
            { "threshold", example.Threshold },
        },
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.cloudwatch.MetricAlarm;
import com.pulumi.aws.cloudwatch.MetricAlarmArgs;
import com.pulumi.aws.route53.HealthCheck;
import com.pulumi.aws.route53.HealthCheckArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new MetricAlarm("example", MetricAlarmArgs.builder()
            .name("example")
            .comparisonOperator("GreaterThanOrEqualToThreshold")
            .evaluationPeriods("2")
            .metricName("CPUUtilization")
            .namespace("AWS/EC2")
            .period("120")
            .statistic("Average")
            .threshold("80")
            .alarmDescription("This metric monitors ec2 cpu utilization")
            .build());

        var exampleHealthCheck = new HealthCheck("exampleHealthCheck", HealthCheckArgs.builder()
            .type("CLOUDWATCH_METRIC")
            .cloudwatchAlarmName(example.name())
            .cloudwatchAlarmRegion("us-west-2")
            .insufficientDataHealthStatus("Healthy")
            .triggers(Map.of("threshold", example.threshold()))
            .build());

    }
}
Copy
resources:
  example:
    type: aws:cloudwatch:MetricAlarm
    properties:
      name: example
      comparisonOperator: GreaterThanOrEqualToThreshold
      evaluationPeriods: '2'
      metricName: CPUUtilization
      namespace: AWS/EC2
      period: '120'
      statistic: Average
      threshold: '80'
      alarmDescription: This metric monitors ec2 cpu utilization
  exampleHealthCheck:
    type: aws:route53:HealthCheck
    name: example
    properties:
      type: CLOUDWATCH_METRIC
      cloudwatchAlarmName: ${example.name}
      cloudwatchAlarmRegion: us-west-2
      insufficientDataHealthStatus: Healthy
      triggers:
        threshold: ${example.threshold}
Copy

Create HealthCheck Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new HealthCheck(name: string, args: HealthCheckArgs, opts?: CustomResourceOptions);
@overload
def HealthCheck(resource_name: str,
                args: HealthCheckArgs,
                opts: Optional[ResourceOptions] = None)

@overload
def HealthCheck(resource_name: str,
                opts: Optional[ResourceOptions] = None,
                type: Optional[str] = None,
                ip_address: Optional[str] = None,
                enable_sni: Optional[bool] = None,
                measure_latency: Optional[bool] = None,
                reference_name: Optional[str] = None,
                port: Optional[int] = None,
                failure_threshold: Optional[int] = None,
                fqdn: Optional[str] = None,
                insufficient_data_health_status: Optional[str] = None,
                invert_healthcheck: Optional[bool] = None,
                child_health_threshold: Optional[int] = None,
                cloudwatch_alarm_region: Optional[str] = None,
                cloudwatch_alarm_name: Optional[str] = None,
                disabled: Optional[bool] = None,
                regions: Optional[Sequence[str]] = None,
                request_interval: Optional[int] = None,
                resource_path: Optional[str] = None,
                routing_control_arn: Optional[str] = None,
                search_string: Optional[str] = None,
                tags: Optional[Mapping[str, str]] = None,
                triggers: Optional[Mapping[str, str]] = None,
                child_healthchecks: Optional[Sequence[str]] = None)
func NewHealthCheck(ctx *Context, name string, args HealthCheckArgs, opts ...ResourceOption) (*HealthCheck, error)
public HealthCheck(string name, HealthCheckArgs args, CustomResourceOptions? opts = null)
public HealthCheck(String name, HealthCheckArgs args)
public HealthCheck(String name, HealthCheckArgs args, CustomResourceOptions options)

type: aws:route53:HealthCheck
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name This property is required. string
The unique name of the resource.
args This property is required. HealthCheckArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name This property is required. str
The unique name of the resource.
args This property is required. HealthCheckArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name This property is required. string
The unique name of the resource.
args This property is required. HealthCheckArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name This property is required. string
The unique name of the resource.
args This property is required. HealthCheckArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name This property is required. String
The unique name of the resource.
args This property is required. HealthCheckArgs
The arguments to resource properties.
options CustomResourceOptions
Bag of options to control resource's behavior.

Constructor example

The following reference example uses placeholder values for all input properties.

var healthCheckResource = new Aws.Route53.HealthCheck("healthCheckResource", new()
{
    Type = "string",
    IpAddress = "string",
    EnableSni = false,
    MeasureLatency = false,
    ReferenceName = "string",
    Port = 0,
    FailureThreshold = 0,
    Fqdn = "string",
    InsufficientDataHealthStatus = "string",
    InvertHealthcheck = false,
    ChildHealthThreshold = 0,
    CloudwatchAlarmRegion = "string",
    CloudwatchAlarmName = "string",
    Disabled = false,
    Regions = new[]
    {
        "string",
    },
    RequestInterval = 0,
    ResourcePath = "string",
    RoutingControlArn = "string",
    SearchString = "string",
    Tags = 
    {
        { "string", "string" },
    },
    Triggers = 
    {
        { "string", "string" },
    },
    ChildHealthchecks = new[]
    {
        "string",
    },
});
Copy
example, err := route53.NewHealthCheck(ctx, "healthCheckResource", &route53.HealthCheckArgs{
	Type:                         pulumi.String("string"),
	IpAddress:                    pulumi.String("string"),
	EnableSni:                    pulumi.Bool(false),
	MeasureLatency:               pulumi.Bool(false),
	ReferenceName:                pulumi.String("string"),
	Port:                         pulumi.Int(0),
	FailureThreshold:             pulumi.Int(0),
	Fqdn:                         pulumi.String("string"),
	InsufficientDataHealthStatus: pulumi.String("string"),
	InvertHealthcheck:            pulumi.Bool(false),
	ChildHealthThreshold:         pulumi.Int(0),
	CloudwatchAlarmRegion:        pulumi.String("string"),
	CloudwatchAlarmName:          pulumi.String("string"),
	Disabled:                     pulumi.Bool(false),
	Regions: pulumi.StringArray{
		pulumi.String("string"),
	},
	RequestInterval:   pulumi.Int(0),
	ResourcePath:      pulumi.String("string"),
	RoutingControlArn: pulumi.String("string"),
	SearchString:      pulumi.String("string"),
	Tags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	Triggers: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	ChildHealthchecks: pulumi.StringArray{
		pulumi.String("string"),
	},
})
Copy
var healthCheckResource = new HealthCheck("healthCheckResource", HealthCheckArgs.builder()
    .type("string")
    .ipAddress("string")
    .enableSni(false)
    .measureLatency(false)
    .referenceName("string")
    .port(0)
    .failureThreshold(0)
    .fqdn("string")
    .insufficientDataHealthStatus("string")
    .invertHealthcheck(false)
    .childHealthThreshold(0)
    .cloudwatchAlarmRegion("string")
    .cloudwatchAlarmName("string")
    .disabled(false)
    .regions("string")
    .requestInterval(0)
    .resourcePath("string")
    .routingControlArn("string")
    .searchString("string")
    .tags(Map.of("string", "string"))
    .triggers(Map.of("string", "string"))
    .childHealthchecks("string")
    .build());
Copy
health_check_resource = aws.route53.HealthCheck("healthCheckResource",
    type="string",
    ip_address="string",
    enable_sni=False,
    measure_latency=False,
    reference_name="string",
    port=0,
    failure_threshold=0,
    fqdn="string",
    insufficient_data_health_status="string",
    invert_healthcheck=False,
    child_health_threshold=0,
    cloudwatch_alarm_region="string",
    cloudwatch_alarm_name="string",
    disabled=False,
    regions=["string"],
    request_interval=0,
    resource_path="string",
    routing_control_arn="string",
    search_string="string",
    tags={
        "string": "string",
    },
    triggers={
        "string": "string",
    },
    child_healthchecks=["string"])
Copy
const healthCheckResource = new aws.route53.HealthCheck("healthCheckResource", {
    type: "string",
    ipAddress: "string",
    enableSni: false,
    measureLatency: false,
    referenceName: "string",
    port: 0,
    failureThreshold: 0,
    fqdn: "string",
    insufficientDataHealthStatus: "string",
    invertHealthcheck: false,
    childHealthThreshold: 0,
    cloudwatchAlarmRegion: "string",
    cloudwatchAlarmName: "string",
    disabled: false,
    regions: ["string"],
    requestInterval: 0,
    resourcePath: "string",
    routingControlArn: "string",
    searchString: "string",
    tags: {
        string: "string",
    },
    triggers: {
        string: "string",
    },
    childHealthchecks: ["string"],
});
Copy
type: aws:route53:HealthCheck
properties:
    childHealthThreshold: 0
    childHealthchecks:
        - string
    cloudwatchAlarmName: string
    cloudwatchAlarmRegion: string
    disabled: false
    enableSni: false
    failureThreshold: 0
    fqdn: string
    insufficientDataHealthStatus: string
    invertHealthcheck: false
    ipAddress: string
    measureLatency: false
    port: 0
    referenceName: string
    regions:
        - string
    requestInterval: 0
    resourcePath: string
    routingControlArn: string
    searchString: string
    tags:
        string: string
    triggers:
        string: string
    type: string
Copy

HealthCheck Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

The HealthCheck resource accepts the following input properties:

Type
This property is required.
Changes to this property will trigger replacement.
string
The protocol to use when performing health checks. Valid values are HTTP, HTTPS, HTTP_STR_MATCH, HTTPS_STR_MATCH, TCP, CALCULATED, CLOUDWATCH_METRIC and RECOVERY_CONTROL.
ChildHealthThreshold int
The minimum number of child health checks that must be healthy for Route 53 to consider the parent health check to be healthy. Valid values are integers between 0 and 256, inclusive
ChildHealthchecks List<string>
For a specified parent health check, a list of HealthCheckId values for the associated child health checks.
CloudwatchAlarmName string
The name of the CloudWatch alarm.
CloudwatchAlarmRegion string
The region that the CloudWatch alarm was created in.
Disabled bool

A boolean value that stops Route 53 from performing health checks. When set to true, Route 53 will do the following depending on the type of health check:

  • For health checks that check the health of endpoints, Route53 stops submitting requests to your application, server, or other resource.
  • For calculated health checks, Route 53 stops aggregating the status of the referenced health checks.
  • For health checks that monitor CloudWatch alarms, Route 53 stops monitoring the corresponding CloudWatch metrics.

Note: After you disable a health check, Route 53 considers the status of the health check to always be healthy. If you configured DNS failover, Route 53 continues to route traffic to the corresponding resources. If you want to stop routing traffic to a resource, change the value of invert_healthcheck.

EnableSni bool
A boolean value that indicates whether Route53 should send the fqdn to the endpoint when performing the health check. This defaults to AWS' defaults: when the type is "HTTPS" enable_sni defaults to true, when type is anything else enable_sni defaults to false.
FailureThreshold int
The number of consecutive health checks that an endpoint must pass or fail.
Fqdn string
The fully qualified domain name of the endpoint to be checked. If a value is set for ip_address, the value set for fqdn will be passed in the Host header.
InsufficientDataHealthStatus string
The status of the health check when CloudWatch has insufficient data about the state of associated alarm. Valid values are Healthy , Unhealthy and LastKnownStatus.
InvertHealthcheck bool
A boolean value that indicates whether the status of health check should be inverted. For example, if a health check is healthy but Inverted is True , then Route 53 considers the health check to be unhealthy.
IpAddress string
The IP address of the endpoint to be checked.
MeasureLatency Changes to this property will trigger replacement. bool
A Boolean value that indicates whether you want Route 53 to measure the latency between health checkers in multiple AWS regions and your endpoint and to display CloudWatch latency graphs in the Route 53 console.
Port int
The port of the endpoint to be checked.
ReferenceName Changes to this property will trigger replacement. string
This is a reference name used in Caller Reference (helpful for identifying single health_check set amongst others)
Regions List<string>
A list of AWS regions that you want Amazon Route 53 health checkers to check the specified endpoint from.
RequestInterval Changes to this property will trigger replacement. int
The number of seconds between the time that Amazon Route 53 gets a response from your endpoint and the time that it sends the next health-check request.
ResourcePath string
The path that you want Amazon Route 53 to request when performing health checks.
RoutingControlArn Changes to this property will trigger replacement. string
The Amazon Resource Name (ARN) for the Route 53 Application Recovery Controller routing control. This is used when health check type is RECOVERY_CONTROL
SearchString string
String searched in the first 5120 bytes of the response body for check to be considered healthy. Only valid with HTTP_STR_MATCH and HTTPS_STR_MATCH.
Tags Dictionary<string, string>
A map of tags to assign to the health check. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
Triggers Dictionary<string, string>
Map of arbitrary keys and values that, when changed, will trigger an in-place update of the CloudWatch alarm arguments. Use this argument to synchronize the health check when an alarm is changed. See example above.
Type
This property is required.
Changes to this property will trigger replacement.
string
The protocol to use when performing health checks. Valid values are HTTP, HTTPS, HTTP_STR_MATCH, HTTPS_STR_MATCH, TCP, CALCULATED, CLOUDWATCH_METRIC and RECOVERY_CONTROL.
ChildHealthThreshold int
The minimum number of child health checks that must be healthy for Route 53 to consider the parent health check to be healthy. Valid values are integers between 0 and 256, inclusive
ChildHealthchecks []string
For a specified parent health check, a list of HealthCheckId values for the associated child health checks.
CloudwatchAlarmName string
The name of the CloudWatch alarm.
CloudwatchAlarmRegion string
The region that the CloudWatch alarm was created in.
Disabled bool

A boolean value that stops Route 53 from performing health checks. When set to true, Route 53 will do the following depending on the type of health check:

  • For health checks that check the health of endpoints, Route53 stops submitting requests to your application, server, or other resource.
  • For calculated health checks, Route 53 stops aggregating the status of the referenced health checks.
  • For health checks that monitor CloudWatch alarms, Route 53 stops monitoring the corresponding CloudWatch metrics.

Note: After you disable a health check, Route 53 considers the status of the health check to always be healthy. If you configured DNS failover, Route 53 continues to route traffic to the corresponding resources. If you want to stop routing traffic to a resource, change the value of invert_healthcheck.

EnableSni bool
A boolean value that indicates whether Route53 should send the fqdn to the endpoint when performing the health check. This defaults to AWS' defaults: when the type is "HTTPS" enable_sni defaults to true, when type is anything else enable_sni defaults to false.
FailureThreshold int
The number of consecutive health checks that an endpoint must pass or fail.
Fqdn string
The fully qualified domain name of the endpoint to be checked. If a value is set for ip_address, the value set for fqdn will be passed in the Host header.
InsufficientDataHealthStatus string
The status of the health check when CloudWatch has insufficient data about the state of associated alarm. Valid values are Healthy , Unhealthy and LastKnownStatus.
InvertHealthcheck bool
A boolean value that indicates whether the status of health check should be inverted. For example, if a health check is healthy but Inverted is True , then Route 53 considers the health check to be unhealthy.
IpAddress string
The IP address of the endpoint to be checked.
MeasureLatency Changes to this property will trigger replacement. bool
A Boolean value that indicates whether you want Route 53 to measure the latency between health checkers in multiple AWS regions and your endpoint and to display CloudWatch latency graphs in the Route 53 console.
Port int
The port of the endpoint to be checked.
ReferenceName Changes to this property will trigger replacement. string
This is a reference name used in Caller Reference (helpful for identifying single health_check set amongst others)
Regions []string
A list of AWS regions that you want Amazon Route 53 health checkers to check the specified endpoint from.
RequestInterval Changes to this property will trigger replacement. int
The number of seconds between the time that Amazon Route 53 gets a response from your endpoint and the time that it sends the next health-check request.
ResourcePath string
The path that you want Amazon Route 53 to request when performing health checks.
RoutingControlArn Changes to this property will trigger replacement. string
The Amazon Resource Name (ARN) for the Route 53 Application Recovery Controller routing control. This is used when health check type is RECOVERY_CONTROL
SearchString string
String searched in the first 5120 bytes of the response body for check to be considered healthy. Only valid with HTTP_STR_MATCH and HTTPS_STR_MATCH.
Tags map[string]string
A map of tags to assign to the health check. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
Triggers map[string]string
Map of arbitrary keys and values that, when changed, will trigger an in-place update of the CloudWatch alarm arguments. Use this argument to synchronize the health check when an alarm is changed. See example above.
type
This property is required.
Changes to this property will trigger replacement.
String
The protocol to use when performing health checks. Valid values are HTTP, HTTPS, HTTP_STR_MATCH, HTTPS_STR_MATCH, TCP, CALCULATED, CLOUDWATCH_METRIC and RECOVERY_CONTROL.
childHealthThreshold Integer
The minimum number of child health checks that must be healthy for Route 53 to consider the parent health check to be healthy. Valid values are integers between 0 and 256, inclusive
childHealthchecks List<String>
For a specified parent health check, a list of HealthCheckId values for the associated child health checks.
cloudwatchAlarmName String
The name of the CloudWatch alarm.
cloudwatchAlarmRegion String
The region that the CloudWatch alarm was created in.
disabled Boolean

A boolean value that stops Route 53 from performing health checks. When set to true, Route 53 will do the following depending on the type of health check:

  • For health checks that check the health of endpoints, Route53 stops submitting requests to your application, server, or other resource.
  • For calculated health checks, Route 53 stops aggregating the status of the referenced health checks.
  • For health checks that monitor CloudWatch alarms, Route 53 stops monitoring the corresponding CloudWatch metrics.

Note: After you disable a health check, Route 53 considers the status of the health check to always be healthy. If you configured DNS failover, Route 53 continues to route traffic to the corresponding resources. If you want to stop routing traffic to a resource, change the value of invert_healthcheck.

enableSni Boolean
A boolean value that indicates whether Route53 should send the fqdn to the endpoint when performing the health check. This defaults to AWS' defaults: when the type is "HTTPS" enable_sni defaults to true, when type is anything else enable_sni defaults to false.
failureThreshold Integer
The number of consecutive health checks that an endpoint must pass or fail.
fqdn String
The fully qualified domain name of the endpoint to be checked. If a value is set for ip_address, the value set for fqdn will be passed in the Host header.
insufficientDataHealthStatus String
The status of the health check when CloudWatch has insufficient data about the state of associated alarm. Valid values are Healthy , Unhealthy and LastKnownStatus.
invertHealthcheck Boolean
A boolean value that indicates whether the status of health check should be inverted. For example, if a health check is healthy but Inverted is True , then Route 53 considers the health check to be unhealthy.
ipAddress String
The IP address of the endpoint to be checked.
measureLatency Changes to this property will trigger replacement. Boolean
A Boolean value that indicates whether you want Route 53 to measure the latency between health checkers in multiple AWS regions and your endpoint and to display CloudWatch latency graphs in the Route 53 console.
port Integer
The port of the endpoint to be checked.
referenceName Changes to this property will trigger replacement. String
This is a reference name used in Caller Reference (helpful for identifying single health_check set amongst others)
regions List<String>
A list of AWS regions that you want Amazon Route 53 health checkers to check the specified endpoint from.
requestInterval Changes to this property will trigger replacement. Integer
The number of seconds between the time that Amazon Route 53 gets a response from your endpoint and the time that it sends the next health-check request.
resourcePath String
The path that you want Amazon Route 53 to request when performing health checks.
routingControlArn Changes to this property will trigger replacement. String
The Amazon Resource Name (ARN) for the Route 53 Application Recovery Controller routing control. This is used when health check type is RECOVERY_CONTROL
searchString String
String searched in the first 5120 bytes of the response body for check to be considered healthy. Only valid with HTTP_STR_MATCH and HTTPS_STR_MATCH.
tags Map<String,String>
A map of tags to assign to the health check. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
triggers Map<String,String>
Map of arbitrary keys and values that, when changed, will trigger an in-place update of the CloudWatch alarm arguments. Use this argument to synchronize the health check when an alarm is changed. See example above.
type
This property is required.
Changes to this property will trigger replacement.
string
The protocol to use when performing health checks. Valid values are HTTP, HTTPS, HTTP_STR_MATCH, HTTPS_STR_MATCH, TCP, CALCULATED, CLOUDWATCH_METRIC and RECOVERY_CONTROL.
childHealthThreshold number
The minimum number of child health checks that must be healthy for Route 53 to consider the parent health check to be healthy. Valid values are integers between 0 and 256, inclusive
childHealthchecks string[]
For a specified parent health check, a list of HealthCheckId values for the associated child health checks.
cloudwatchAlarmName string
The name of the CloudWatch alarm.
cloudwatchAlarmRegion string
The region that the CloudWatch alarm was created in.
disabled boolean

A boolean value that stops Route 53 from performing health checks. When set to true, Route 53 will do the following depending on the type of health check:

  • For health checks that check the health of endpoints, Route53 stops submitting requests to your application, server, or other resource.
  • For calculated health checks, Route 53 stops aggregating the status of the referenced health checks.
  • For health checks that monitor CloudWatch alarms, Route 53 stops monitoring the corresponding CloudWatch metrics.

Note: After you disable a health check, Route 53 considers the status of the health check to always be healthy. If you configured DNS failover, Route 53 continues to route traffic to the corresponding resources. If you want to stop routing traffic to a resource, change the value of invert_healthcheck.

enableSni boolean
A boolean value that indicates whether Route53 should send the fqdn to the endpoint when performing the health check. This defaults to AWS' defaults: when the type is "HTTPS" enable_sni defaults to true, when type is anything else enable_sni defaults to false.
failureThreshold number
The number of consecutive health checks that an endpoint must pass or fail.
fqdn string
The fully qualified domain name of the endpoint to be checked. If a value is set for ip_address, the value set for fqdn will be passed in the Host header.
insufficientDataHealthStatus string
The status of the health check when CloudWatch has insufficient data about the state of associated alarm. Valid values are Healthy , Unhealthy and LastKnownStatus.
invertHealthcheck boolean
A boolean value that indicates whether the status of health check should be inverted. For example, if a health check is healthy but Inverted is True , then Route 53 considers the health check to be unhealthy.
ipAddress string
The IP address of the endpoint to be checked.
measureLatency Changes to this property will trigger replacement. boolean
A Boolean value that indicates whether you want Route 53 to measure the latency between health checkers in multiple AWS regions and your endpoint and to display CloudWatch latency graphs in the Route 53 console.
port number
The port of the endpoint to be checked.
referenceName Changes to this property will trigger replacement. string
This is a reference name used in Caller Reference (helpful for identifying single health_check set amongst others)
regions string[]
A list of AWS regions that you want Amazon Route 53 health checkers to check the specified endpoint from.
requestInterval Changes to this property will trigger replacement. number
The number of seconds between the time that Amazon Route 53 gets a response from your endpoint and the time that it sends the next health-check request.
resourcePath string
The path that you want Amazon Route 53 to request when performing health checks.
routingControlArn Changes to this property will trigger replacement. string
The Amazon Resource Name (ARN) for the Route 53 Application Recovery Controller routing control. This is used when health check type is RECOVERY_CONTROL
searchString string
String searched in the first 5120 bytes of the response body for check to be considered healthy. Only valid with HTTP_STR_MATCH and HTTPS_STR_MATCH.
tags {[key: string]: string}
A map of tags to assign to the health check. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
triggers {[key: string]: string}
Map of arbitrary keys and values that, when changed, will trigger an in-place update of the CloudWatch alarm arguments. Use this argument to synchronize the health check when an alarm is changed. See example above.
type
This property is required.
Changes to this property will trigger replacement.
str
The protocol to use when performing health checks. Valid values are HTTP, HTTPS, HTTP_STR_MATCH, HTTPS_STR_MATCH, TCP, CALCULATED, CLOUDWATCH_METRIC and RECOVERY_CONTROL.
child_health_threshold int
The minimum number of child health checks that must be healthy for Route 53 to consider the parent health check to be healthy. Valid values are integers between 0 and 256, inclusive
child_healthchecks Sequence[str]
For a specified parent health check, a list of HealthCheckId values for the associated child health checks.
cloudwatch_alarm_name str
The name of the CloudWatch alarm.
cloudwatch_alarm_region str
The region that the CloudWatch alarm was created in.
disabled bool

A boolean value that stops Route 53 from performing health checks. When set to true, Route 53 will do the following depending on the type of health check:

  • For health checks that check the health of endpoints, Route53 stops submitting requests to your application, server, or other resource.
  • For calculated health checks, Route 53 stops aggregating the status of the referenced health checks.
  • For health checks that monitor CloudWatch alarms, Route 53 stops monitoring the corresponding CloudWatch metrics.

Note: After you disable a health check, Route 53 considers the status of the health check to always be healthy. If you configured DNS failover, Route 53 continues to route traffic to the corresponding resources. If you want to stop routing traffic to a resource, change the value of invert_healthcheck.

enable_sni bool
A boolean value that indicates whether Route53 should send the fqdn to the endpoint when performing the health check. This defaults to AWS' defaults: when the type is "HTTPS" enable_sni defaults to true, when type is anything else enable_sni defaults to false.
failure_threshold int
The number of consecutive health checks that an endpoint must pass or fail.
fqdn str
The fully qualified domain name of the endpoint to be checked. If a value is set for ip_address, the value set for fqdn will be passed in the Host header.
insufficient_data_health_status str
The status of the health check when CloudWatch has insufficient data about the state of associated alarm. Valid values are Healthy , Unhealthy and LastKnownStatus.
invert_healthcheck bool
A boolean value that indicates whether the status of health check should be inverted. For example, if a health check is healthy but Inverted is True , then Route 53 considers the health check to be unhealthy.
ip_address str
The IP address of the endpoint to be checked.
measure_latency Changes to this property will trigger replacement. bool
A Boolean value that indicates whether you want Route 53 to measure the latency between health checkers in multiple AWS regions and your endpoint and to display CloudWatch latency graphs in the Route 53 console.
port int
The port of the endpoint to be checked.
reference_name Changes to this property will trigger replacement. str
This is a reference name used in Caller Reference (helpful for identifying single health_check set amongst others)
regions Sequence[str]
A list of AWS regions that you want Amazon Route 53 health checkers to check the specified endpoint from.
request_interval Changes to this property will trigger replacement. int
The number of seconds between the time that Amazon Route 53 gets a response from your endpoint and the time that it sends the next health-check request.
resource_path str
The path that you want Amazon Route 53 to request when performing health checks.
routing_control_arn Changes to this property will trigger replacement. str
The Amazon Resource Name (ARN) for the Route 53 Application Recovery Controller routing control. This is used when health check type is RECOVERY_CONTROL
search_string str
String searched in the first 5120 bytes of the response body for check to be considered healthy. Only valid with HTTP_STR_MATCH and HTTPS_STR_MATCH.
tags Mapping[str, str]
A map of tags to assign to the health check. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
triggers Mapping[str, str]
Map of arbitrary keys and values that, when changed, will trigger an in-place update of the CloudWatch alarm arguments. Use this argument to synchronize the health check when an alarm is changed. See example above.
type
This property is required.
Changes to this property will trigger replacement.
String
The protocol to use when performing health checks. Valid values are HTTP, HTTPS, HTTP_STR_MATCH, HTTPS_STR_MATCH, TCP, CALCULATED, CLOUDWATCH_METRIC and RECOVERY_CONTROL.
childHealthThreshold Number
The minimum number of child health checks that must be healthy for Route 53 to consider the parent health check to be healthy. Valid values are integers between 0 and 256, inclusive
childHealthchecks List<String>
For a specified parent health check, a list of HealthCheckId values for the associated child health checks.
cloudwatchAlarmName String
The name of the CloudWatch alarm.
cloudwatchAlarmRegion String
The region that the CloudWatch alarm was created in.
disabled Boolean

A boolean value that stops Route 53 from performing health checks. When set to true, Route 53 will do the following depending on the type of health check:

  • For health checks that check the health of endpoints, Route53 stops submitting requests to your application, server, or other resource.
  • For calculated health checks, Route 53 stops aggregating the status of the referenced health checks.
  • For health checks that monitor CloudWatch alarms, Route 53 stops monitoring the corresponding CloudWatch metrics.

Note: After you disable a health check, Route 53 considers the status of the health check to always be healthy. If you configured DNS failover, Route 53 continues to route traffic to the corresponding resources. If you want to stop routing traffic to a resource, change the value of invert_healthcheck.

enableSni Boolean
A boolean value that indicates whether Route53 should send the fqdn to the endpoint when performing the health check. This defaults to AWS' defaults: when the type is "HTTPS" enable_sni defaults to true, when type is anything else enable_sni defaults to false.
failureThreshold Number
The number of consecutive health checks that an endpoint must pass or fail.
fqdn String
The fully qualified domain name of the endpoint to be checked. If a value is set for ip_address, the value set for fqdn will be passed in the Host header.
insufficientDataHealthStatus String
The status of the health check when CloudWatch has insufficient data about the state of associated alarm. Valid values are Healthy , Unhealthy and LastKnownStatus.
invertHealthcheck Boolean
A boolean value that indicates whether the status of health check should be inverted. For example, if a health check is healthy but Inverted is True , then Route 53 considers the health check to be unhealthy.
ipAddress String
The IP address of the endpoint to be checked.
measureLatency Changes to this property will trigger replacement. Boolean
A Boolean value that indicates whether you want Route 53 to measure the latency between health checkers in multiple AWS regions and your endpoint and to display CloudWatch latency graphs in the Route 53 console.
port Number
The port of the endpoint to be checked.
referenceName Changes to this property will trigger replacement. String
This is a reference name used in Caller Reference (helpful for identifying single health_check set amongst others)
regions List<String>
A list of AWS regions that you want Amazon Route 53 health checkers to check the specified endpoint from.
requestInterval Changes to this property will trigger replacement. Number
The number of seconds between the time that Amazon Route 53 gets a response from your endpoint and the time that it sends the next health-check request.
resourcePath String
The path that you want Amazon Route 53 to request when performing health checks.
routingControlArn Changes to this property will trigger replacement. String
The Amazon Resource Name (ARN) for the Route 53 Application Recovery Controller routing control. This is used when health check type is RECOVERY_CONTROL
searchString String
String searched in the first 5120 bytes of the response body for check to be considered healthy. Only valid with HTTP_STR_MATCH and HTTPS_STR_MATCH.
tags Map<String>
A map of tags to assign to the health check. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
triggers Map<String>
Map of arbitrary keys and values that, when changed, will trigger an in-place update of the CloudWatch alarm arguments. Use this argument to synchronize the health check when an alarm is changed. See example above.

Outputs

All input properties are implicitly available as output properties. Additionally, the HealthCheck resource produces the following output properties:

Arn string
The Amazon Resource Name (ARN) of the Health Check.
Id string
The provider-assigned unique ID for this managed resource.
TagsAll Dictionary<string, string>
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

Arn string
The Amazon Resource Name (ARN) of the Health Check.
Id string
The provider-assigned unique ID for this managed resource.
TagsAll map[string]string
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

arn String
The Amazon Resource Name (ARN) of the Health Check.
id String
The provider-assigned unique ID for this managed resource.
tagsAll Map<String,String>
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

arn string
The Amazon Resource Name (ARN) of the Health Check.
id string
The provider-assigned unique ID for this managed resource.
tagsAll {[key: string]: string}
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

arn str
The Amazon Resource Name (ARN) of the Health Check.
id str
The provider-assigned unique ID for this managed resource.
tags_all Mapping[str, str]
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

arn String
The Amazon Resource Name (ARN) of the Health Check.
id String
The provider-assigned unique ID for this managed resource.
tagsAll Map<String>
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

Look up Existing HealthCheck Resource

Get an existing HealthCheck resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

public static get(name: string, id: Input<ID>, state?: HealthCheckState, opts?: CustomResourceOptions): HealthCheck
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        arn: Optional[str] = None,
        child_health_threshold: Optional[int] = None,
        child_healthchecks: Optional[Sequence[str]] = None,
        cloudwatch_alarm_name: Optional[str] = None,
        cloudwatch_alarm_region: Optional[str] = None,
        disabled: Optional[bool] = None,
        enable_sni: Optional[bool] = None,
        failure_threshold: Optional[int] = None,
        fqdn: Optional[str] = None,
        insufficient_data_health_status: Optional[str] = None,
        invert_healthcheck: Optional[bool] = None,
        ip_address: Optional[str] = None,
        measure_latency: Optional[bool] = None,
        port: Optional[int] = None,
        reference_name: Optional[str] = None,
        regions: Optional[Sequence[str]] = None,
        request_interval: Optional[int] = None,
        resource_path: Optional[str] = None,
        routing_control_arn: Optional[str] = None,
        search_string: Optional[str] = None,
        tags: Optional[Mapping[str, str]] = None,
        tags_all: Optional[Mapping[str, str]] = None,
        triggers: Optional[Mapping[str, str]] = None,
        type: Optional[str] = None) -> HealthCheck
func GetHealthCheck(ctx *Context, name string, id IDInput, state *HealthCheckState, opts ...ResourceOption) (*HealthCheck, error)
public static HealthCheck Get(string name, Input<string> id, HealthCheckState? state, CustomResourceOptions? opts = null)
public static HealthCheck get(String name, Output<String> id, HealthCheckState state, CustomResourceOptions options)
resources:  _:    type: aws:route53:HealthCheck    get:      id: ${id}
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
resource_name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
The following state arguments are supported:
Arn string
The Amazon Resource Name (ARN) of the Health Check.
ChildHealthThreshold int
The minimum number of child health checks that must be healthy for Route 53 to consider the parent health check to be healthy. Valid values are integers between 0 and 256, inclusive
ChildHealthchecks List<string>
For a specified parent health check, a list of HealthCheckId values for the associated child health checks.
CloudwatchAlarmName string
The name of the CloudWatch alarm.
CloudwatchAlarmRegion string
The region that the CloudWatch alarm was created in.
Disabled bool

A boolean value that stops Route 53 from performing health checks. When set to true, Route 53 will do the following depending on the type of health check:

  • For health checks that check the health of endpoints, Route53 stops submitting requests to your application, server, or other resource.
  • For calculated health checks, Route 53 stops aggregating the status of the referenced health checks.
  • For health checks that monitor CloudWatch alarms, Route 53 stops monitoring the corresponding CloudWatch metrics.

Note: After you disable a health check, Route 53 considers the status of the health check to always be healthy. If you configured DNS failover, Route 53 continues to route traffic to the corresponding resources. If you want to stop routing traffic to a resource, change the value of invert_healthcheck.

EnableSni bool
A boolean value that indicates whether Route53 should send the fqdn to the endpoint when performing the health check. This defaults to AWS' defaults: when the type is "HTTPS" enable_sni defaults to true, when type is anything else enable_sni defaults to false.
FailureThreshold int
The number of consecutive health checks that an endpoint must pass or fail.
Fqdn string
The fully qualified domain name of the endpoint to be checked. If a value is set for ip_address, the value set for fqdn will be passed in the Host header.
InsufficientDataHealthStatus string
The status of the health check when CloudWatch has insufficient data about the state of associated alarm. Valid values are Healthy , Unhealthy and LastKnownStatus.
InvertHealthcheck bool
A boolean value that indicates whether the status of health check should be inverted. For example, if a health check is healthy but Inverted is True , then Route 53 considers the health check to be unhealthy.
IpAddress string
The IP address of the endpoint to be checked.
MeasureLatency Changes to this property will trigger replacement. bool
A Boolean value that indicates whether you want Route 53 to measure the latency between health checkers in multiple AWS regions and your endpoint and to display CloudWatch latency graphs in the Route 53 console.
Port int
The port of the endpoint to be checked.
ReferenceName Changes to this property will trigger replacement. string
This is a reference name used in Caller Reference (helpful for identifying single health_check set amongst others)
Regions List<string>
A list of AWS regions that you want Amazon Route 53 health checkers to check the specified endpoint from.
RequestInterval Changes to this property will trigger replacement. int
The number of seconds between the time that Amazon Route 53 gets a response from your endpoint and the time that it sends the next health-check request.
ResourcePath string
The path that you want Amazon Route 53 to request when performing health checks.
RoutingControlArn Changes to this property will trigger replacement. string
The Amazon Resource Name (ARN) for the Route 53 Application Recovery Controller routing control. This is used when health check type is RECOVERY_CONTROL
SearchString string
String searched in the first 5120 bytes of the response body for check to be considered healthy. Only valid with HTTP_STR_MATCH and HTTPS_STR_MATCH.
Tags Dictionary<string, string>
A map of tags to assign to the health check. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
TagsAll Dictionary<string, string>
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

Triggers Dictionary<string, string>
Map of arbitrary keys and values that, when changed, will trigger an in-place update of the CloudWatch alarm arguments. Use this argument to synchronize the health check when an alarm is changed. See example above.
Type Changes to this property will trigger replacement. string
The protocol to use when performing health checks. Valid values are HTTP, HTTPS, HTTP_STR_MATCH, HTTPS_STR_MATCH, TCP, CALCULATED, CLOUDWATCH_METRIC and RECOVERY_CONTROL.
Arn string
The Amazon Resource Name (ARN) of the Health Check.
ChildHealthThreshold int
The minimum number of child health checks that must be healthy for Route 53 to consider the parent health check to be healthy. Valid values are integers between 0 and 256, inclusive
ChildHealthchecks []string
For a specified parent health check, a list of HealthCheckId values for the associated child health checks.
CloudwatchAlarmName string
The name of the CloudWatch alarm.
CloudwatchAlarmRegion string
The region that the CloudWatch alarm was created in.
Disabled bool

A boolean value that stops Route 53 from performing health checks. When set to true, Route 53 will do the following depending on the type of health check:

  • For health checks that check the health of endpoints, Route53 stops submitting requests to your application, server, or other resource.
  • For calculated health checks, Route 53 stops aggregating the status of the referenced health checks.
  • For health checks that monitor CloudWatch alarms, Route 53 stops monitoring the corresponding CloudWatch metrics.

Note: After you disable a health check, Route 53 considers the status of the health check to always be healthy. If you configured DNS failover, Route 53 continues to route traffic to the corresponding resources. If you want to stop routing traffic to a resource, change the value of invert_healthcheck.

EnableSni bool
A boolean value that indicates whether Route53 should send the fqdn to the endpoint when performing the health check. This defaults to AWS' defaults: when the type is "HTTPS" enable_sni defaults to true, when type is anything else enable_sni defaults to false.
FailureThreshold int
The number of consecutive health checks that an endpoint must pass or fail.
Fqdn string
The fully qualified domain name of the endpoint to be checked. If a value is set for ip_address, the value set for fqdn will be passed in the Host header.
InsufficientDataHealthStatus string
The status of the health check when CloudWatch has insufficient data about the state of associated alarm. Valid values are Healthy , Unhealthy and LastKnownStatus.
InvertHealthcheck bool
A boolean value that indicates whether the status of health check should be inverted. For example, if a health check is healthy but Inverted is True , then Route 53 considers the health check to be unhealthy.
IpAddress string
The IP address of the endpoint to be checked.
MeasureLatency Changes to this property will trigger replacement. bool
A Boolean value that indicates whether you want Route 53 to measure the latency between health checkers in multiple AWS regions and your endpoint and to display CloudWatch latency graphs in the Route 53 console.
Port int
The port of the endpoint to be checked.
ReferenceName Changes to this property will trigger replacement. string
This is a reference name used in Caller Reference (helpful for identifying single health_check set amongst others)
Regions []string
A list of AWS regions that you want Amazon Route 53 health checkers to check the specified endpoint from.
RequestInterval Changes to this property will trigger replacement. int
The number of seconds between the time that Amazon Route 53 gets a response from your endpoint and the time that it sends the next health-check request.
ResourcePath string
The path that you want Amazon Route 53 to request when performing health checks.
RoutingControlArn Changes to this property will trigger replacement. string
The Amazon Resource Name (ARN) for the Route 53 Application Recovery Controller routing control. This is used when health check type is RECOVERY_CONTROL
SearchString string
String searched in the first 5120 bytes of the response body for check to be considered healthy. Only valid with HTTP_STR_MATCH and HTTPS_STR_MATCH.
Tags map[string]string
A map of tags to assign to the health check. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
TagsAll map[string]string
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

Triggers map[string]string
Map of arbitrary keys and values that, when changed, will trigger an in-place update of the CloudWatch alarm arguments. Use this argument to synchronize the health check when an alarm is changed. See example above.
Type Changes to this property will trigger replacement. string
The protocol to use when performing health checks. Valid values are HTTP, HTTPS, HTTP_STR_MATCH, HTTPS_STR_MATCH, TCP, CALCULATED, CLOUDWATCH_METRIC and RECOVERY_CONTROL.
arn String
The Amazon Resource Name (ARN) of the Health Check.
childHealthThreshold Integer
The minimum number of child health checks that must be healthy for Route 53 to consider the parent health check to be healthy. Valid values are integers between 0 and 256, inclusive
childHealthchecks List<String>
For a specified parent health check, a list of HealthCheckId values for the associated child health checks.
cloudwatchAlarmName String
The name of the CloudWatch alarm.
cloudwatchAlarmRegion String
The region that the CloudWatch alarm was created in.
disabled Boolean

A boolean value that stops Route 53 from performing health checks. When set to true, Route 53 will do the following depending on the type of health check:

  • For health checks that check the health of endpoints, Route53 stops submitting requests to your application, server, or other resource.
  • For calculated health checks, Route 53 stops aggregating the status of the referenced health checks.
  • For health checks that monitor CloudWatch alarms, Route 53 stops monitoring the corresponding CloudWatch metrics.

Note: After you disable a health check, Route 53 considers the status of the health check to always be healthy. If you configured DNS failover, Route 53 continues to route traffic to the corresponding resources. If you want to stop routing traffic to a resource, change the value of invert_healthcheck.

enableSni Boolean
A boolean value that indicates whether Route53 should send the fqdn to the endpoint when performing the health check. This defaults to AWS' defaults: when the type is "HTTPS" enable_sni defaults to true, when type is anything else enable_sni defaults to false.
failureThreshold Integer
The number of consecutive health checks that an endpoint must pass or fail.
fqdn String
The fully qualified domain name of the endpoint to be checked. If a value is set for ip_address, the value set for fqdn will be passed in the Host header.
insufficientDataHealthStatus String
The status of the health check when CloudWatch has insufficient data about the state of associated alarm. Valid values are Healthy , Unhealthy and LastKnownStatus.
invertHealthcheck Boolean
A boolean value that indicates whether the status of health check should be inverted. For example, if a health check is healthy but Inverted is True , then Route 53 considers the health check to be unhealthy.
ipAddress String
The IP address of the endpoint to be checked.
measureLatency Changes to this property will trigger replacement. Boolean
A Boolean value that indicates whether you want Route 53 to measure the latency between health checkers in multiple AWS regions and your endpoint and to display CloudWatch latency graphs in the Route 53 console.
port Integer
The port of the endpoint to be checked.
referenceName Changes to this property will trigger replacement. String
This is a reference name used in Caller Reference (helpful for identifying single health_check set amongst others)
regions List<String>
A list of AWS regions that you want Amazon Route 53 health checkers to check the specified endpoint from.
requestInterval Changes to this property will trigger replacement. Integer
The number of seconds between the time that Amazon Route 53 gets a response from your endpoint and the time that it sends the next health-check request.
resourcePath String
The path that you want Amazon Route 53 to request when performing health checks.
routingControlArn Changes to this property will trigger replacement. String
The Amazon Resource Name (ARN) for the Route 53 Application Recovery Controller routing control. This is used when health check type is RECOVERY_CONTROL
searchString String
String searched in the first 5120 bytes of the response body for check to be considered healthy. Only valid with HTTP_STR_MATCH and HTTPS_STR_MATCH.
tags Map<String,String>
A map of tags to assign to the health check. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
tagsAll Map<String,String>
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

triggers Map<String,String>
Map of arbitrary keys and values that, when changed, will trigger an in-place update of the CloudWatch alarm arguments. Use this argument to synchronize the health check when an alarm is changed. See example above.
type Changes to this property will trigger replacement. String
The protocol to use when performing health checks. Valid values are HTTP, HTTPS, HTTP_STR_MATCH, HTTPS_STR_MATCH, TCP, CALCULATED, CLOUDWATCH_METRIC and RECOVERY_CONTROL.
arn string
The Amazon Resource Name (ARN) of the Health Check.
childHealthThreshold number
The minimum number of child health checks that must be healthy for Route 53 to consider the parent health check to be healthy. Valid values are integers between 0 and 256, inclusive
childHealthchecks string[]
For a specified parent health check, a list of HealthCheckId values for the associated child health checks.
cloudwatchAlarmName string
The name of the CloudWatch alarm.
cloudwatchAlarmRegion string
The region that the CloudWatch alarm was created in.
disabled boolean

A boolean value that stops Route 53 from performing health checks. When set to true, Route 53 will do the following depending on the type of health check:

  • For health checks that check the health of endpoints, Route53 stops submitting requests to your application, server, or other resource.
  • For calculated health checks, Route 53 stops aggregating the status of the referenced health checks.
  • For health checks that monitor CloudWatch alarms, Route 53 stops monitoring the corresponding CloudWatch metrics.

Note: After you disable a health check, Route 53 considers the status of the health check to always be healthy. If you configured DNS failover, Route 53 continues to route traffic to the corresponding resources. If you want to stop routing traffic to a resource, change the value of invert_healthcheck.

enableSni boolean
A boolean value that indicates whether Route53 should send the fqdn to the endpoint when performing the health check. This defaults to AWS' defaults: when the type is "HTTPS" enable_sni defaults to true, when type is anything else enable_sni defaults to false.
failureThreshold number
The number of consecutive health checks that an endpoint must pass or fail.
fqdn string
The fully qualified domain name of the endpoint to be checked. If a value is set for ip_address, the value set for fqdn will be passed in the Host header.
insufficientDataHealthStatus string
The status of the health check when CloudWatch has insufficient data about the state of associated alarm. Valid values are Healthy , Unhealthy and LastKnownStatus.
invertHealthcheck boolean
A boolean value that indicates whether the status of health check should be inverted. For example, if a health check is healthy but Inverted is True , then Route 53 considers the health check to be unhealthy.
ipAddress string
The IP address of the endpoint to be checked.
measureLatency Changes to this property will trigger replacement. boolean
A Boolean value that indicates whether you want Route 53 to measure the latency between health checkers in multiple AWS regions and your endpoint and to display CloudWatch latency graphs in the Route 53 console.
port number
The port of the endpoint to be checked.
referenceName Changes to this property will trigger replacement. string
This is a reference name used in Caller Reference (helpful for identifying single health_check set amongst others)
regions string[]
A list of AWS regions that you want Amazon Route 53 health checkers to check the specified endpoint from.
requestInterval Changes to this property will trigger replacement. number
The number of seconds between the time that Amazon Route 53 gets a response from your endpoint and the time that it sends the next health-check request.
resourcePath string
The path that you want Amazon Route 53 to request when performing health checks.
routingControlArn Changes to this property will trigger replacement. string
The Amazon Resource Name (ARN) for the Route 53 Application Recovery Controller routing control. This is used when health check type is RECOVERY_CONTROL
searchString string
String searched in the first 5120 bytes of the response body for check to be considered healthy. Only valid with HTTP_STR_MATCH and HTTPS_STR_MATCH.
tags {[key: string]: string}
A map of tags to assign to the health check. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
tagsAll {[key: string]: string}
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

triggers {[key: string]: string}
Map of arbitrary keys and values that, when changed, will trigger an in-place update of the CloudWatch alarm arguments. Use this argument to synchronize the health check when an alarm is changed. See example above.
type Changes to this property will trigger replacement. string
The protocol to use when performing health checks. Valid values are HTTP, HTTPS, HTTP_STR_MATCH, HTTPS_STR_MATCH, TCP, CALCULATED, CLOUDWATCH_METRIC and RECOVERY_CONTROL.
arn str
The Amazon Resource Name (ARN) of the Health Check.
child_health_threshold int
The minimum number of child health checks that must be healthy for Route 53 to consider the parent health check to be healthy. Valid values are integers between 0 and 256, inclusive
child_healthchecks Sequence[str]
For a specified parent health check, a list of HealthCheckId values for the associated child health checks.
cloudwatch_alarm_name str
The name of the CloudWatch alarm.
cloudwatch_alarm_region str
The region that the CloudWatch alarm was created in.
disabled bool

A boolean value that stops Route 53 from performing health checks. When set to true, Route 53 will do the following depending on the type of health check:

  • For health checks that check the health of endpoints, Route53 stops submitting requests to your application, server, or other resource.
  • For calculated health checks, Route 53 stops aggregating the status of the referenced health checks.
  • For health checks that monitor CloudWatch alarms, Route 53 stops monitoring the corresponding CloudWatch metrics.

Note: After you disable a health check, Route 53 considers the status of the health check to always be healthy. If you configured DNS failover, Route 53 continues to route traffic to the corresponding resources. If you want to stop routing traffic to a resource, change the value of invert_healthcheck.

enable_sni bool
A boolean value that indicates whether Route53 should send the fqdn to the endpoint when performing the health check. This defaults to AWS' defaults: when the type is "HTTPS" enable_sni defaults to true, when type is anything else enable_sni defaults to false.
failure_threshold int
The number of consecutive health checks that an endpoint must pass or fail.
fqdn str
The fully qualified domain name of the endpoint to be checked. If a value is set for ip_address, the value set for fqdn will be passed in the Host header.
insufficient_data_health_status str
The status of the health check when CloudWatch has insufficient data about the state of associated alarm. Valid values are Healthy , Unhealthy and LastKnownStatus.
invert_healthcheck bool
A boolean value that indicates whether the status of health check should be inverted. For example, if a health check is healthy but Inverted is True , then Route 53 considers the health check to be unhealthy.
ip_address str
The IP address of the endpoint to be checked.
measure_latency Changes to this property will trigger replacement. bool
A Boolean value that indicates whether you want Route 53 to measure the latency between health checkers in multiple AWS regions and your endpoint and to display CloudWatch latency graphs in the Route 53 console.
port int
The port of the endpoint to be checked.
reference_name Changes to this property will trigger replacement. str
This is a reference name used in Caller Reference (helpful for identifying single health_check set amongst others)
regions Sequence[str]
A list of AWS regions that you want Amazon Route 53 health checkers to check the specified endpoint from.
request_interval Changes to this property will trigger replacement. int
The number of seconds between the time that Amazon Route 53 gets a response from your endpoint and the time that it sends the next health-check request.
resource_path str
The path that you want Amazon Route 53 to request when performing health checks.
routing_control_arn Changes to this property will trigger replacement. str
The Amazon Resource Name (ARN) for the Route 53 Application Recovery Controller routing control. This is used when health check type is RECOVERY_CONTROL
search_string str
String searched in the first 5120 bytes of the response body for check to be considered healthy. Only valid with HTTP_STR_MATCH and HTTPS_STR_MATCH.
tags Mapping[str, str]
A map of tags to assign to the health check. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
tags_all Mapping[str, str]
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

triggers Mapping[str, str]
Map of arbitrary keys and values that, when changed, will trigger an in-place update of the CloudWatch alarm arguments. Use this argument to synchronize the health check when an alarm is changed. See example above.
type Changes to this property will trigger replacement. str
The protocol to use when performing health checks. Valid values are HTTP, HTTPS, HTTP_STR_MATCH, HTTPS_STR_MATCH, TCP, CALCULATED, CLOUDWATCH_METRIC and RECOVERY_CONTROL.
arn String
The Amazon Resource Name (ARN) of the Health Check.
childHealthThreshold Number
The minimum number of child health checks that must be healthy for Route 53 to consider the parent health check to be healthy. Valid values are integers between 0 and 256, inclusive
childHealthchecks List<String>
For a specified parent health check, a list of HealthCheckId values for the associated child health checks.
cloudwatchAlarmName String
The name of the CloudWatch alarm.
cloudwatchAlarmRegion String
The region that the CloudWatch alarm was created in.
disabled Boolean

A boolean value that stops Route 53 from performing health checks. When set to true, Route 53 will do the following depending on the type of health check:

  • For health checks that check the health of endpoints, Route53 stops submitting requests to your application, server, or other resource.
  • For calculated health checks, Route 53 stops aggregating the status of the referenced health checks.
  • For health checks that monitor CloudWatch alarms, Route 53 stops monitoring the corresponding CloudWatch metrics.

Note: After you disable a health check, Route 53 considers the status of the health check to always be healthy. If you configured DNS failover, Route 53 continues to route traffic to the corresponding resources. If you want to stop routing traffic to a resource, change the value of invert_healthcheck.

enableSni Boolean
A boolean value that indicates whether Route53 should send the fqdn to the endpoint when performing the health check. This defaults to AWS' defaults: when the type is "HTTPS" enable_sni defaults to true, when type is anything else enable_sni defaults to false.
failureThreshold Number
The number of consecutive health checks that an endpoint must pass or fail.
fqdn String
The fully qualified domain name of the endpoint to be checked. If a value is set for ip_address, the value set for fqdn will be passed in the Host header.
insufficientDataHealthStatus String
The status of the health check when CloudWatch has insufficient data about the state of associated alarm. Valid values are Healthy , Unhealthy and LastKnownStatus.
invertHealthcheck Boolean
A boolean value that indicates whether the status of health check should be inverted. For example, if a health check is healthy but Inverted is True , then Route 53 considers the health check to be unhealthy.
ipAddress String
The IP address of the endpoint to be checked.
measureLatency Changes to this property will trigger replacement. Boolean
A Boolean value that indicates whether you want Route 53 to measure the latency between health checkers in multiple AWS regions and your endpoint and to display CloudWatch latency graphs in the Route 53 console.
port Number
The port of the endpoint to be checked.
referenceName Changes to this property will trigger replacement. String
This is a reference name used in Caller Reference (helpful for identifying single health_check set amongst others)
regions List<String>
A list of AWS regions that you want Amazon Route 53 health checkers to check the specified endpoint from.
requestInterval Changes to this property will trigger replacement. Number
The number of seconds between the time that Amazon Route 53 gets a response from your endpoint and the time that it sends the next health-check request.
resourcePath String
The path that you want Amazon Route 53 to request when performing health checks.
routingControlArn Changes to this property will trigger replacement. String
The Amazon Resource Name (ARN) for the Route 53 Application Recovery Controller routing control. This is used when health check type is RECOVERY_CONTROL
searchString String
String searched in the first 5120 bytes of the response body for check to be considered healthy. Only valid with HTTP_STR_MATCH and HTTPS_STR_MATCH.
tags Map<String>
A map of tags to assign to the health check. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
tagsAll Map<String>
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

triggers Map<String>
Map of arbitrary keys and values that, when changed, will trigger an in-place update of the CloudWatch alarm arguments. Use this argument to synchronize the health check when an alarm is changed. See example above.
type Changes to this property will trigger replacement. String
The protocol to use when performing health checks. Valid values are HTTP, HTTPS, HTTP_STR_MATCH, HTTPS_STR_MATCH, TCP, CALCULATED, CLOUDWATCH_METRIC and RECOVERY_CONTROL.

Import

Using pulumi import, import Route53 Health Checks using the health check id. For example:

$ pulumi import aws:route53/healthCheck:HealthCheck http_check abcdef11-2222-3333-4444-555555fedcba
Copy

To learn more about importing existing cloud resources, see Importing resources.

Package Details

Repository
AWS Classic pulumi/pulumi-aws
License
Apache-2.0
Notes
This Pulumi package is based on the aws Terraform Provider.
AWS v6.76.0 published on Tuesday, Apr 8, 2025 by Pulumi
pulumi/pulumi-aws