Logo
Akamai APIs API Documentation

Get domain details with dig

POST https://{{host}}/edge-diagnostics/v1/dig

Uses the dig command to provide DNS details for the location of an edge server, a hostname or a domain name, or a GTM hostname. The results may help you diagnose issues with domain name resolutions. You can run this operation either for a specific location or an edge IP. If you want to get the data for a location, you need to run the List available edge server locations operation first to get edgeLocationId. To run this operation for an IP, you may need to verify an IP, if it belongs to an edge server. And to run this operation for a GTM hostname, you need to run the List GTM properties operation first. If you don't provide neither a location ID nor an edge server IP, then Edge Diagnostics runs the operation using a random edge server IP.

 

Body PARAM

Key Datatype Required Description 
accountSwitchKey
string (Optional) For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys).



HEADERS

Key Datatype Required Description 
Content-Type
string
Accept
string




RESPONSES

status OK

{ "completedTime": "2020-12-24T04:25:42Z", "createdBy": "jperez", "createdTime": "2020-12-24T04:25:40Z", "edgeIpLocation": { "asNumber": 20940, "city": "TOKYO", "countryCode": "JP", "regionCode": "13" }, "executionStatus": "SUCCESS", "internalIp": "192.0.2.16", "result": { "answerSection": [ { "hostname": "www.example.com.", "preferenceValue": null, "recordClass": "IN", "recordType": "CNAME", "ttl": 3600, "value": "www.example.com." }, { "hostname": "www.example.com.", "preferenceValue": null, "recordClass": "IN", "recordType": "A", "ttl": 600, "value": "192.0.2.85" } ], "authoritySection": [ { "domain": "example.com.", "preferenceValue": null, "recordClass": "IN", "recordType": "NS", "ttl": 86399, "value": "a.example.net." }, { "domain": "example.com.", "preferenceValue": null, "recordClass": "IN", "recordType": "NS", "ttl": 86399, "value": "b.example.net." } ] } }



Curl
curl -X POST 'https://undefined/edge-diagnostics/v1/dig?accountSwitchKey=' -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{"edgeLocationId":"tokyo-13-japan","hostname":"www.example.com","isGtmHostname":true,"queryType":"A"}'

ENDPOINTS