From 1df52b8457079883f0163a28fa1b90196a158fa8 Mon Sep 17 00:00:00 2001 From: Otto Date: Wed, 17 Feb 2021 08:55:08 +0100 Subject: [PATCH] Avoid some confusion about server objects --- docs/common/api/server.rst | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) 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. -- 2.47.2