Get a list of parents for specified list of child devices

Resource Name: /api/v1/device/getParents

Request Method: POST

Request Parameters:

Element

Type

Description

Domain
optional

string

Domain ID. Always use default 0.

children
Mandatory

list of strings

List of device tree names. To get a device tree name, use GET /devices method from the Devices Setup Resource Group. Multiple values are separated by commas (,).

Response Parameters

Element

Type

Description

childrenDevicesNames   List of child device names objects.
originalName string Display name of the entity.
treeName string

Tree name of the entity.

managementDevice boolean

Indicates whether the child device has a parent or not:

  • true: Child device has no parent device

  • false: Child device has parent device

parentDeviceNames   List of parent device names objects. Displayed when value of managementDevice = false.
originalName string Display name of the entity.
treeName string

Tree name of the entity.

Response:

Code

Description

200

OK

401

Unauthorized session

404 Unknown device

Request cURL examples

curl -X POST "https://<localhost>/afa/api/v1/device/getParents" -H "accept: */*" -H "Content-Type: application/json" -d "[ \"10_20_106_1_Lieberman_Misezhnikov\"]"

Response examples 1

[
  {
    "childrenDevicesNames": [
      {
        "originalName": "Misezhnikov",
        "treeName": "10_20_106_1_Lieberman_Misezhnikov"
      }
    ],
    "parentDeviceNames": {
      "originalName": "Lieberman",
      "treeName": "Lieberman"
    },
    "managementDevice": false
  }
]

Response examples 2

[
  {
    "childrenDevicesNames": [
      {
        "originalName": "10_20_106_1",
        "treeName": "10_20_106_1"
      }
    ],
    "managementDevice": true
  }
]