Skip to main content

Get DNS requests sent by user

Introduction

An endpoint to retrieve DNS resolutions that were performed by the user. The reply is aggregated within an hour interval. Has pagination and page size for paginated data retrieval.

For example:

GET /api/beta/dns-log/user-dns-resolutions/page?startHour=2024-11-08T14:00:00Z&hoursBack=1&page=1&size=1000

{
    "content": [
        {
            "time": 1731412800000,
            "domain": "connectivity-check.ubuntu.com",
            "memberId": "memberId@tenant",
            "internalDomain": false,
            "allowedCount": 23,
            "blockedCount": 0,
            "failedCount": 0
        },
        {
            "time": 1731416400000,
            "domain": "reddit.com",
            "memberId": "memberId@tenant",
            "internalDomain": false,
            "allowedCount": 2,
            "blockedCount": 0,
            "failedCount": 0
        }
    ],
    "totalElements": 2,
    "totalPages": 1,
    "numberOfElements": 2,
    "page": 1,
    "size": 1000
}

Parameters

Name	In	Type	Required	Description
startHour	query	string(date-time)	true	A String date-time, according to ISO 8601 in UTC timezone, of an hour to start collecting data from. Value is rounded to the past hour if more granular value is provided. Max 30 days of history available. If value is before (now - 30 days), an error will be returned. Should use `ISO_INSTANT` format, e.g. `2024-11-08T14:00:00Z`.
page	query	string	true	page
size	query	string	true	size

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline
400	Bad Request	Bad Request	None
401	Unauthorized	Unauthorized	None
403	Forbidden	Access Forbidden	None
404	Not Found	Not Found	None
406	Not Acceptable	Not Acceptable	None
429	Too Many Requests	Too Many Requests	None
500	Internal Server Error	Internal Server Error	None

To perform this operation, you must be authenticated by means of one of the following methods: OAuth_authorization

{
  "content": [
    {
      "allowedCount": 0,
      "blockedCount": 0,
      "domain": "string",
      "failedCount": 0,
      "internalDomain": true,
      "memberId": "string",
      "time": 0
    }
  ],
  "numberOfElements": 0,
  "page": 0,
  "size": 0,
  "success": true,
  "totalElements": 0,
  "totalPages": 0
}

In this section:

Was this helpful?