GET /service/api/console/gsm/{gsmKey}/dnsp/trafficsummary
?startDate={startDate}
&endDate={endDate}
Returns a traffic summary (e.g. the number of total DNS requests, blocked DNS requests, and risky DNS requests) for each site under 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/4461-E52D-AE61-42AD-9046/dnsp/trafficsummary?startDate=2024-09-29T15:29:20.8209123Z&endDate=2024-10-29T15:29:20.8209123Z
|
Body Parameters
None.
Response Information
Resource Description
Traffic summary information for GSM sites.
GetDNSPTrafficSummaryResponseModelName | 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. |
Sites |
The list of sites. |
Collection of GetDNSPTrafficSummaryResponseModel_Site |
None. |
Sample Response
{ "StartDate": "2024-10-28T23:23:06.4184339Z", "EndDate": "2024-10-29T23:23:06.4184339Z", "Sites": [ { "SiteId": "bd910ca5-9fce-4ddc-bae6-99d686b1fa15", "SiteName": "Site 1", "DNSRequests": 10076, "BlockedDNSRequests": 143, "RiskyDNSRequests": 176 }, { "SiteId": "b8946096-9e67-4575-85c0-60778cc03070", "SiteName": "Site 2", "DNSRequests": 10571, "BlockedDNSRequests": 131, "RiskyDNSRequests": 182 } ] }
<GetDNSPTrafficSummaryResponseModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.Console.Models"> <EndDate>2024-10-29T23:23:06.4184339Z</EndDate> <Sites> <GetDNSPTrafficSummaryResponseModel_Site> <BlockedDNSRequests>143</BlockedDNSRequests> <DNSRequests>10076</DNSRequests> <RiskyDNSRequests>176</RiskyDNSRequests> <SiteId>bd910ca5-9fce-4ddc-bae6-99d686b1fa15</SiteId> <SiteName>Site 1</SiteName> </GetDNSPTrafficSummaryResponseModel_Site> <GetDNSPTrafficSummaryResponseModel_Site> <BlockedDNSRequests>131</BlockedDNSRequests> <DNSRequests>10571</DNSRequests> <RiskyDNSRequests>182</RiskyDNSRequests> <SiteId>b8946096-9e67-4575-85c0-60778cc03070</SiteId> <SiteName>Site 2</SiteName> </GetDNSPTrafficSummaryResponseModel_Site> </Sites> <StartDate>2024-10-28T23:23:06.4184339Z</StartDate> </GetDNSPTrafficSummaryResponseModel>