[#2795] adding reservations-get api

diff --git a/src/share/api/api_files.mk b/src/share/api/api_files.mk
index a9ff829f8cf9cff0d567344b2591b31a3e23b922..4c734b0afab460f2a29470ccbf86b268f9312a51 100644 (file)
--- a/src/share/api/api_files.mk
+++ b/src/share/api/api_files.mk
@@ -162,6 +162,7 @@ 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

diff --git a/src/share/api/reservations-get.json b/src/share/api/reservations-get.json
new file mode 100644 (file)
index 0000000..57823bc
--- /dev/null
+++ b/src/share/api/reservations-get.json
@@ -0,0 +1,29 @@
+{
+  "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\": \"reservation-get-all\",",
+    "    \"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"
+  ]
+}