Get DNS requests sent by user.

GET /api/v1/dns-log/user-dns-resolutions/page

This endpoint retrieves DNS resolutions performed by a user, aggregated within an hourly interval. Results support pagination and configurable page sizes for efficient data retrieval.

Example Request:

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

Example Response:

{
     "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": 0,
     "size": 1000
 }

Parameters

Name	In	Type	Required	Description
startHour	query	string(date-time)	true	(Type: String) (Mandatory) A String date-time, according to ISO 8601 in UTC timezone, of an hour to start collecting data from.
hoursBack	query	string(date-time)	false	(Type: Integer) (Optional, def value: 1, min: 1, max: 2) The amount of hours back to retrieve the information for.
page	query	string(date-time)	false	(Type: Integer) (Optional, def value: 0, min: 0)A page number to retrieve the data for.
size	query	string(date-time)	false	(Type: Integer) (Optional, def value: 500, min: 10, max: 10000) The number of records per page

Detailed descriptions

startHour: (Type: String) (Mandatory) 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 provided Notes: * 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.

hoursBack: (Type: Integer) (Optional, def value: 1, min: 1, max: 2) The amount of hours back to retrieve the information for. Notes: * Has to be more than 1 and less than 2.

page: (Type: Integer) (Optional, def value: 0, min: 0)A page number to retrieve the data for. Number of items per page is passed as size parameter. Requests for data for a page with number more than data exists will result as empty page response.

size: (Type: Integer) (Optional, def value: 500, min: 10, max: 10000) The number of records per page

Responses

Status	Meaning	Description	Schema
200	OK	OK	None
400	Bad Request	Bad Request	ErrorResponse
401	Unauthorized	Unauthorized	None
429	Too Many Requests	Too Many Requests	None
500	Internal Server Error	Internal Server Error	ErrorResponse

Response Schema

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

In this section:

Get DNS requests sent by user.

Parameters

Detailed descriptions

Responses

Response Schema

Search results