GET /service/api/console/gsm/{gsmKey}/sites/{siteId}/dnsp/blockedtraffic
 ?startDate={startDate}
 &endDate={endDate}
 &pageSize={pageSize}
 &pageNr={pageNr}

Returns information about DNS requests that were blocked by the DNS Protection service.

NOTE: The maximum allowed time difference between 'startDate' and 'endDate' is 30 days.
WARNING: The maximum number of returned traffic records is limited to ensure that requests can complete in reasonable time. The amount of data accumulating over an increasing timespan can become very large, reaching into the millions of records for the maximum allowed time interval of 30 days. When querying blocked traffic for high-use sites, it is advised to query more regularly for shorter periods of time, instead of trying to pull the entire data once per month only.

Request Information

URI Parameters

NameDescriptionTypeAdditional Information
gsmKey

The GSM console keycode.

string

Required

siteId

The site identifier.

string

Required

startDate

If specified, returns blocked requests after (or at) the given date. If omitted, defaults to 'endDate' minus 24 hours.

date

None.

endDate

If specified, returns blocked 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/C7B8-BA92-AEAD-4C68-902E/sites/0b4a4019-6555-420c-beed-8a3502f3a7b7/dnsp/blockedtraffic?startDate=2024-02-27T04:38:40.9414177Z&endDate=2024-03-28T04:38:40.9414177Z&pageSize=100&pageNr=33

Body Parameters

None.

Response Information

Resource Description

Information about DNS requests that were blocked by the DNS Protection service.

GetDNSPBlockedTrafficResponseModel
NameDescriptionTypeAdditional Information
MoreAvailable

Value indicating whether more records are available in the queried time window. Increment the page number in the query to obtain additional blocked 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.

BlockedRequests

The list of blocked request records.

Collection of GetDNSPBlockedTrafficResponseModel_DNSRequest

None.

Sample Response

{
  "MoreAvailable": false,
  "PageNr": 1,
  "PageSize": 1000,
  "StartDate": "2024-03-27T08:44:08.6909543Z",
  "EndDate": "2024-03-28T08:44:08.6909543Z",
  "SiteId": "f915b099-141d-452a-92c9-e4167018a0b8",
  "SiteName": "Site 1",
  "BlockedRequests": [
    {
      "Timestamp": "2024-03-28T08:43:08.6909543Z",
      "HostName": "MyComputer1",
      "UserName": "User1",
      "AgentVersion": "1.2.1.28",
      "SourceIp": "95.247.36.51",
      "Domain": "www.blocked-domain1.com",
      "DomainIps": [
        "95.236.171.244",
        "95.179.97.33"
      ],
      "CategoryIds": [
        50,
        57
      ],
      "BlockReasonId": 1
    },
    {
      "Timestamp": "2024-03-28T08:42:08.6909543Z",
      "HostName": "MyComputer2",
      "UserName": "User2",
      "AgentVersion": "1.2.1.28",
      "SourceIp": "95.153.36.90",
      "Domain": "www.blocked-domain2.com",
      "DomainIps": [
        "95.139.219.214",
        "95.13.223.200"
      ],
      "CategoryIds": [
        51,
        58
      ],
      "BlockReasonId": 2
    }
  ]
}                    
<GetDNSPBlockedTrafficResponseModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.Console.Models">
  <BlockedRequests>
    <GetDNSPBlockedTrafficResponseModel_DNSRequest>
      <AgentVersion>1.2.1.28</AgentVersion>
      <BlockReasonId>1</BlockReasonId>
      <CategoryIds xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:int>50</d4p1:int>
        <d4p1:int>57</d4p1:int>
      </CategoryIds>
      <Domain>www.blocked-domain1.com</Domain>
      <DomainIps xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:string>95.236.171.244</d4p1:string>
        <d4p1:string>95.179.97.33</d4p1:string>
      </DomainIps>
      <HostName>MyComputer1</HostName>
      <SourceIp>95.247.36.51</SourceIp>
      <Timestamp>2024-03-28T08:43:08.6909543Z</Timestamp>
      <UserName>User1</UserName>
    </GetDNSPBlockedTrafficResponseModel_DNSRequest>
    <GetDNSPBlockedTrafficResponseModel_DNSRequest>
      <AgentVersion>1.2.1.28</AgentVersion>
      <BlockReasonId>2</BlockReasonId>
      <CategoryIds xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:int>51</d4p1:int>
        <d4p1:int>58</d4p1:int>
      </CategoryIds>
      <Domain>www.blocked-domain2.com</Domain>
      <DomainIps xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:string>95.139.219.214</d4p1:string>
        <d4p1:string>95.13.223.200</d4p1:string>
      </DomainIps>
      <HostName>MyComputer2</HostName>
      <SourceIp>95.153.36.90</SourceIp>
      <Timestamp>2024-03-28T08:42:08.6909543Z</Timestamp>
      <UserName>User2</UserName>
    </GetDNSPBlockedTrafficResponseModel_DNSRequest>
  </BlockedRequests>
  <EndDate>2024-03-28T08:44:08.6909543Z</EndDate>
  <MoreAvailable>false</MoreAvailable>
  <PageNr>1</PageNr>
  <PageSize>1000</PageSize>
  <SiteId>f915b099-141d-452a-92c9-e4167018a0b8</SiteId>
  <SiteName>Site 1</SiteName>
  <StartDate>2024-03-27T08:44:08.6909543Z</StartDate>
</GetDNSPBlockedTrafficResponseModel>