DNS Zones

Get record health check

get/dns/zones/{zone_uuid}/records/{record_uuid}/health-check

View the health check attached to a DNS record, including its current status.

Autorización

Authorization

Authorization*string

Bearer YOUR_API_TOKEN con un token de API. También vale la cabecera X-API-Key: YOUR_API_TOKEN.

Parámetros de ruta

zone_uuid*string

record_uuid*string

Respuestas

Successful Response

application/json

uuid*string

record_uuid*string

name*string

check_type*DNSHealthCheckType

Valores"http""https""tcp""ping"

target?string | null

port?integer | null

path?string | null

expected_status?integer | null

interval_secs*integer

timeout_secs*integer

healthy_threshold*integer

unhealthy_threshold*integer

enabled*boolean

strict?boolean

If every server fails, do not answer: only healthy records are served (see the PUT).

Por defectofalse

last_status*DNSHealthCheckStatus

Valores"healthy""unhealthy""unknown"

last_check_at?string | null

Formatodate-time

created_at*string

Formatodate-time

updated_at*string

Formatodate-time

status_summary?DNSHealthCheckStatusSummary | null

Current status combined across every location; null while unavailable.

Propiedades (3)

status*string

healthy: every reporting location sees the target up; unhealthy: every one sees it down; degraded: some locations see it down; unknown: no location is reporting yet; paused: the check is disabled or the zone is not active.

Valores"healthy""degraded""unhealthy""unknown""paused"

pops?array<DNSHealthCheckPopStatus>

Propiedades (2)

pop*string

Location code, e.g. ams01

status*string

unhealthy when the location sees the target down, unknown while it is not reporting yet.

Valores"healthy""unhealthy""unknown""paused"

last_change_at?string | null

Last status change seen by any location (ISO 8601 UTC)

uptime_24h?number | null

Percentage of the last 24 hours the target was seen up; null without data.