diff options
Diffstat (limited to 'src/share/api/lease4-get-by-hostname.json')
| -rw-r--r-- | src/share/api/lease4-get-by-hostname.json | 47 |
1 files changed, 47 insertions, 0 deletions
diff --git a/src/share/api/lease4-get-by-hostname.json b/src/share/api/lease4-get-by-hostname.json new file mode 100644 index 0000000..38e5224 --- /dev/null +++ b/src/share/api/lease4-get-by-hostname.json @@ -0,0 +1,47 @@ +{ + "access": "read", + "avail": "1.7.1", + "brief": [ + "This command retrieves all IPv4 leases with the specified hostname." + ], + "cmd-syntax": [ + "{", + " \"command\": \"lease4-get-by-hostname\",", + " \"arguments\": {", + " \"hostname\": \"myhost.example.com.\"", + " }", + "}" + ], + "description": "See <xref linkend=\"command-lease4-get-by-hostname\"/>", + "hook": "lease_cmds", + "name": "lease4-get-by-hostname", + "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\": \"myhost.example.com.\",", + " \"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" + ] +} |