summaryrefslogtreecommitdiffstats
path: root/src/share/api/remote-network6-list.json
diff options
context:
space:
mode:
Diffstat (limited to 'src/share/api/remote-network6-list.json')
-rw-r--r--src/share/api/remote-network6-list.json52
1 files changed, 52 insertions, 0 deletions
diff --git a/src/share/api/remote-network6-list.json b/src/share/api/remote-network6-list.json
new file mode 100644
index 0000000..107ba80
--- /dev/null
+++ b/src/share/api/remote-network6-list.json
@@ -0,0 +1,52 @@
+{
+ "access": "read",
+ "avail": "1.6.0",
+ "brief": [
+ "This command fetches a list of all IPv6 shared networks from the configuration database."
+ ],
+ "cmd-comment": [
+ "The ``server-tags`` list is required for this command, and must not be empty. It may either contain one or multiple server tags as strings, or a single ``null`` value."
+ ],
+ "cmd-syntax": [
+ "{",
+ " \"command\": \"remote-network6-list\",",
+ " \"arguments\": {",
+ " \"remote\": {",
+ " <specification of the database to connect to>",
+ " },",
+ " \"server-tags\": [ <first server tag>, <second server tag>, ... ]",
+ " }",
+ "}"
+ ],
+ "hook": "cb_cmds",
+ "name": "remote-network6-list",
+ "resp-comment": [
+ "The returned response contains the list of maps. Each map contains the shared network name and the metadata, which provides database-specific information associated with the shared network. The returned list does not contain full definitions of the shared networks; use ``remote-network6-get`` to fetch the full information about the selected shared networks. If the command includes explicit server tags as strings (including the special server tag \"all\"), the list contains all shared networks which are associated with any of the specified tags. A network is returned even if it is associated with multiple servers and only one of the specified tags matches. If the command includes the ``null`` value in the ``server-tags`` list, the response contains all shared networks which are assigned to no servers (unassigned)."
+ ],
+ "resp-syntax": [
+ "{",
+ " \"result\": 0,",
+ " \"text\": \"2 IPv6 shared network(s) found.\",",
+ " \"arguments\": {",
+ " \"shared-networks\": [",
+ " {",
+ " \"name\": <first shared network name>,",
+ " \"metadata\": {",
+ " \"server-tags\": [ <first server tag>, <second server tag>, ... ]",
+ " }",
+ " },",
+ " {",
+ " \"name\": <second shared network name>,",
+ " \"metadata\": {",
+ " \"server-tags\": [ <first server tag>, ... ]",
+ " }",
+ " }",
+ " ],",
+ " \"count\": 2",
+ " }",
+ "}"
+ ],
+ "support": [
+ "kea-dhcp6"
+ ]
+}