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

DNS Edge API Guide

Locale
English (United States)
Product name
BlueCat DNS Edge

Returns the total count of logged DNS queries per policy action type in a Customer Instance for any time interval within the last 24 hours.

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

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
downsample The sample period in the returned dataset, in minutes. Integer Required

Successful response

200 — OK
[
  {
    "time": 1587060300332,
    "totalQueries": 123456,
    "totalBlocked": 123456,
    "totalAllowed": 123456,
    "totalMonitored": 123456,
    "totalRedirected": 123456,
    "totalNonMatched": 5000
  },
  {
    "time": 1587060452332,
    "totalQueries": 123456,
    "totalBlocked": 123456,
    "totalAllowed": 123456,
    "totalMonitored": 123456,
    "totalRedirected": 123456,
    "totalNonMatched": 5000
  }
  ...
]

Response on unsuccessful authorization

401 Unauthorized
Content-Type: application/JSON
{"code": "UNAUTHORIZED", "brief": "You are not authorized to perform this action"}
Possible error codes
  • CANNOT_GET_SITES
  • 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.