[#2815] Update command API references

diff --git a/src/share/api/reservation-add.json b/src/share/api/reservation-add.json
index d77172561340e0819b9b7349f3a43264d2df992a..9115645062d7e6133019505c779f9d8f063aae7f 100644 (file)
--- a/src/share/api/reservation-add.json
+++ b/src/share/api/reservation-add.json
@@ -5,7 +5,7 @@
         "This command adds a new host reservation. The reservation may include IPv4 addresses, IPv6 addresses, IPv6 prefixes, various identifiers, a class the client will be assigned to, DHCPv4 and DHCPv6 options, and more."
     ],
     "cmd-comment": [
-        "Note that boot-file-name, circuit-id, client-id, ip-address, next-server, and server-hostname are IPv4-specific. ip-addresses, and prefixes are IPv6-specific."
+        "Note that boot-file-name, circuit-id, client-id, ip-address, next-server, and server-hostname are IPv4-specific. ip-addresses, and prefixes are IPv6-specific. Operation-target is optional; default is 'alternate'."
     ],
     "cmd-syntax": [
         "{",
@@ -28,7 +28,8 @@
         "            \"server-hostname\": <string>,",
         "            \"subnet-id\": <integer>,",
         "            \"user-context\": <any valid JSON>",
-        "        }",
+        "        },",
+        "        \"operation-target\": <string (primary, alternate, all, default)>",
         "    }",
         "}"
     ],

diff --git a/src/share/api/reservation-del.json b/src/share/api/reservation-del.json
index 61ec8d78788dd1ade76dc750a6d17c6dcd5bbda8..b913b139af522cf9dcb0c97219bc120f1fb22fb4 100644 (file)
--- a/src/share/api/reservation-del.json
+++ b/src/share/api/reservation-del.json
@@ -5,7 +5,7 @@
         "This command deletes an existing host reservation."
     ],
     "cmd-comment": [
-        "The host reservation can be identified by either the (subnet-id, ip-address) pair or a triplet of (subnet-id, identifier-type, identifier)."
+        "The host reservation can be identified by either the (subnet-id, ip-address) pair or a triplet of (subnet-id, identifier-type, identifier). Operation-target is optional; default is 'alternate'."
     ],
     "cmd-syntax": [
         "{",
@@ -14,7 +14,8 @@
         "        \"subnet-id\": <integer>,",
         "        \"ip-address\": <string>,",
         "        \"identifier-type\": <one of 'hw-address', 'duid', 'circuit-id', 'client-id' and 'flex-id'>,",
-        "        \"identifier\": <string>",
+        "        \"identifier\": <string>,",
+        "        \"operation-target\": <string (primary, alternate, all, default)>",
         "    }",
         "}"
     ],

diff --git a/src/share/api/reservation-get-all.json b/src/share/api/reservation-get-all.json
index 5e1eeb594c22944437dc0bc830af610172a7d305..19fd18955c213099fdbc4336c122dbdcf6fb07d5 100644 (file)
--- a/src/share/api/reservation-get-all.json
+++ b/src/share/api/reservation-get-all.json
@@ -4,11 +4,15 @@
     "brief": [
         "This command retrieves all host reservations for a specified subnet."
     ],
+    "cmd-comment": [
+        "Operation-target is optional; default is 'all'."
+    ],
     "cmd-syntax": [
         "{",
         "    \"command\": \"reservation-get-all\",",
         "    \"arguments\": {",
-        "        \"subnet-id\": <integer>",
+        "        \"subnet-id\": <integer>,",
+        "        \"operation-target\": <string (primary, alternate, all, default)>",
         "    }",
         "}"
     ],

diff --git a/src/share/api/reservation-get-by-hostname.json b/src/share/api/reservation-get-by-hostname.json
index 06d0e5cb941503f424195ac1dcdf3cbd83d27b69..86f4f225edb4d62cb8c3c10cc64005fa81a4722a 100644 (file)
--- a/src/share/api/reservation-get-by-hostname.json
+++ b/src/share/api/reservation-get-by-hostname.json
@@ -4,12 +4,16 @@
     "brief": [
         "This command retrieves all host reservations for a specified hostname and optionally a specified subnet."
     ],
+    "cmd-comment": [
+        "Operation-target is optional; default is 'all'."
+    ],
     "cmd-syntax": [
         "{",
         "    \"command\": \"reservation-get-by-hostname\",",
         "    \"arguments\": {",
         "        \"hostname\": <hostname>,",
-        "        \"subnet-id\": <integer>",
+        "        \"subnet-id\": <integer>,",
+        "        \"operation-target\": <string (primary, alternate, all, default)>",
         "    }",
         "}"
     ],

diff --git a/src/share/api/reservation-get-by-id.json b/src/share/api/reservation-get-by-id.json
index 59958df62e8ae0930f1432ba0b3749c047a59370..9f90be88e7330c1e9c2ec1e843f9fc25015c79aa 100644 (file)
--- a/src/share/api/reservation-get-by-id.json
+++ b/src/share/api/reservation-get-by-id.json
@@ -4,12 +4,16 @@
     "brief": [
         "This command retrieves all host reservations for a specified identifier (type and value)."
     ],
+    "cmd-comment": [
+        "Operation-target is optional; default is 'all'."
+    ],
     "cmd-syntax": [
         "{",
         "    \"command\": \"reservation-get-by-id\",",
         "    \"arguments\": {",
         "        \"identifier-type\": <one of 'hw-address', 'duid', 'circuit-id', 'client-id' and 'flex-id'>,",
-        "        \"identifier\": <string>",
+        "        \"identifier\": <string>,",
+        "        \"operation-target\": <string (primary, alternate, all, default)>",
         "    }",
         "}"
     ],

diff --git a/src/share/api/reservation-get.json b/src/share/api/reservation-get.json
index 16b3f194c73c7a3c62508097b03810248305e5ce..f42a0ade7e33cce6995aa313fc257f53b928ac73 100644 (file)
--- a/src/share/api/reservation-get.json
+++ b/src/share/api/reservation-get.json
@@ -5,7 +5,7 @@
         "This command retrieves an existing host reservation."
     ],
     "cmd-comment": [
-        "The host reservation can be identified by either the (subnet-id, ip-address) pair or a triplet of (subnet-id, identifier-type, identifier)."
+        "The host reservation can be identified by either the (subnet-id, ip-address) pair or a triplet of (subnet-id, identifier-type, identifier). Operation-target is optional; default is 'all'."
     ],
     "cmd-syntax": [
         "{",
@@ -13,7 +13,8 @@
         "    \"arguments\": {",
         "        \"subnet-id\": <integer>,",
         "        \"identifier-type\": <one of 'hw-address', 'duid', 'circuit-id', 'client-id' and 'flex-id'>,",
-        "        \"identifier\": <string>",
+        "        \"identifier\": <string>,",
+        "        \"operation-target\": <string (primary, alternate, all, default)>",
         "    }",
         "}"
     ],

diff --git a/src/share/api/reservation-update.json b/src/share/api/reservation-update.json
index 7af996b6fbea28e6520cf85fa2a07eef75f3c0e6..d998e75877a9c0d59794b5440f1a728b8b0d8eba 100644 (file)
--- a/src/share/api/reservation-update.json
+++ b/src/share/api/reservation-update.json
@@ -5,7 +5,7 @@
         "This command updates an existing host reservation. The reservation has to include host identifiers and a subnet identifier and may include IPv4 addresses, IPv6 addresses, IPv6 prefixes, various identifiers, a class the client will be assigned to, DHCPv4 and DHCPv6 options, and more."
     ],
     "cmd-comment": [
-        "Note that boot-file-name, circuit-id, client-id, ip-address, next-server, and server-hostname are IPv4-specific. ip-addresses, and prefixes are IPv6-specific."
+        "Note that boot-file-name, circuit-id, client-id, ip-address, next-server, and server-hostname are IPv4-specific. ip-addresses, and prefixes are IPv6-specific. Operation-target is optional; default is 'alternate'."
     ],
     "cmd-syntax": [
         "{",
@@ -28,7 +28,8 @@
         "            \"server-hostname\": <string>,",
         "            \"subnet-id\": <integer>,",
         "            \"user-context\": <any valid JSON>",
-        "        }",
+        "        },",
+        "        \"operation-target\": <string (primary, alternate, all, default)>",
         "    }",
         "}"
     ],