diff options
Diffstat (limited to 'src/share/api/remote-subnet4-get-by-id.json')
| -rw-r--r-- | src/share/api/remote-subnet4-get-by-id.json | 49 |
1 files changed, 49 insertions, 0 deletions
diff --git a/src/share/api/remote-subnet4-get-by-id.json b/src/share/api/remote-subnet4-get-by-id.json new file mode 100644 index 0000000..e23bbe1 --- /dev/null +++ b/src/share/api/remote-subnet4-get-by-id.json @@ -0,0 +1,49 @@ +{ + "access": "read", + "avail": "1.6.0", + "brief": [ + "This command fetches the selected IPv4 subnet by ID from the configuration database." + ], + "cmd-comment": [ + "This command includes a list with exactly one ID of the subnet to be returned. The ``server-tags`` parameter must not be specified for this command." + ], + "cmd-syntax": [ + "{", + " \"command\": \"remote-subnet4-get-by-id\",", + " \"arguments\": {", + " \"subnets\": [ {", + " \"id\": <subnet identifier>", + " } ],", + " \"remote\": {", + " <specification of the database to connect to>", + " }", + " }", + "}" + ], + "hook": "cb_cmds", + "name": "remote-subnet4-get-by-id", + "resp-comment": [ + "If the shared network name is null, it means that the returned subnet does not belong to any shared network (a global subnet). The metadata is included in the returned subnet definition and provides database-specific information associated with the returned object." + ], + "resp-syntax": [ + "{", + " \"result\": 0,", + " \"text\": \"IPv4 subnet found.\",", + " \"arguments\": {", + " \"subnets\": [ {", + " \"id\": <subnet identifier>,", + " \"subnet\": <subnet prefix>,", + " \"shared-network-name\": <shared network name or null>,", + " \"metadata\": {", + " \"server-tags\": [ <first server tag>, <second server tag>, ... ]", + " },", + " <the rest of the subnet specification here>", + " } ],", + " \"count\": 1", + " }", + "}" + ], + "support": [ + "kea-dhcp4" + ] +} |