{ "result": 1, "text": "No 'ip-address' provided and 'identifier-type' is either missing or not a string." }
-.. _command-reservations-get:
+.. _command-reservation-get-by-address:
-The ``reservations-get`` Command
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The ``reservation-get-by-address`` Command
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-``reservations-get`` can be used to query the host database and
+``reservation-get-by-address`` can be used to query the host database and
retrieve all reservations in a specified subnet for given ip address.
.. isccmd:: reservation-get-all
api_files += $(top_srcdir)/src/share/api/reservation-add.json
api_files += $(top_srcdir)/src/share/api/reservation-del.json
api_files += $(top_srcdir)/src/share/api/reservation-get-all.json
+api_files += $(top_srcdir)/src/share/api/reservation-get-by-address.json
api_files += $(top_srcdir)/src/share/api/reservation-get-by-hostname.json
api_files += $(top_srcdir)/src/share/api/reservation-get-by-id.json
api_files += $(top_srcdir)/src/share/api/reservation-get-page.json
api_files += $(top_srcdir)/src/share/api/reservation-get.json
-api_files += $(top_srcdir)/src/share/api/reservations-get.json
api_files += $(top_srcdir)/src/share/api/reservation-update.json
api_files += $(top_srcdir)/src/share/api/server-tag-get.json
api_files += $(top_srcdir)/src/share/api/shutdown.json
--- /dev/null
+{
+ "access": "read",
+ "avail": "2.3.9",
+ "brief": [
+ "This command retrieves all host reservations for given ip-address and optionally a specified subnet."
+ ],
+ "cmd-comment": [
+ "The host reservations can be identified by a pair of ip-address and subnet-id. Subnet-id is optional. Operation-target is optional; default is 'all'."
+ ],
+ "cmd-syntax": [
+ "{",
+ " \"command\": \"reservation-get-by-address\",",
+ " \"arguments\": {",
+ " \"ip-address\": <string>,",
+ " \"subnet-id\": <integer>,",
+ " \"operation-target\": <string (primary, alternate, all, default)>",
+ " }",
+ "}"
+ ],
+ "hook": "host_cmds",
+ "name": "reservation-get-by-address",
+ "resp-comment": [
+ "The reservation-get-by-address may return many reservations for the same ip-address. This command may be useful in case ip-reservations-unique configuration flag is set to false."
+ ],
+ "support": [
+ "kea-dhcp4",
+ "kea-dhcp6"
+ ]
+}
+++ /dev/null
-{
- "access": "read",
- "avail": "2.3.9",
- "brief": [
- "This command retrieves all host reservations for a specified subnet and ip-address."
- ],
- "cmd-comment": [
- "The host reservations can be identified by a pair of subnet-id, ip-address. Operation-target is optional; default is 'all'."
- ],
- "cmd-syntax": [
- "{",
- " \"command\": \"reservations-get\",",
- " \"arguments\": {",
- " \"subnet-id\": <integer>,",
- " \"ip-address\": <string>,",
- " \"operation-target\": <string (primary, alternate, all, default)>",
- " }",
- "}"
- ],
- "hook": "host_cmds",
- "name": "reservations-get",
- "resp-comment": [
- "The reservations-get may return many reservations for the same ip-address. This is useful in case ip-reservations-unique configuration flag is set to false."
- ],
- "support": [
- "kea-dhcp4",
- "kea-dhcp6"
- ]
-}