Documentation

GET /service/api/console/gsm/{gsmKey}/dnsp/trafficsummary/categoryreport
?startDate={startDate}
&endDate={endDate}

Returns a traffic summary (e.g. the number of total DNS requests, blocked DNS requests, and allowed DNS requests) grouped by categories for a given GSM.

NOTE: The maximum allowed time difference between 'startDate' and 'endDate' is 30 days.

Request Information

URI Parameters

Name	Description	Type	Additional Information
gsmKey	The GSM console keycode.	string	Required
startDate	If specified, returns DNS traffic summary after (or at) the given date. If omitted, defaults to 'endDate' minus 24 hours.	date	None.
endDate	If specified, returns DNS traffic summary before (or at) the given date. If omitted, defaults to the current date and time.	date	None.

URI Sample(s)

GET	https://unityapi.webrootcloudav.com/service/api/console/gsm/9785-C02E-17E4-4CE6-A0E3/dnsp/trafficsummary/categoryreport?startDate=2024-08-08T18:58:18.7362399Z&endDate=2024-09-07T18:58:18.7362399Z

Body Parameters

None.

Response Information

Resource Description

Traffic summary category report for a given GSM console.

GetDNSPTrafficCategorySummaryResponseModel

Name	Description	Type	Additional Information
StartDate	Start date for returned records. Traffic summary records after (or at) this date are contained in the response.	date	None.
EndDate	End date for returned records. Traffic summary records before (or at) this date are contained in the response.	date	None.
Records	A list of DNSP traffic records.	Collection of GetDNSPTrafficCategorySummaryResponseModelRecord	None.

Sample Response

{
  "StartDate": "2024-09-07T03:07:57.2207453Z",
  "EndDate": "2024-09-08T03:07:57.2207453Z",
  "Records": [
    {
      "CategoryId": 2,
      "DNSRequests": 12927,
      "AllowedDNSRequests": 9042,
      "BlockedDNSRequests": 3885
    },
    {
      "CategoryId": 3,
      "DNSRequests": 10441,
      "AllowedDNSRequests": 7913,
      "BlockedDNSRequests": 2528
    }
  ]
}

<GetDNSPTrafficCategorySummaryResponseModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.Console.Models.DNSProtection">
  <EndDate>2024-09-08T03:07:57.2207453Z</EndDate>
  <Records>
    <GetDNSPTrafficCategorySummaryResponseModelRecord>
      <AllowedDNSRequests>9042</AllowedDNSRequests>
      <BlockedDNSRequests>3885</BlockedDNSRequests>
      <CategoryId>2</CategoryId>
      <DNSRequests>12927</DNSRequests>
    </GetDNSPTrafficCategorySummaryResponseModelRecord>
    <GetDNSPTrafficCategorySummaryResponseModelRecord>
      <AllowedDNSRequests>7913</AllowedDNSRequests>
      <BlockedDNSRequests>2528</BlockedDNSRequests>
      <CategoryId>3</CategoryId>
      <DNSRequests>10441</DNSRequests>
    </GetDNSPTrafficCategorySummaryResponseModelRecord>
  </Records>
  <StartDate>2024-09-07T03:07:57.2207453Z</StartDate>
</GetDNSPTrafficCategorySummaryResponseModel>

GET /service/api/console/gsm/{gsmKey}/dnsp/trafficsummary/categoryreport ?startDate={startDate} &endDate={endDate}