/v1/api/list/system/information/{listName} - BlueCat DNS Edge

DNS Edge User Guide

prodname
BlueCat DNS Edge
Returns the specifed system-maintained domain list meta information, including:
  • TTL: The number of seconds after which a domain will be curated from the list from the time when it was last observed to incur suspect activity.
  • Count: The total number of domains in the list.
  • Last updated: The last time an update affected the contents of the list, for example a new domain being added, an existing domain being removed, or an existing domain being observed causing suspect DNS activity.
Request: GET https://api-<DNS.Edge.URL>/v1/api/list/system/information/tunneling
Authorization: Bearer token
Content-type: application/JSON

Parameter

The only currently acceptable value for the listName is tunneling, which will return the content of the system-maintained tunneling quarantine list.

Successful response

200 OK
Content-Type: application/JSON
{
   "listName": "tunneling",
   "ttl": 15552000,
   "count": 23,
   "lastUpdated": "2018-01-21 02:00:00"
}
Possible error codes
  • 500 Internal server error - ERROR_RETRIEVING_SYSTEMLIST_CONTENT: Failed to retrieve the system list content