Next Topic

Previous Topic

Book Contents

device.list

Lists device information based on a search criterion. Using multiple search criteria is not supported.

device.list
["deviceName=<regexp>" | "deviceSerial=<value>"]
[, "tagN=<regexp>" ]
[, "parentNames=<value1,value2,...>" ]
[, "showLicenseCategory=<true|false>" ]
[, "licenseCategory=<ping|simple|network|enterprise|appserver|shypervisor|mhypervisor|lhypervisor|xlhypervisor|hypervisor|configmgmt>" ]

The output of device.list shows the current configuration settings for one or more devices. If any search criteria are provided, devices matching the value are included in the output. If the showLicenseCategory parameter is specified, the device's license classification is included as well. By default this information is omitted due to the additional queries that need to be performed to determine this information.

Example:

"serialNumber=520003", "deviceName=my_device_1", "address=172.21.8.25", [...]
"rediscoveryEnabled=true", "rediscoveryNewTestsAction=logOnly",
"rediscoveryUpdatedTestsAction=logOnly", "rediscoveryFrequency=720",
"rediscoveryDeletedTestsAction=logOnly"