GET /service/api/console/gsm/{gsmKey}/sites/{siteId}/dnsp/trafficbycategory
?categories={categories}
&startDate={startDate}
&endDate={endDate}
&pageSize={pageSize}
&pageNr={pageNr}
Returns information about DNS requests that were seen by the DNS Protection service for one or more specified categories.
Request Information
URI Parameters
Name | Description | Type | Additional Information |
---|---|---|---|
gsmKey |
The GSM console keycode. |
string |
Required |
siteId |
The site identifier. |
string |
Required |
categories |
A comma separated list of one or more DNS Protection category identifiers (e.g. 14,47,81). This query parameter is mandatory. Call 'get categories' to get a list of available DNS Protection categories and their respective identifiers. |
string |
Required |
startDate |
If specified, returns requests after (or at) the given date. If omitted, defaults to 'endDate' minus 24 hours. |
date |
None. |
endDate |
If specified, returns requests before (or at) the given date. If omitted, defaults to the current date and time. |
date |
None. |
pageSize |
Specifies the maximum number of records to return. Valid values are between 100 and 10000. |
integer |
Default value is 1000 |
pageNr |
Specifies the page number. Can be used to retrieve the next batch of records. |
integer |
Default value is 1 |
URI Sample(s)
GET
|
https://unityapi.webrootcloudav.com/service/api/console/gsm/9AB1-C49D-4E88-438B-95D4/sites/a036fda0-8c63-4ce3-88d1-b4adfb73ab33/dnsp/trafficbycategory?categories=3,34,25&startDate=2024-03-18T17:37:22.3371343Z&endDate=2024-04-17T17:37:22.3371343Z&pageSize=100&pageNr=46
|
Body Parameters
None.
Response Information
Resource Description
Information about DNS requests for a set of DNS Protection categories.
GetDNSPTrafficByCategoryResponseModelName | Description | Type | Additional Information |
---|---|---|---|
MoreAvailable |
Value indicating whether more records are available in the queried time window. Increment the page number in the query to obtain additional request records. |
boolean |
None. |
PageNr |
The number of the page that was requested. |
integer |
None. |
PageSize |
The size of the page that was requested. |
integer |
None. |
StartDate |
The start date that was used for the data query. |
date |
None. |
EndDate |
The end date that was used for the data query. |
date |
None. |
SiteId |
The identifier of the GSM site traffic information was queried for. |
string |
None. |
SiteName |
The name of the GSM site traffic information was queried for. |
string |
None. |
Requests |
The list of request records. |
Collection of GetDNSPTrafficByCategoryResponseModel_DNSRequest |
None. |
Sample Response
{ "MoreAvailable": false, "PageNr": 1, "PageSize": 1000, "StartDate": "2024-04-16T18:31:08.3974054Z", "EndDate": "2024-04-17T18:31:08.3974054Z", "SiteId": "3de829c5-54ea-4f77-8b20-79be011b8bee", "SiteName": "Site 1", "Requests": [ { "Timestamp": "2024-04-17T18:30:08.3974054Z", "HostName": "MyComputer1", "UserName": "User1", "AgentVersion": "1.3.0.197", "SourceIp": "95.159.145.192", "Domain": "www.category-domain1.com", "DomainIps": [ "95.9.249.165", "95.235.12.93" ], "CategoryIds": [ 34, 42 ], "ActionTaken": 0 }, { "Timestamp": "2024-04-17T18:29:08.3974054Z", "HostName": "MyComputer2", "UserName": "User2", "AgentVersion": "1.3.0.197", "SourceIp": "95.227.200.28", "Domain": "www.category-domain2.com", "DomainIps": [ "95.249.113.117", "95.118.152.86" ], "CategoryIds": [ 7, 81 ], "ActionTaken": 1 } ] }
<GetDNSPTrafficByCategoryResponseModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.Console.Models"> <EndDate>2024-04-17T18:31:08.3974054Z</EndDate> <MoreAvailable>false</MoreAvailable> <PageNr>1</PageNr> <PageSize>1000</PageSize> <Requests> <GetDNSPTrafficByCategoryResponseModel_DNSRequest> <ActionTaken>0</ActionTaken> <AgentVersion>1.3.0.197</AgentVersion> <CategoryIds xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d4p1:int>34</d4p1:int> <d4p1:int>42</d4p1:int> </CategoryIds> <Domain>www.category-domain1.com</Domain> <DomainIps xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d4p1:string>95.9.249.165</d4p1:string> <d4p1:string>95.235.12.93</d4p1:string> </DomainIps> <HostName>MyComputer1</HostName> <SourceIp>95.159.145.192</SourceIp> <Timestamp>2024-04-17T18:30:08.3974054Z</Timestamp> <UserName>User1</UserName> </GetDNSPTrafficByCategoryResponseModel_DNSRequest> <GetDNSPTrafficByCategoryResponseModel_DNSRequest> <ActionTaken>1</ActionTaken> <AgentVersion>1.3.0.197</AgentVersion> <CategoryIds xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d4p1:int>7</d4p1:int> <d4p1:int>81</d4p1:int> </CategoryIds> <Domain>www.category-domain2.com</Domain> <DomainIps xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d4p1:string>95.249.113.117</d4p1:string> <d4p1:string>95.118.152.86</d4p1:string> </DomainIps> <HostName>MyComputer2</HostName> <SourceIp>95.227.200.28</SourceIp> <Timestamp>2024-04-17T18:29:08.3974054Z</Timestamp> <UserName>User2</UserName> </GetDNSPTrafficByCategoryResponseModel_DNSRequest> </Requests> <SiteId>3de829c5-54ea-4f77-8b20-79be011b8bee</SiteId> <SiteName>Site 1</SiteName> <StartDate>2024-04-16T18:31:08.3974054Z</StartDate> </GetDNSPTrafficByCategoryResponseModel>