{ "result": 1, "text": "No 'ip-address' provided and 'identifier-type' is either missing or not a string." }
+.. _command-reservations-get:
+
+The ``reservations-get`` Command
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``reservations-get`` can be used to query the host database and
+retrieve all reservations in a specified subnet for given ip address.
+
.. isccmd:: reservation-get-all
.. _command-reservation-get-all:
{
- "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"
- ]
+ "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"
+ ]
}