summaryrefslogtreecommitdiffstats
path: root/src/share/api/reservation-add.json
diff options
context:
space:
mode:
Diffstat (limited to 'src/share/api/reservation-add.json')
-rw-r--r--src/share/api/reservation-add.json50
1 files changed, 50 insertions, 0 deletions
diff --git a/src/share/api/reservation-add.json b/src/share/api/reservation-add.json
new file mode 100644
index 0000000..6e9259e
--- /dev/null
+++ b/src/share/api/reservation-add.json
@@ -0,0 +1,50 @@
+{
+ "access": "write",
+ "avail": "1.2.0",
+ "brief": [
+ "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. Operation-target is optional; default is 'alternate'."
+ ],
+ "cmd-syntax": [
+ "{",
+ " \"command\": \"reservation-add\",",
+ " \"arguments\": {",
+ " \"reservation\": {",
+ " \"boot-file-name\": <string>,",
+ " \"client-id\": <string>,",
+ " \"circuit-id\": <string>,",
+ " \"duid\": <string>,",
+ " \"flex-id\": <string>,",
+ " \"ip-address\": <string (IPv4 address)>,",
+ " \"ip-addresses\": [ <comma-separated strings> ],",
+ " \"hw-address\": <string>,",
+ " \"hostname\": <string>,",
+ " \"next-server\": <string (IPv4 address)>,",
+ " \"option-data\": [ <comma-separated structures defining options> ],",
+ " \"prefixes\": [ <comma-separated IPv6 prefixes> ],",
+ " \"client-classes\": [ <comma-separated strings> ],",
+ " \"server-hostname\": <string>,",
+ " \"subnet-id\": <integer>,",
+ " \"user-context\": <any valid JSON>",
+ " },",
+ " \"operation-target\": <string (memory, database, all, default)>",
+ " }",
+ "}"
+ ],
+ "description": "See <xref linkend=\"cmd-reservation-add\"/>",
+ "hook": "host_cmds",
+ "name": "reservation-add",
+ "resp-syntax": [
+ "",
+ "{",
+ " \"result\": <integer>,",
+ " \"text\": <string>",
+ "}"
+ ],
+ "support": [
+ "kea-dhcp4",
+ "kea-dhcp6"
+ ]
+}