summaryrefslogtreecommitdiffstats
path: root/src/share/api/remote-option-def4-get.json
blob: c48fda4db16add1c9b575e03654cbaf32b96794a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
{
    "access": "read",
    "avail": "1.6.0",
    "brief": [
        "This command fetches a DHCPv4 option definition from the configuration database."
    ],
    "cmd-comment": [
        "The desired option definition is identified by the pair of option code/space values. The ``server-tags`` list is mandatory and must contain exactly one server tag. Specifying an empty list, a value of ``null``, or multiple server tags will result in an error. The server tag \"all\" is allowed, to fetch the option definition instance shared by all servers."
    ],
    "cmd-syntax": [
        "{",
        "    \"command\": \"remote-option-def4-get\",",
        "    \"arguments\": {",
        "        \"option-defs\": [",
        "            {",
        "                \"code\": <option code>,",
        "                \"space\": <option space>",
        "            }",
        "        ],",
        "        \"remote\": {",
        "            <specification of the database to connect to>",
        "        },",
        "        \"server-tags\": [ <single server tag as string> ]",
        "    }",
        "}"
    ],
    "hook": "cb_cmds",
    "name": "remote-option-def4-get",
    "resp-comment": [
        "The metadata is included and provides database-specific information associated with the returned object. If the \"all\" server tag is specified, the command attempts to fetch the option definition associated with all servers. If the explicit server tag is specified, the command fetches the option definition associated with the given server. If the server-specific option definition does not exist, the ``remote-option-def4-get`` command fetches the option definition associated with all servers."
    ],
    "resp-syntax": [
        "{",
        "    \"result\": 0,",
        "    \"text\": \"DHCPv4 option definition found.\",",
        "    \"arguments\": {",
        "        \"option-defs\": [",
        "            {",
        "                <option definition>,",
        "                \"metadata\": {",
        "                    \"server-tags\": [ <server tag> ]",
        "                }",
        "            }",
        "        ],",
        "        \"count\": 1",
        "    }",
        "}"
    ],
    "support": [
        "kea-dhcp4"
    ]
}