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

DNS Edge User Guide

prodname
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