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..3eee6a0
--- /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 ip-address, client-id, next-server, server-hostname, and boot-file-name are IPv4-specific. duid, ip-addresses, and prefixes are IPv6-specific."
+ ],
+ "cmd-syntax": [
+ "{",
+ " \"command\": \"reservation-add\",",
+ " \"arguments\": {",
+ " \"reservation\": {",
+ " \"boot-file-name\": <string>,",
+ " \"comment\": <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>",
+ " }",
+ " }",
+ "}"
+ ],
+ "description": "See <xref linkend=\"cmd-reservation-add\"/>",
+ "hook": "host_cmds",
+ "name": "reservation-add",
+ "resp-syntax": [
+ "",
+ "{",
+ " \"result\": <integer>,",
+ " \"text\": <string>",
+ "}"
+ ],
+ "support": [
+ "kea-dhcp4",
+ "kea-dhcp6"
+ ]
+}