Get DNS server test results by server
GET {{baseUrl}}/test-results/:testId/dns-server/:serverId?aid=1234&window=12h&startDate=2022-07-17T22:00:54Z&endDate=2022-07-18T22:00:54Z&cursor=
Returns mappings for a DNS record and resolution time to the specified server, measured from the requesting agent's point of view. This is similar to dig @server.
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. | |
window | string | A dynamic time interval up to the current time of the request. Specify the interval as a number followed by an optional type: s for seconds (default if no type is specified), m for minutes, h for hours, d for days, and w for weeks. | |
For a precise date range, use startDate and endDate. | |||
startDate | string | Use with the endDate parameter. Include the complete time (hours, minutes, and seconds) in UTC time zone, following the ISO 8601 date-time format. See the example for reference. Please note that this parameter can't be used with window. | |
endDate | string | Defaults to current time the request is made. Use with the startDate parameter. Include the complete time (hours, minutes, and seconds) in UTC time zone, following the ISO 8601 date-time format. See the example for reference. Please note that this parameter can't be used with window. | |
cursor | null | (Optional) Opaque cursor used for pagination. Clients should use next value from _links instead of this parameter. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"results":[{"date":"2022-07-17T22:00:54Z","roundId":1384309800,"_links":{"appLink":{"href":"https://app.thousandeyes.com/view/tests?__a=105\u0026testId=195\u0026roundId=1692916680\u0026agentId=125"}},"startTime":1384309800,"endTime":1384309800,"agent":{"agentId":"281474976710706","agentName":"thousandeyes-stg-va-254","countryId":"US","location":"San Francisco Bay Area"},"serverId":"456","server":"a1.verisigndns.com.","resolutionTime":3,"errorDetails":"Connection error","mappings":"208.185.7.120"},{"date":"2022-07-17T22:00:54Z","roundId":1384309800,"_links":{"appLink":{"href":"https://app.thousandeyes.com/view/tests?__a=105\u0026testId=195\u0026roundId=1692916680\u0026agentId=125"}},"startTime":1384309800,"endTime":1384309800,"agent":{"agentId":"281474976710706","agentName":"thousandeyes-stg-va-254","countryId":"US","location":"San Francisco Bay Area"},"serverId":"456","server":"a1.verisigndns.com.","resolutionTime":3,"errorDetails":"Connection error","mappings":"208.185.7.120"}],"test":{"interval":60,"alertsEnabled":true,"enabled":true,"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"}]}},"startDate":"2022-07-17T22:00:54Z","endDate":"2022-07-18T22:00:54Z","_links":{"previous":{"href":"https://api.thousandeyes.com/v7/link/to/resource/id","templated":false,"type":"id Duis exercitation","deprecation":"minim aliqua","name":"proident nostrud ea ut sunt","profile":"veniam laborum cillum","title":"dolore sint","hreflang":"esse tempor nisi do"},"next":{"href":"https://api.thousandeyes.com/v7/link/to/resource/id","templated":true,"type":"quis sunt","deprecation":"mollit reprehenderit quis in","name":"laborum id fugiat aliqua","profile":"aliqua eiusmod ullamco exercitation","title":"in irure veniam sed non","hreflang":"id"},"self":{"href":"https://api.thousandeyes.com/v7/link/to/resource/id","templated":true,"type":"do nisi qui","deprecation":"ut dolor proident molli","name":"cillum nisi velit minim","profile":"sit commodo deserunt ullamco eu","title":"id Duis aute","hreflang":"et nulla in cupidatat"}}}