/v1/api/customer/dnsQueryStats/topDomains - BlueCat DNS Edge

DNS Edge User Guide

prodname
BlueCat DNS Edge

Returns the specified number of domains most frequently queried per Customer Instance for any time interval within the last 24 hours (for example, the top 5 domains queried during the past 20 hours).

GET https://api-<DNS.Edge.URL>/v1/api/customer/dnsQueryStats/topDomains?start=startTime&
end=endTime&count=numberOfDomains

Parameters

Name Description Type Required
start The start of the time range, in milliseconds since the Unix Epoch. Integer Required
end The end of the time range, in milliseconds since the Unix Epoch. Integer Optional
count The number of domains to return (for example, the top 5). Integer Required

Successful response

200 — OK
[
  {
    "domain": "domainName",
    "hitcount": hitcount
  },
  {
    "domain": "domainName",
    "hitcount": hitcount
  },
  ...
]

Response on unsuccessful authorization

401 Unauthorized
Content-Type: application/JSON
{"code": "UNAUTHORIZED", "brief": "You are not authorized to perform this action"}
Possible error codes
  • UNEXPECTED_ERROR
Note: If the interval defined by the start and end times spans beyond the last 24 hours, the results that are returned only include data that falls within the last 24 hours.
For example, if you specify the following:
  • Start time: August 27th at 17:00
  • End time: August 28th at 13:00

And the current date and time is August 29th at 12:00, then the returned results will only include data for the one hour between August 28th 12:00 and August 28th 13:00.