DNS Zones

Get record health check history

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

See how a record's health check has behaved over time: uptime, the status seen from each location and the incidents per location with their duration. How far back you can look depends on the zone's DNS plan.

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

Parámetros de consulta

time_range?string

Period to show. Longer than your plan's history retention returns the longest period available, with clamped set to true.

Por defecto"24h"Valores"24h""7d""30d""90d"

Respuestas

Successful Response

application/json

check_uuid*string

time_range*string

Valores"24h""7d""30d""90d"

retention_days*integer

clamped*boolean

history_starts_at?string | null

start*string

end*string

bucket_secs*integer

overall*DNSHealthCheckHistoryOverall

Propiedades (5)

status*string

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

uptime_pct?number | null

coverage_pct?number | null

outage_secs?integer

Por defecto0

last_change_at?string | null

pops*array<DNSHealthCheckHistoryPop>

Propiedades (6)

pop*string

region?string | null

status*string

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

uptime_pct?number | null

last_error_kind?string | null

last_change_at?string | null

buckets*array<DNSHealthCheckHistoryBucket>

Propiedades (4)

start*string

uptime_pct?number | null

coverage_pct?number | null

state*string

Valores"ok""degraded""outage""no_data""paused"

pop_buckets*record<string, array<DNSHealthCheckHistoryBucket>>

markers*array<DNSHealthCheckHistoryMarker>

Propiedades (2)

ts*string

kind*string

Valores"config_changed""disabled""enabled"

incidents*array<DNSHealthCheckHistoryIncident>

Propiedades (6)

pop*string

started_at*string

resolved_at?string | null

duration_secs?integer | null

error_kind?string | null

http_status?integer | null

Status code received, only for http_status_mismatch.