Get DNS Server test
GET {{baseUrl}}/tests/dns-server/:testId?aid=1234&expand=agent,monitor
Returns details for a DNS Server test, including name, intervals, targets, alert rules and agents.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
aid | number | A unique identifier associated with your account group. You can retrieve your AccountGroupId from the /account-groups endpoint. Note that you must be assigned to the target account group. Specifying this parameter without being assigned to the target account group will result in an error response. | |
expand | string | Optional parameter on whether or not to expand the test sub-resources. By default no expansion is going to take place if the query parameter is not present. If the user wishes to expand the agents sub-resource, they need to pass the ?expand=agent query. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"dnsServers":[{"serverId":"1447","serverName":"dns-example.net"},{"serverId":"1447","serverName":"dns-example.net"}],"domain":"www.thousandeyes.com","interval":60,"alertsEnabled":true,"enabled":true,"alertRules":[{"ruleId":"127094","ruleName":"The End of the Internet","expression":"((hops((hopDelay \u003e= 100 ms))))","direction":"to-target","isDefault":true,"alertType":"http-server","minimumSources":10,"minimumSourcesPct":99,"roundsViolatingMode":"exact","roundsViolatingOutOf":5,"roundsViolatingRequired":2,"sensitivityLevel":"medium","severity":"major"},{"ruleId":"127094","ruleName":"The End of the Internet","expression":"((hops((hopDelay \u003e= 100 ms))))","direction":"to-target","isDefault":true,"alertType":"http-server","minimumSources":10,"minimumSourcesPct":99,"roundsViolatingMode":"exact","roundsViolatingOutOf":5,"roundsViolatingRequired":2,"sensitivityLevel":"medium","severity":"major"}],"createdBy":"user@user.com","createdDate":"2022-07-17T22:00:54Z","description":"ThousandEyes Test","liveShare":false,"modifiedBy":"user@user.com","modifiedDate":"2022-07-17T22:00:54Z","savedEvent":true,"testId":"281474976710706","testName":"ThousandEyes Test","type":"agent-to-server","_links":{"self":{"href":"https://api.thousandeyes.com/v7/tests/{type}/281474976710706"},"testResults":[{"href":"https://api.thousandeyes.com/v7/test-results/281474976710706/network"},{"href":"https://api.thousandeyes.com/v7/test-results/281474976710706/path-vis"}]},"labels":[{"labelId":"961","name":"Artem label","isBuiltin":false},{"labelId":"961","name":"Artem label","isBuiltin":false}],"sharedWithAccounts":[{"aid":"1234","name":"Account name"},{"aid":"1234","name":"Account name"}],"bandwidthMeasurements":true,"dnsTransportProtocol":"udp","mtuMeasurements":false,"networkMeasurements":true,"numPathTraces":3,"pathTraceMode":"classic","probeMode":"auto","protocol":"tcp","recursiveQueries":true,"ipv6Policy":"use-agent-policy","fixedPacketRate":50,"dnsQueryClass":"in","bgpMeasurements":true,"usePublicBgp":true,"monitors":[{"countryId":"GB","monitorId":"1234","ipAddress":"4.69.184.193","network":"Level 3 Communications, Inc. (AS 3356)","monitorType":"public","monitorName":"Seattle, WA"},{"countryId":"GB","monitorId":"1234","ipAddress":"4.69.184.193","network":"Level 3 Communications, Inc. (AS 3356)","monitorType":"public","monitorName":"Seattle, WA"}],"agents":[{"agentType":"enterprise-cluster","ipAddresses":["99.139.65.220","9bbd:8a0a:a257:5876:288b:6cb2:3f36:64ce"],"publicIpAddresses":["192.168.1.78","f9b2:3a21:f25c:d300:03f4:586d:f8d6:4e1c"],"network":"AT\u0026T Services, Inc. (AS 7018)","agentId":"281474976710706","agentName":"thousandeyes-stg-va-254","location":"San Francisco Bay Area","countryId":"US","enabled":true,"prefix":"99.128.0.0/11","verifySslCertificates":true},{"agentType":"enterprise-cluster","ipAddresses":["99.139.65.220","9bbd:8a0a:a257:5876:288b:6cb2:3f36:64ce"],"publicIpAddresses":["192.168.1.78","f9b2:3a21:f25c:d300:03f4:586d:f8d6:4e1c"],"network":"AT\u0026T Services, Inc. (AS 7018)","agentId":"281474976710706","agentName":"thousandeyes-stg-va-254","location":"San Francisco Bay Area","countryId":"US","enabled":true,"prefix":"99.128.0.0/11","verifySslCertificates":true}]}