List DNS servers

GET 
/network/dns/:interfaceName

Retrieve the list of currently configured DNS servers for a specific network interface.

Request

Path Parameters

interfaceName stringrequired

The name of the network interface to retrieve DNS configuration for. Must only contain letters and numbers.

Responses

200

List of DNS servers.

application/json

Schema

Schema

servers string[]

List of configured DNS servers.

search_domains string[]

List of search domains.

Example (from schema)

{
  "servers": [
    "string"
  ],
  "search_domains": [
    "string"
  ]
}

400

Invalid interface name provided.

application/json

Schema

Schema

error stringrequired

A description of the error that occurred.

details string

Additional details about the error, specifying which component failed.

code integerrequired

The error code.

Example (from schema)

{
  "error": "Failed to retrieve network status.",
  "details": "Failed to get DNS servers due to network timeout.",
  "code": 500
}

500

Error retrieving DNS servers.

application/json

Schema

Schema

error stringrequired

A description of the error that occurred.

details string

Additional details about the error, specifying which component failed.

code integerrequired

The error code.

Example (from schema)

{
  "error": "Failed to retrieve network status.",
  "details": "Failed to get DNS servers due to network timeout.",
  "code": 500
}

Loading...