Server

An object representing a single PowerDNS server. In the built-in API, only one Server exists (called “localhost”).

A proxy that allows control of multiple servers MUST NOT return localhost, but SHOULD return other servers.

json Server : object

Server

Optional members:
config_url : string

The API endpoint for this server’s configuration

daemon_type : string

“recursor” for the PowerDNS Recursor and “authoritative” for the Authoritative Server

id : string

The id of the server, “localhost”

type : string

Set to “Server”

url : string

The API endpoint for this server

version : string

The version of the server software

zones_url : string

The API endpoint for this server’s zones

Example:

{
  "type": "Server",
  "id": "localhost",
  "url": "/api/v1/servers/localhost",
  "daemon_type": "recursor",
  "version": "4.1.0",
  "config_url": "/api/v1/servers/localhost/config{/config_setting}",
  "zones_url": "/api/v1/servers/localhost/zones{/zone}",
}

Note

The servers collection is read-only, and the only allowed returned server is read-only as well. A control proxy could return modifiable resources.