From: Otto Date: Wed, 17 Feb 2021 07:55:08 +0000 (+0100) Subject: Avoid some confusion about server objects X-Git-Tag: dnsdist-1.6.0-alpha2~36^2~2 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=1df52b8457079883f0163a28fa1b90196a158fa8;p=thirdparty%2Fpdns.git Avoid some confusion about server objects --- diff --git a/docs/common/api/server.rst b/docs/common/api/server.rst index 10245939e3..d1b4008b89 100644 --- a/docs/common/api/server.rst +++ b/docs/common/api/server.rst @@ -5,7 +5,7 @@ Server An object representing a single PowerDNS server. In the built-in API, only one Server exists (called "localhost"). - pdnsmgrd and pdnscontrol MUST NOT return “localhost”, but SHOULD return + A proxy that allows control of multiple servers MUST NOT return “localhost”, but SHOULD return other servers. :property string type: Set to "Server" @@ -30,6 +30,4 @@ Server "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. - On a pdnscontrol server, the servers collection is read-write, and the returned server resources are read-write as well. - Write permissions may depend on the credentials you have supplied. + Note: the servers collection is read-only, and the only allowed returned server is read-only as well. A control proxy could return modifyable resources.