Get data on managed devices

Gets information on devices managed by the specified management device.

Note: For example, you may want to use these APIs to get values for parameters when adding new management devices to AFA, or editing management device configurations. For more details, see Add/Edit a device.

Resource Name:

Brand

URL

Cisco Firepower, Palo Alto Panorama,
Juniper Space

/api/v1/devices/managedDevices/genericDevices

Fortinet Fortimanager

/api/v1/devices/managedDevices/fortimanager

Checkpoint Smart Center

/api/v1/devices/managedDevices/cma

Checkpoint Provider 1

/api/v1/devices/managedDevices/pv1

Checkpoint Provider 1/Checkpoint Smart Center

/api/v1/devices/managedDevices/pv1/cma

Request Method: POST

Request URL Parameters:

Brand

Element

Type

Description

Cisco Firepower, Palo Alto Panorama,
Juniper Space

 body String

JSON that specifies the management device that manages the devices for which you want to get details.

Fortinet Fortimanager,

Checkpoint Smart Center, Checkpoint Smart Center, Checkpoint Provider 1

body

String

A map of devices in the following syntax:

map<String, Object>

Response:

Brand

Description

Cisco Firepower, Palo Alto Panorama,
Juniper Space

JSON that specifies the management device that manages the devices for which you want to get details.

Fortinet Fortimanager,

Checkpoint Smart Center, Checkpoint Smart Center, Checkpoint Provider 1

A map of devices in the following syntax:

map<String, Object>

.

Code

Description
200

OK

400

Bad request

401

Unauthorized

403

Non-admin user

Request example

curl --location --request POST 'https://docker:7443/afa/api/v1/ firewallData/managedDevices/fortimanager' \ --header 'Content-Type: application/json' \ --header 'Accept: */*' \ --header 'Cookie: PHPSESSID=r9psihhnjebng2oovhv268odh1' \ --data-raw '{ "brand": "fortimanager",  "host_name": "10.20.138.1", "user_name": "admin", "passwd": "algosec1" }'

Response example

[ { "FWOrigName": "root", "FWParent": "FG100D3G16803186-TEST_DontChange", "FWName": "FG100D3G16803186_TEST_DontChange_root" }, { "FWOrigName": "Da_VDOM1", "FWParent": "FG100D3G16803186-TEST_DontChange", "FWName": "Da_VDOM1" }, { "FWOrigName": "Da_vDOM2", "FWParent": "FG100D3G16803186-TEST_DontChange", "FWName": "Da_vDOM2" }, { "FWOrigName": "root", "FWParent": "Sarid-1", "FWName": "root" }, { "FWOrigName": "VDOM", "FWParent": "Sarid-1", "FWName": "VDOM" }, { "FWOrigName": "newVDOM-5", "FWParent": "Sarid-1", "FWName": "newVDOM-5" }, { "FWOrigName": "root", "FWParent": "Ott_Dam_HA", "FWName": "Ott_Dam_HA_root" }, { "FWOrigName": "vDOM1_HA", "FWParent": "Ott_Dam_HA", "FWName": "vDOM1_HA" }, { "FWOrigName": "vDOM2_HA", "FWParent": "Ott_Dam_HA", "FWName": "vDOM2_HA" }, { "FWOrigName": "V_ICS_PCI", "FWParent": "Ott_Dam_HA", "FWName": "V_ICS_PCI" }, { "FWOrigName": "V_ICS_SADCO", "FWParent": "Ott_Dam_HA", "FWName": "V_ICS_SADCO" } ]