Get Device Group Tree

1 min

POST

{{url}}/aioc-rest-web/rest/discovery/getDeviceGroupTree

Request Overview

The Get Device Group Tree method retrieves a hierarchical representation of devices within a specific group in the KRON PAM system.

Usage:

Provide the groupName in the request body to retrieve the device group tree.

This method is useful for visualizing the structure of devices organized under a particular group, along with their associated details such as management IP, access protocol, and properties.

Path Parameters

urlstring
Default
url

Header Parameters

x-xsrf-tokenstring
Default
{{csrftoken}}

Responses

200getDeviceGroupTree

curl

curl --request POST \
     --url {{url}}/aioc-rest-web/rest/discovery/getDeviceGroupTree \
     --header 'accept: application/json' \
     --header 'x-xsrf-token: {{csrftoken}}'

javascript

var myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/json");
myHeaders.append("x-xsrf-token", "{{csrftoken}}");

var requestOptions = {
   method: 'POST',
   headers: myHeaders,
   redirect: 'follow'
};

fetch("{{url}}/aioc-rest-web/rest/discovery/getDeviceGroupTree", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

ruby

require "uri"
require "json"
require "net/http"

url = URI("{{url}}/aioc-rest-web/rest/discovery/getDeviceGroupTree")

http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Post.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request["x-xsrf-token"] = "{{csrftoken}}"

response = http.request(request)
puts response.read_body

python

import requests
import json

url = "{{url}}/aioc-rest-web/rest/discovery/getDeviceGroupTree"

payload = {}
headers = {
   'accept': 'application/json',
   'content-type': 'application/json',
   'x-xsrf-token': '{{csrftoken}}'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

200

[
    {
        "groupId": "dg.sc_proxy",
        "groupName": "Proxy",
        "devices": [
            {
                "id": "b0bcdeaa-bfd1-4a12-ae76-e90f00761f11",
                "name": "Linux_efe",
                "accessProtocol": "SSHv2",
                "managementIp": "10.20.40.77",
                "properties": {
                    "pseudoDevice": "true"
                }
            },
            {
                "id": "5bef389c-5fe9-4be8-8c85-2a2936dc17e3",
                "name": "RDP*201",
                "accessProtocol": "RDP",
                "managementIp": "10.20.41.201",
                "properties": {
                    "discoverySource": "REST",
                    "remoteDesktop.enable-printing": "true",
                    "pseudoDevice": "true",
                    "remoteDesktop.ignore-cert": "true",
                    "remoteDesktop.enable-drive": "true"
                }
            },
            {
                "id": "83038fd0-b45c-43e3-94db-54134bc2c69f",
                "name": "Oracle 19c (19.10.0)",
                "accessProtocol": "ORACLE_TNS",
                "managementIp": "10.20.42.120",
                "properties": {
                    "db.password": null,
                    "portNum": "1521",
                    "discoverySource": "REST",
                    "pseudoDevice": "true",
                    "db.name": "ORCLCDB",
                    "db.username": "SQLPROXY",
                    "sql.proxy.bind.port": "6000"
                }
            },
            {
                "id": "83ff6737-9f13-4ff6-9e02-666264a86426",
                "name": "SFTP-Test",
                "accessProtocol": "SFTP",
                "managementIp": "10.20.42.222",
                "properties": {
                    "discoverySource": "REST",
                    "pseudoDevice": "true"
                }
            },
            {
                "id": "0558baf4-94c3-4881-8359-5b74c4cf7fdf",
                "name": "rdp-test",
                "accessProtocol": "RDP",
                "managementIp": "10.20.42.56",
                "properties": {
                    "remoteDesktop.security": "any",
                    "discoverySource": "REST",
                    "pseudoDevice": "true",
                    "remoteDesktop.enable-printing": "true",
                    "remoteDesktop.ignore-cert": "true",
                    "remoteDesktop.enable-drive": "true"
                }
            },
            {
                "id": "f340b899-a8df-4dde-b37d-241e2f487ee1",
                "name": "MSSQL - 19",
                "accessProtocol": "MSSQL",
                "managementIp": "10.20.42.96",
                "properties": {
                    "db.password": null,
                    "portNum": "1433",
                    "discoverySource": "REST",
                    "pseudoDevice": "true",
                    "db.name": "master",
                    "db.username": "sa",
                    "sql.proxy.bind.port": "2002"
                }
            },
            {
                "id": "127.0.0.1",
                "name": "127.0.0.1",
                "accessProtocol": "SSHv2",
                "managementIp": "127.0.0.1",
                "properties": {
                    "hostname": "127.0.0.1",
                    "pseudoDevice": "true"
                }
            }
        ]
    },
    {
        "groupId": "a20ab3e0-d02b-4e3b-a867-f0c2ed4ea8c3",
        "groupName": "RDP-201",
        "devices": [
            {
                "id": "b0bcdeaa-bfd1-4a12-ae76-e90f00761f11",
                "name": "Linux_efe",
                "accessProtocol": "SSHv2",
                "managementIp": "10.20.40.77",
                "properties": {
                    "pseudoDevice": "true"
                }
            },
            {
                "id": "5bef389c-5fe9-4be8-8c85-2a2936dc17e3",
                "name": "RDP*201",
                "accessProtocol": "RDP",
                "managementIp": "10.20.41.201",
                "properties": {
                    "discoverySource": "REST",
                    "remoteDesktop.enable-printing": "true",
                    "pseudoDevice": "true",
                    "remoteDesktop.ignore-cert": "true",
                    "remoteDesktop.enable-drive": "true"
                }
            },
            {
                "id": "83038fd0-b45c-43e3-94db-54134bc2c69f",
                "name": "Oracle 19c (19.10.0)",
                "accessProtocol": "ORACLE_TNS",
                "managementIp": "10.20.42.120",
                "properties": {
                    "db.password": null,
                    "portNum": "1521",
                    "discoverySource": "REST",
                    "pseudoDevice": "true",
                    "db.name": "ORCLCDB",
                    "db.username": "SQLPROXY",
                    "sql.proxy.bind.port": "6000"
                }
            },
            {
                "id": "83ff6737-9f13-4ff6-9e02-666264a86426",
                "name": "SFTP-Test",
                "accessProtocol": "SFTP",
                "managementIp": "10.20.42.222",
                "properties": {
                    "discoverySource": "REST",
                    "pseudoDevice": "true"
                }
            },
            {
                "id": "0558baf4-94c3-4881-8359-5b74c4cf7fdf",
                "name": "rdp-test",
                "accessProtocol": "RDP",
                "managementIp": "10.20.42.56",
                "properties": {
                    "remoteDesktop.security": "any",
                    "discoverySource": "REST",
                    "pseudoDevice": "true",
                    "remoteDesktop.enable-printing": "true",
                    "remoteDesktop.ignore-cert": "true",
                    "remoteDesktop.enable-drive": "true"
                }
            },
            {
                "id": "f340b899-a8df-4dde-b37d-241e2f487ee1",
                "name": "MSSQL - 19",
                "accessProtocol": "MSSQL",
                "managementIp": "10.20.42.96",
                "properties": {
                    "db.password": null,
                    "portNum": "1433",
                    "discoverySource": "REST",
                    "pseudoDevice": "true",
                    "db.name": "master",
                    "db.username": "sa",
                    "sql.proxy.bind.port": "2002"
                }
            },
            {
                "id": "127.0.0.1",
                "name": "127.0.0.1",
                "accessProtocol": "SSHv2",
                "managementIp": "127.0.0.1",
                "properties": {
                    "hostname": "127.0.0.1",
                    "pseudoDevice": "true"
                }
            }
        ]
    },
    {
        "groupId": "cd960167-c4e7-42ca-8f79-2bb8438c3cc6",
        "groupName": "SFTP",
        "devices": [
            {
                "id": "b0bcdeaa-bfd1-4a12-ae76-e90f00761f11",
                "name": "Linux_efe",
                "accessProtocol": "SSHv2",
                "managementIp": "10.20.40.77",
                "properties": {
                    "pseudoDevice": "true"
                }
            },
            {
                "id": "5bef389c-5fe9-4be8-8c85-2a2936dc17e3",
                "name": "RDP*201",
                "accessProtocol": "RDP",
                "managementIp": "10.20.41.201",
                "properties": {
                    "discoverySource": "REST",
                    "remoteDesktop.enable-printing": "true",
                    "pseudoDevice": "true",
                    "remoteDesktop.ignore-cert": "true",
                    "remoteDesktop.enable-drive": "true"
                }
            },
            {
                "id": "83038fd0-b45c-43e3-94db-54134bc2c69f",
                "name": "Oracle 19c (19.10.0)",
                "accessProtocol": "ORACLE_TNS",
                "managementIp": "10.20.42.120",
                "properties": {
                    "db.password": null,
                    "portNum": "1521",
                    "discoverySource": "REST",
                    "pseudoDevice": "true",
                    "db.name": "ORCLCDB",
                    "db.username": "SQLPROXY",
                    "sql.proxy.bind.port": "6000"
                }
            },
            {
                "id": "83ff6737-9f13-4ff6-9e02-666264a86426",
                "name": "SFTP-Test",
                "accessProtocol": "SFTP",
                "managementIp": "10.20.42.222",
                "properties": {
                    "discoverySource": "REST",
                    "pseudoDevice": "true"
                }
            },
            {
                "id": "0558baf4-94c3-4881-8359-5b74c4cf7fdf",
                "name": "rdp-test",
                "accessProtocol": "RDP",
                "managementIp": "10.20.42.56",
                "properties": {
                    "remoteDesktop.security": "any",
                    "discoverySource": "REST",
                    "pseudoDevice": "true",
                    "remoteDesktop.enable-printing": "true",
                    "remoteDesktop.ignore-cert": "true",
                    "remoteDesktop.enable-drive": "true"
                }
            },
            {
                "id": "f340b899-a8df-4dde-b37d-241e2f487ee1",
                "name": "MSSQL - 19",
                "accessProtocol": "MSSQL",
                "managementIp": "10.20.42.96",
                "properties": {
                    "db.password": null,
                    "portNum": "1433",
                    "discoverySource": "REST",
                    "pseudoDevice": "true",
                    "db.name": "master",
                    "db.username": "sa",
                    "sql.proxy.bind.port": "2002"
                }
            },
            {
                "id": "127.0.0.1",
                "name": "127.0.0.1",
                "accessProtocol": "SSHv2",
                "managementIp": "127.0.0.1",
                "properties": {
                    "hostname": "127.0.0.1",
                    "pseudoDevice": "true"
                }
            }
        ]
    },
    {
        "groupId": "b5f1b907-09f3-46d5-97ce-969131690425",
        "groupName": "RDP",
        "devices": [
            {
                "id": "b0bcdeaa-bfd1-4a12-ae76-e90f00761f11",
                "name": "Linux_efe",
                "accessProtocol": "SSHv2",
                "managementIp": "10.20.40.77",
                "properties": {
                    "pseudoDevice": "true"
                }
            },
            {
                "id": "5bef389c-5fe9-4be8-8c85-2a2936dc17e3",
                "name": "RDP*201",
                "accessProtocol": "RDP",
                "managementIp": "10.20.41.201",
                "properties": {
                    "discoverySource": "REST",
                    "remoteDesktop.enable-printing": "true",
                    "pseudoDevice": "true",
                    "remoteDesktop.ignore-cert": "true",
                    "remoteDesktop.enable-drive": "true"
                }
            },
            {
                "id": "83038fd0-b45c-43e3-94db-54134bc2c69f",
                "name": "Oracle 19c (19.10.0)",
                "accessProtocol": "ORACLE_TNS",
                "managementIp": "10.20.42.120",
                "properties": {
                    "db.password": null,
                    "portNum": "1521",
                    "discoverySource": "REST",
                    "pseudoDevice": "true",
                    "db.name": "ORCLCDB",
                    "db.username": "SQLPROXY",
                    "sql.proxy.bind.port": "6000"
                }
            },
            {
                "id": "83ff6737-9f13-4ff6-9e02-666264a86426",
                "name": "SFTP-Test",
                "accessProtocol": "SFTP",
                "managementIp": "10.20.42.222",
                "properties": {
                    "discoverySource": "REST",
                    "pseudoDevice": "true"
                }
            },
            {
                "id": "0558baf4-94c3-4881-8359-5b74c4cf7fdf",
                "name": "rdp-test",
                "accessProtocol": "RDP",
                "managementIp": "10.20.42.56",
                "properties": {
                    "remoteDesktop.security": "any",
                    "discoverySource": "REST",
                    "pseudoDevice": "true",
                    "remoteDesktop.enable-printing": "true",
                    "remoteDesktop.ignore-cert": "true",
                    "remoteDesktop.enable-drive": "true"
                }
            },
            {
                "id": "f340b899-a8df-4dde-b37d-241e2f487ee1",
                "name": "MSSQL - 19",
                "accessProtocol": "MSSQL",
                "managementIp": "10.20.42.96",
                "properties": {
                    "db.password": null,
                    "portNum": "1433",
                    "discoverySource": "REST",
                    "pseudoDevice": "true",
                    "db.name": "master",
                    "db.username": "sa",
                    "sql.proxy.bind.port": "2002"
                }
            },
            {
                "id": "127.0.0.1",
                "name": "127.0.0.1",
                "accessProtocol": "SSHv2",
                "managementIp": "127.0.0.1",
                "properties": {
                    "hostname": "127.0.0.1",
                    "pseudoDevice": "true"
                }
            }
        ]
    },
    {
        "groupId": "e4442f9a-1144-4196-bb51-2aaee9405330",
        "groupName": "SAPM device",
        "devices": [
            {
                "id": "b0bcdeaa-bfd1-4a12-ae76-e90f00761f11",
                "name": "Linux_efe",
                "accessProtocol": "SSHv2",
                "managementIp": "10.20.40.77",
                "properties": {
                    "pseudoDevice": "true"
                }
            },
            {
                "id": "5bef389c-5fe9-4be8-8c85-2a2936dc17e3",
                "name": "RDP*201",
                "accessProtocol": "RDP",
                "managementIp": "10.20.41.201",
                "properties": {
                    "discoverySource": "REST",
                    "remoteDesktop.enable-printing": "true",
                    "pseudoDevice": "true",
                    "remoteDesktop.ignore-cert": "true",
                    "remoteDesktop.enable-drive": "true"
                }
            },
            {
                "id": "83038fd0-b45c-43e3-94db-54134bc2c69f",
                "name": "Oracle 19c (19.10.0)",
                "accessProtocol": "ORACLE_TNS",
                "managementIp": "10.20.42.120",
                "properties": {
                    "db.password": null,
                    "portNum": "1521",
                    "discoverySource": "REST",
                    "pseudoDevice": "true",
                    "db.name": "ORCLCDB",
                    "db.username": "SQLPROXY",
                    "sql.proxy.bind.port": "6000"
                }
            },
            {
                "id": "83ff6737-9f13-4ff6-9e02-666264a86426",
                "name": "SFTP-Test",
                "accessProtocol": "SFTP",
                "managementIp": "10.20.42.222",
                "properties": {
                    "discoverySource": "REST",
                    "pseudoDevice": "true"
                }
            },
            {
                "id": "0558baf4-94c3-4881-8359-5b74c4cf7fdf",
                "name": "rdp-test",
                "accessProtocol": "RDP",
                "managementIp": "10.20.42.56",
                "properties": {
                    "remoteDesktop.security": "any",
                    "discoverySource": "REST",
                    "pseudoDevice": "true",
                    "remoteDesktop.enable-printing": "true",
                    "remoteDesktop.ignore-cert": "true",
                    "remoteDesktop.enable-drive": "true"
                }
            },
            {
                "id": "f340b899-a8df-4dde-b37d-241e2f487ee1",
                "name": "MSSQL - 19",
                "accessProtocol": "MSSQL",
                "managementIp": "10.20.42.96",
                "properties": {
                    "db.password": null,
                    "portNum": "1433",
                    "discoverySource": "REST",
                    "pseudoDevice": "true",
                    "db.name": "master",
                    "db.username": "sa",
                    "sql.proxy.bind.port": "2002"
                }
            },
            {
                "id": "127.0.0.1",
                "name": "127.0.0.1",
                "accessProtocol": "SSHv2",
                "managementIp": "127.0.0.1",
                "properties": {
                    "hostname": "127.0.0.1",
                    "pseudoDevice": "true"
                }
            }
        ]
    },
    {
        "groupId": "Unassigned Devices",
        "groupName": "Unassigned Devices",
        "devices": [
            {
                "id": "b0bcdeaa-bfd1-4a12-ae76-e90f00761f11",
                "name": "Linux_efe",
                "accessProtocol": "SSHv2",
                "managementIp": "10.20.40.77",
                "properties": {
                    "pseudoDevice": "true"
                }
            },
            {
                "id": "5bef389c-5fe9-4be8-8c85-2a2936dc17e3",
                "name": "RDP*201",
                "accessProtocol": "RDP",
                "managementIp": "10.20.41.201",
                "properties": {
                    "discoverySource": "REST",
                    "remoteDesktop.enable-printing": "true",
                    "pseudoDevice": "true",
                    "remoteDesktop.ignore-cert": "true",
                    "remoteDesktop.enable-drive": "true"
                }
            },
            {
                "id": "83038fd0-b45c-43e3-94db-54134bc2c69f",
                "name": "Oracle 19c (19.10.0)",
                "accessProtocol": "ORACLE_TNS",
                "managementIp": "10.20.42.120",
                "properties": {
                    "db.password": null,
                    "portNum": "1521",
                    "discoverySource": "REST",
                    "pseudoDevice": "true",
                    "db.name": "ORCLCDB",
                    "db.username": "SQLPROXY",
                    "sql.proxy.bind.port": "6000"
                }
            },
            {
                "id": "83ff6737-9f13-4ff6-9e02-666264a86426",
                "name": "SFTP-Test",
                "accessProtocol": "SFTP",
                "managementIp": "10.20.42.222",
                "properties": {
                    "discoverySource": "REST",
                    "pseudoDevice": "true"
                }
            },
            {
                "id": "0558baf4-94c3-4881-8359-5b74c4cf7fdf",
                "name": "rdp-test",
                "accessProtocol": "RDP",
                "managementIp": "10.20.42.56",
                "properties": {
                    "remoteDesktop.security": "any",
                    "discoverySource": "REST",
                    "pseudoDevice": "true",
                    "remoteDesktop.enable-printing": "true",
                    "remoteDesktop.ignore-cert": "true",
                    "remoteDesktop.enable-drive": "true"
                }
            },
            {
                "id": "f340b899-a8df-4dde-b37d-241e2f487ee1",
                "name": "MSSQL - 19",
                "accessProtocol": "MSSQL",
                "managementIp": "10.20.42.96",
                "properties": {
                    "db.password": null,
                    "portNum": "1433",
                    "discoverySource": "REST",
                    "pseudoDevice": "true",
                    "db.name": "master",
                    "db.username": "sa",
                    "sql.proxy.bind.port": "2002"
                }
            },
            {
                "id": "127.0.0.1",
                "name": "127.0.0.1",
                "accessProtocol": "SSHv2",
                "managementIp": "127.0.0.1",
                "properties": {
                    "hostname": "127.0.0.1",
                    "pseudoDevice": "true"
                }
            }
        ]
    },
    {
        "groupId": "fc92dc64-b128-45fa-b0aa-9051464b0233",
        "groupName": "DataMasking DG",
        "devices": [
            {
                "id": "b0bcdeaa-bfd1-4a12-ae76-e90f00761f11",
                "name": "Linux_efe",
                "accessProtocol": "SSHv2",
                "managementIp": "10.20.40.77",
                "properties": {
                    "pseudoDevice": "true"
                }
            },
            {
                "id": "5bef389c-5fe9-4be8-8c85-2a2936dc17e3",
                "name": "RDP*201",
                "accessProtocol": "RDP",
                "managementIp": "10.20.41.201",
                "properties": {
                    "discoverySource": "REST",
                    "remoteDesktop.enable-printing": "true",
                    "pseudoDevice": "true",
                    "remoteDesktop.ignore-cert": "true",
                    "remoteDesktop.enable-drive": "true"
                }
            },
            {
                "id": "83038fd0-b45c-43e3-94db-54134bc2c69f",
                "name": "Oracle 19c (19.10.0)",
                "accessProtocol": "ORACLE_TNS",
                "managementIp": "10.20.42.120",
                "properties": {
                    "db.password": null,
                    "portNum": "1521",
                    "discoverySource": "REST",
                    "pseudoDevice": "true",
                    "db.name": "ORCLCDB",
                    "db.username": "SQLPROXY",
                    "sql.proxy.bind.port": "6000"
                }
            },
            {
                "id": "83ff6737-9f13-4ff6-9e02-666264a86426",
                "name": "SFTP-Test",
                "accessProtocol": "SFTP",
                "managementIp": "10.20.42.222",
                "properties": {
                    "discoverySource": "REST",
                    "pseudoDevice": "true"
                }
            },
            {
                "id": "0558baf4-94c3-4881-8359-5b74c4cf7fdf",
                "name": "rdp-test",
                "accessProtocol": "RDP",
                "managementIp": "10.20.42.56",
                "properties": {
                    "remoteDesktop.security": "any",
                    "discoverySource": "REST",
                    "pseudoDevice": "true",
                    "remoteDesktop.enable-printing": "true",
                    "remoteDesktop.ignore-cert": "true",
                    "remoteDesktop.enable-drive": "true"
                }
            },
            {
                "id": "f340b899-a8df-4dde-b37d-241e2f487ee1",
                "name": "MSSQL - 19",
                "accessProtocol": "MSSQL",
                "managementIp": "10.20.42.96",
                "properties": {
                    "db.password": null,
                    "portNum": "1433",
                    "discoverySource": "REST",
                    "pseudoDevice": "true",
                    "db.name": "master",
                    "db.username": "sa",
                    "sql.proxy.bind.port": "2002"
                }
            },
            {
                "id": "127.0.0.1",
                "name": "127.0.0.1",
                "accessProtocol": "SSHv2",
                "managementIp": "127.0.0.1",
                "properties": {
                    "hostname": "127.0.0.1",
                    "pseudoDevice": "true"
                }
            }
        ]
    }
]