/v1/api/statistics/dnsQueryLatencyPercentiles/sites/{siteId} (GET) - BlueCat DNS Edge

DNS Edge API Guide

Locale
English (United States)
Product name
BlueCat DNS Edge

Returns the DNS query latency percentiles (in milliseconds) in 10 minute intervals over the last 24 hours for a given site. Returns null if data for the site ID does not exist.

GET https://api-<DNS.Edge.URL>/v1/api/statistics/dnsQueryLatencyPercentiles/sites/{siteId}
Authorization: Bearer authorization token

Parameters

Name Description Type Required
siteId The ID of the site. String Required

Successful response

200 OK
Content-type: application/JSON

Cache-Control: no-cache
Last-Modified: <day-name>, <day> <month> <year> <hour>:<minute>:<second> GMT

{
      "time": [
        1587486920017,
        1590690607000
      ],
      "p99": [
        1.1,
        2.3
      ],
      "p95": [
        1.1,
        2.3
      ],
      "p75": [
        1.1,
        2.3 
      ],
      "p50": [
        1.1,
        2.3
      ],
      "p25": [
        1.1,
        2.3
      ],
      "p05": [
        1.1,
        2.3
      ],
      "p01": [
        1.1,
        2.3
      ]
}
Returns the following information:
  • Cache-Control: The instructions for caching the response. The value of no-cache means the response may be stored by any cache.
  • Last-Modified: The date and time the DNS query latency percentiles were calculated. If the DNS query latency percentile is null, the date and time the response was created.
  • The DNS query latency percentiles (in milliseconds) in 10 minute intervals over the last 24 hours. The following percentiles are returned: p1, p5, p25, p50, p75, p95, and p99.

Response on unsuccessful authorization

401 Unauthorized
Content-Type: application/JSON
{"code": "UNAUTHORIZED", "brief": "You are not authorized to perform this action"}
Possible error codes
  • BAD_REQUEST
  • INTERNAL_SERVER_ERROR