Healthcheck

class Healthcheck : KotlinCustomResource

Example Usage

resources:
exampleHealthcheck:
type: cloudflare:Healthcheck
name: example_healthcheck
properties:
zoneId: 023e105f4ecef8ad9ca31a8372d0c353
address: www.example.com
name: server-1
checkRegions:
- WNAM
- ENAM
consecutiveFails: 0
consecutiveSuccesses: 0
description: Health check for www.example.com
httpConfig:
allow_insecure: true
expected_body: success
expected_codes:
- 2xx
- '302'
follow_redirects: true
header:
host:
- example.com
x-App-ID:
- abc123
method: GET
path: /health
port: 0
interval: 0
retries: 0
suspended: true
tcpConfig:
method: connection_established
port: 0
timeout: 0
type: HTTPS

Import

$ pulumi import cloudflare:index/healthcheck:Healthcheck example '<zone_id>/<healthcheck_id>'

Properties

Link copied to clipboard
val address: Output<String>

The hostname or IP address of the origin server to run health checks on.

Link copied to clipboard
val checkRegions: Output<List<String>>?

A list of regions from which to run health checks. Null means Cloudflare will pick a default region.

Link copied to clipboard
val consecutiveFails: Output<Int>

The number of consecutive fails required from a health check before changing the health to unhealthy.

Link copied to clipboard

The number of consecutive successes required from a health check before changing the health to healthy.

Link copied to clipboard
val createdOn: Output<String>
Link copied to clipboard
val description: Output<String>?

A human-readable description of the health check.

Link copied to clipboard
val failureReason: Output<String>

The current failure reason if status is unhealthy.

Link copied to clipboard

Parameters specific to an HTTP or HTTPS health check.

Link copied to clipboard
val id: Output<String>
Link copied to clipboard
val interval: Output<Int>

The interval between each health check. Shorter intervals may give quicker notifications if the origin status changes, but will increase load on the origin as we check from multiple locations.

Link copied to clipboard
val modifiedOn: Output<String>
Link copied to clipboard
val name: Output<String>

A short name to identify the health check. Only alphanumeric characters, hyphens and underscores are allowed.

Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
val retries: Output<Int>

The number of retries to attempt in case of a timeout before marking the origin as unhealthy. Retries are attempted immediately.

Link copied to clipboard
val status: Output<String>

The current status of the origin server according to the health check. Available values: "unknown", "healthy", "unhealthy", "suspended".

Link copied to clipboard
val suspended: Output<Boolean>

If suspended, no health checks are sent to the origin.

Link copied to clipboard

Parameters specific to TCP health check.

Link copied to clipboard
val timeout: Output<Int>

The timeout (in seconds) before marking the health check as failed.

Link copied to clipboard
val type: Output<String>

The protocol to use for the health check. Currently supported protocols are 'HTTP', 'HTTPS' and 'TCP'.

Link copied to clipboard
val urn: Output<String>
Link copied to clipboard
val zoneId: Output<String>

Identifier