BrightSign Network Web API Reference Manual v.3.8 - Manual (Page 129)

117
not positive, then the method will return the maximum allowed number of objects. Attempting to request more
objects than is allowed will lead to the same result, but without an error.
List<Device> GetSpecifiedDevices(int[] deviceIds)
Description
Retrieves a list of
Device instances matching the specified identifiers. The list is sorted by device serial number. The
identifiers of nonexistent Device instances will be ignored.
Required Permissions
Device: View Devices
Parameters
•
[Int[]] deviceIds: An array of [int] Id values for the Device instances being requested. The number of
items is limited to 100 by the server. Attempting to request more than the maximum allowed number of objects will
cause an error, while passing an empty array will lead to an immediate empty response without an error.
PagedList<Device> FindDevices(string namePattern, string marker, int pageSize)
Description
Retrieves the next page of a
Device list containing names matched with the specified pattern. The returned list is
organized by [string] Serial and may not contain more items than the defined page size.
Required Permissions
Device: View Devices
Parameters
•
[string] namePattern: The exact [string] Name of the Device instance (or its wildcard-based pattern).
Supported wildcards currently include “*”, “?”, and “[‘and’]”.
• [string] marker: The [string] Serial of the last Device instance on the previous page. If the value is Null,
then the method will retrieve the first page.