Get domain details with dig

post

https://{hostname}/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.

Query Params

accountSwitchKey

string

For customers who manage more than one account, this runs the operation from another account. The Identity and Access Management API provides a list of available account switch keys.

Body Params

edgeIp

string

length ≥ 1

IP of an edge server you want to run the dig command from. Provide either this value or edgeLocationId. To verify if an IP belongs to an edge server, run the Verify an IP operation.

edgeLocationId

string

length ≥ 1

Unique identifier for an edge server location closest to your end users. Provide either this value or edgeIp. To get this value, run the List available edge server locations operation first.

hostname

string

required

Hostname or a domain name you want to get the data for. For a GTM hostname, run the List GTM properties operation first, to get this value.

isGtmHostname

boolean

required

Specifies hostname is a GTM hostname.

queryType

string

enum

required

DNS record type you want to get. Possible values are: A, AAAA, SOA, CNAME, PTR, MX, NS, TXT, SRV, CAA, or ANY. To learn more about them, check Supported DNS record types.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

`dig` results and details about the request.

Language

URL

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

200The response provides the dig results and details about the request.

400Validation error.

401Authorization error.

403Permission error.

405Method not allowed.

429Too many requests.

`dig` results and details about the request.