summaryrefslogtreecommitdiffstats
path: root/src/share/api/remote-subnet4-get-by-prefix.json
blob: d973412344ad8a8c3fc80581b0f0f8f4690e266d (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
{
    "access": "read",
    "avail": "1.6.0",
    "brief": [
        "This command fetches the selected IPv4 subnet by prefix from the configuration database."
    ],
    "cmd-comment": [
        "This command includes a list with exactly one prefix of the subnet to be returned. The ``server-tags`` parameter must not be specified for this command."
    ],
    "cmd-syntax": [
        "{",
        "    \"command\": \"remote-subnet4-get-by-prefix\",",
        "    \"arguments\": {",
        "        \"subnets\": [ {",
        "            \"subnet\": <subnet prefix>",
        "        } ],",
        "        \"remote\": {",
        "            <specification of the database to connect to>",
        "        }",
        "    }",
        "}"
    ],
    "hook": "cb_cmds",
    "name": "remote-subnet4-get-by-prefix",
    "resp-comment": [
        "If the shared network name is null, it means that the returned subnet does not belong to any shared network (global subnet). The metadata is included in the returned subnet definition and provides database-specific information associated with the returned object."
    ],
    "resp-syntax": [
        "{",
        "    \"result\": 0,",
        "    \"text\": \"IPv4 subnet found.\",",
        "    \"arguments\": {",
        "        \"subnets\": [",
        "            {",
        "                \"id\": <subnet identifier>,",
        "                \"subnet\": <subnet prefix>,",
        "                \"shared-network-name\": <shared network name or null>,",
        "                \"metadata\": {",
        "                    \"server-tags\": [ <first server tag>, <second server tag>, ... ]",
        "                },",
        "                <the rest of the subnet specification here>",
        "            }",
        "        ],",
        "        \"count\": 1",
        "    }",
        "}"
    ],
    "support": [
        "kea-dhcp4"
    ]
}