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.