summaryrefslogtreecommitdiffstats
path: root/src/share/api/lease4-get-by-client-id.json
diff options
context:
space:
mode:
Diffstat (limited to 'src/share/api/lease4-get-by-client-id.json')
-rw-r--r--src/share/api/lease4-get-by-client-id.json47
1 files changed, 47 insertions, 0 deletions
diff --git a/src/share/api/lease4-get-by-client-id.json b/src/share/api/lease4-get-by-client-id.json
new file mode 100644
index 0000000..9f8f973
--- /dev/null
+++ b/src/share/api/lease4-get-by-client-id.json
@@ -0,0 +1,47 @@
+{
+ "access": "read",
+ "avail": "1.7.1",
+ "brief": [
+ "This command retrieves all IPv4 leases with the specified client id."
+ ],
+ "cmd-syntax": [
+ "{",
+ " \"command\": \"lease4-get-by-client-id\",",
+ " \"arguments\": {",
+ " \"client-id\": \"01:00:0c:01:02:03:04\"",
+ " }",
+ "}"
+ ],
+ "description": "See <xref linkend=\"command-lease4-get-by-client-id\"/>",
+ "hook": "lease_cmds",
+ "name": "lease4-get-by-client-id",
+ "resp-comment": [
+ "Result 0 is returned when at least one lease is found, 1 when parameters are malformed or missing,",
+ "3 is returned if no leases are found."
+ ],
+ "resp-syntax": [
+ " {",
+ " \"arguments\": {",
+ " \"leases\": [",
+ " {",
+ " \"client-id\": \"01:00:0c:01:02:03:04\",",
+ " \"cltt\": 1600432232,",
+ " \"fqdn-fwd\": false,",
+ " \"fqdn-rev\": false,",
+ " \"hostname\": \"\",",
+ " \"hw-address\": \"00:0c:01:02:03:04\",",
+ " \"ip-address\": \"192.168.1.150\",",
+ " \"state\": 0,",
+ " \"subnet-id\": 1,",
+ " \"valid-lft\": 4000",
+ " }",
+ " ]",
+ " },",
+ " \"result\": 0,",
+ " \"text\": \"1 IPv4 lease(s) found.\"",
+ " }"
+ ],
+ "support": [
+ "kea-dhcp4"
+ ]
+}