Method: searchDevices

Description

The searchDevices operation takes one or more query parameters and returns the matching devices. If no specific query parameters are provided in the <queryParams> element, all active CLIENT and SERVER devices are returned. You can use <responseConfig> to limit which fields are returned; however, searchDevices returns host identifier and last modified information only if no response configuration is specified. There are certain details that the searchDevices operation does not return; if more details are required for any of the devices found, use getDevice to retrieve them.

The optional SortBys element enables sorting of the devices returned by searchDevices.

Note: Although the WSDL allows the use of multiple sortBy elements, searchDevices currently only supports sorting by a single key.

Note: By default, a search for devices by device owner (account ID or account name) also returns devices that are not owned by the account specified in the search, if the device has add-on license entitlements mapped from the account specified in the search. If you want to limit the results to devices owned by the account specified in the search, select the configuration option Limit device search by device owner (available in the Producer Portal under System > Configure > FlexNet Operations > Embedded Device Settings).

Parameters

Name	Type	Direction	Description
msgparameters	searchDevicesRequestType	Input

Returns

A searchDevicesResponse element having the structure defined by the following table.

Name	Type	Description
statusInfo	OpsEmbeddedStatusInfoType	See OpsEmbeddedStatusInfoType.
failed	failedSearchDevicesData	See failedSearchDevicesData.
devices	searchDevicesResponseData	See searchDevicesResponseData.