/v1/api/customer/dnsQueryStats/count - BlueCat Edge - Service Point v4.x.x

BlueCat Edge User Guide

Locale
English
Product name
BlueCat Edge
Version
Service Point v4.x.x

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

GET https://api-<BlueCat.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.