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. Traffic information can be queried for a defined subset of available DNS Protection categories. Please refer to the description of the categories field in the API specification for a complete list of supported 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. Traffic can be queried for the following DNS Protection categories:
|
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/503B-5930-B55B-4BD4-96D0/sites/c39cf5ba-3c61-4902-a8c0-bbd04abbb5a7/dnsp/trafficbycategory?categories=81,55,25&startDate=2020-01-23T21:12:35.0687806Z&endDate=2020-02-22T21:12:35.0687806Z&pageSize=100&pageNr=24
|
Body Parameters
None.
Response Information
Resource Description
Information about DNS requests for a set of DNS Protection categories.
GetDNSPTrafficByCategoryResponseModel| Name | 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": "2020-02-22T11:00:23.1005876Z",
"EndDate": "2020-02-23T11:00:23.1005876Z",
"SiteId": "688cbf5b-2f5d-4697-bfbf-f4288e87fe9c",
"SiteName": "Site 1",
"Requests": [
{
"Timestamp": "2020-02-23T10:59:23.1005876Z",
"HostName": "MyComputer1",
"UserName": "User1",
"AgentVersion": "1.3.0.197",
"SourceIp": "95.218.56.176",
"Domain": "www.category-domain1.com",
"DomainIps": [
"95.128.186.82",
"95.170.40.203"
],
"CategoryIds": [
34,
42
],
"ActionTaken": 0
},
{
"Timestamp": "2020-02-23T10:58:23.1005876Z",
"HostName": "MyComputer2",
"UserName": "User2",
"AgentVersion": "1.3.0.197",
"SourceIp": "95.226.101.169",
"Domain": "www.category-domain2.com",
"DomainIps": [
"95.18.115.104",
"95.84.96.148"
],
"CategoryIds": [
7,
81
],
"ActionTaken": 2
}
]
}
<GetDNSPTrafficByCategoryResponseModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.Console.Models">
<EndDate>2020-02-23T11:00:23.1005876Z</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.128.186.82</d4p1:string>
<d4p1:string>95.170.40.203</d4p1:string>
</DomainIps>
<HostName>MyComputer1</HostName>
<SourceIp>95.218.56.176</SourceIp>
<Timestamp>2020-02-23T10:59:23.1005876Z</Timestamp>
<UserName>User1</UserName>
</GetDNSPTrafficByCategoryResponseModel_DNSRequest>
<GetDNSPTrafficByCategoryResponseModel_DNSRequest>
<ActionTaken>2</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.18.115.104</d4p1:string>
<d4p1:string>95.84.96.148</d4p1:string>
</DomainIps>
<HostName>MyComputer2</HostName>
<SourceIp>95.226.101.169</SourceIp>
<Timestamp>2020-02-23T10:58:23.1005876Z</Timestamp>
<UserName>User2</UserName>
</GetDNSPTrafficByCategoryResponseModel_DNSRequest>
</Requests>
<SiteId>688cbf5b-2f5d-4697-bfbf-f4288e87fe9c</SiteId>
<SiteName>Site 1</SiteName>
<StartDate>2020-02-22T11:00:23.1005876Z</StartDate>
</GetDNSPTrafficByCategoryResponseModel>