GET DNS Zone Request Logs.

POST

/api/data/namespaces/{namespace}/dns_zones/request_logs

curl --request POST \
  --url https://example-corp.console.ves.volterra.io/api/v1/api/production/us-east-1/namespaces/default/api/data/namespaces/example/dns_zones/request_logs \
  --header 'Authorization: <Authorization>' \
  --header 'Content-Type: application/json' \
  --data '{ "end_time": "example", "filter": "example", "limit": 1, "namespace": "example", "sort": "DESCENDING", "start_time": "example" }'

• F5 Distributed Cloud Console

Retrieve DNS Zone Request Logs.

Examples of this operation.

Authorizations

• ApiToken

Parameters

Path Parameters

namespace

required

string

Namespace fetch request logs for a given namespace.

Request Body^required

Media typeapplication/json

DnsZoneRequestLogRequest

Request to fetch request logs.

object

end_time

end time

Fetch request logs whose timestamp <= end_time format: unix_timestamp|RFC 3339

Optional: If not specified, then the end_time will be evaluated to start_time+10m If start_time is not specified, then the end_time will be evaluated to

string

<= 1024 characters

filter

Label Filter

Filter is used to specify the list of matchers syntax for filter := {[]} := "" := string One or more labels defined in Label can be specified in the filter. := string := [”=”|”!=”] = : equal to != : not equal to

Optional: If not specified, counter will be aggregated based on the group_by labels.

string

<= 1024 characters

limit

limit

Limits the number of logs returned in the response Optional: If not specified, first or last 500 log messages that matches the query (depending on the sort order) will be returned in the response. The maximum value for limit is 500.

integer format: int64

namespace

namespace

Fetch request logs for a given namespace.

string

>= 6 characters <= 1024 characters

sort

string

default: DESCENDING

Allowed values: DESCENDING ASCENDING

start_time

start time

Fetch request logs whose timestamp >= start_time format: unix_timestamp|RFC 3339

Optional: If not specified, then the start_time will be evaluated to end_time-10m If end_time is not specified, then the start_time will be evaluated to -10m.

string

<= 1024 characters

Responses

200

A successful response.

Media typeapplication/json

DnsZoneRequestLogResponse

Response message for RequestLogRequest.

object

logs

logs

List of log messages that matched the query. Not all log messages that matched the query are returned in the response.

Array<object>

Dns Zone Request Logs data item

DNS Zone Request-Log item.

object

client_subnet

Client subnet

Client Subnet.

string

<= 1024 characters

country_code

Country code

Country Code.

string

<= 1024 characters

dns_zone_name

Dns zone name

Identifies the DNS zone name.

string

<= 1024 characters

domain

Domain

Domain

string format: hostname

>= 26 characters <= 1024 characters

query_type

Query type

Query Type.

string

<= 1024 characters

response_code

Response code

Response Code.

string

<= 1024 characters

timestamp

Timestamp

Format: unix_timestamp|RFC 3339 Required: YES.

string format: date-time

<= 1024 characters

responses

Responses

Responses to the DNS query.

Array<string>

total_hits

total hits

Total number of log messages that matched the query.

string format: uint64

<= 1024 characters

Example^generated

{
  "logs": [
    {
      "client_subnet": "example",
      "country_code": "example",
      "dns_zone_name": "example",
      "domain": "example",
      "query_type": "example",
      "response_code": "example",
      "timestamp": "2026-04-15T12:00:00Z",
      "responses": [
        "example"
      ]
    }
  ],
  "total_hits": "example"
}

401

Returned when operation is not authorized.

Media typeapplication/json

string format: string

Example^generated

example

403

Returned when there is no permission to access resource.

Media typeapplication/json

string format: string

Example^generated

example

404

Returned when resource is not found.

Media typeapplication/json

string format: string

Example^generated

example

409

Returned when operation on resource is conflicting with current value.

Media typeapplication/json

string format: string

Example^generated

example

429

Returned when operation has been rejected as it is happening too frequently.

Media typeapplication/json

string format: string

Example^generated

example

500

Returned when server encountered an error in processing API.

Media typeapplication/json

string format: string

Example^generated

example

503

Returned when service is unavailable temporarily.

Media typeapplication/json

string format: string

Example^generated

example

504

Returned when server timed out processing request.

Media typeapplication/json

string format: string

Example^generated

example