summaryrefslogtreecommitdiffstats
path: root/src/share/api/remote-server4-get-all.json
diff options
context:
space:
mode:
Diffstat (limited to 'src/share/api/remote-server4-get-all.json')
-rw-r--r--src/share/api/remote-server4-get-all.json47
1 files changed, 47 insertions, 0 deletions
diff --git a/src/share/api/remote-server4-get-all.json b/src/share/api/remote-server4-get-all.json
new file mode 100644
index 0000000..5555752
--- /dev/null
+++ b/src/share/api/remote-server4-get-all.json
@@ -0,0 +1,47 @@
+{
+ "access": "read",
+ "avail": "1.6.0",
+ "brief": [
+ "This command fetches information about all DHCPv4 servers specified by the user."
+ ],
+ "cmd-comment": [
+ "This command contains no arguments besides the optional ``remote``."
+ ],
+ "cmd-syntax": [
+ "{",
+ " \"command\": \"remote-server4-get-all\",",
+ " \"arguments\": {",
+ " \"remote\": {",
+ " <specification of the database to connect to>",
+ " }",
+ " }",
+ "}"
+ ],
+ "hook": "cb_cmds",
+ "name": "remote-server4-get-all",
+ "resp-comment": [
+ "The returned response contain a list of maps. Each map contains a server tag uniquely identifying a server, and the user-defined description of the server. The Kea Configuration Backend uses the keyword ``all`` to associate parts of the configuration with all servers. Internally, it creates the logical server ``all`` for this purpose. However, this logical server is not returned as a result of the ``remote-server4-get-all`` command; only the user-defined servers are returned."
+ ],
+ "resp-syntax": [
+ "{",
+ " \"result\": 0,",
+ " \"text\": \"DHCPv4 servers found.\",",
+ " \"arguments\": {",
+ " \"servers\": [",
+ " {",
+ " \"server-tag\": <first server tag>,",
+ " \"description\": <first server description>",
+ " },",
+ " {",
+ " \"server-tag\": <second server tag>,",
+ " \"description\": <second server description>",
+ " }",
+ " ],",
+ " \"count\": 2",
+ " }",
+ "}"
+ ],
+ "support": [
+ "kea-dhcp4"
+ ]
+}