The Data Center Expert Device web service exposes information about devices being monitored by a Data Center Expert server, and some device control functionality. Third-party applications can also access this monitored device data. Device control is supplied for select devices.
Once an application has obtained device data through the Devices web service, it can use other Data Center Expert web services to get alarm, device group, and sensor information about the devices.
The following methods are available through the Device web service. These methods only return information about devices the caller has permission to access.
getAllDevices
Returns a list of ISXCDevice objects that represent devices being monitored by the Data Center Expert server.
Service: ISXCentralDeviceService
Parameter | Type | Description |
---|---|---|
locale (optional) | String | The unique identifier of a device being monitored by the Data Center Expert server. |
getDeviceByID
Returns an ISXCDevice object that represents a device being monitored by the Data Center Expert server, identified by the specified ID.
Service: ISXCentralDeviceService
Parameter | Type | Description |
---|---|---|
ISXCElementID | String | The unique identifier of a device being monitored by the Data Center Expert server. |
locale (optional) | String |
Specifies the locale results are translated into before being returned. The default value is the locale configured in the Data Center Expert. |
getDeviceByIPAddress
Returns an ISXCDevice object that represents a device being monitored by the Data Center Expert server, identified by the specified IP address.
Service: ISXCentralDeviceService
Parameter | Type | Description |
---|---|---|
ipAddress | String |
The IP address of a device being monitored by the Data Center Expert server. |
locale (optional) | String |
Specifies the locale results are translated into before being returned. The default value is the locale configured in the Data Center Expert. |
getDeviceByHostName
Returns an ISXCDevice object that represents a device being monitored by the Data Center Expert server, identified by the specified host name.
Service: ISXCentralDeviceService
Parameter | Type | Description |
---|---|---|
hostName | String |
The host name of a device being monitored by the Data Center Expert server. |
locale (optional) | String |
Specifies the locale results are translated into before being returned. The default value is the locale configured in the Data Center Expert. |
getDevicesByType
Returns a list of ISXCDevice objects that represent devices being monitored by the Data Center Expert server and are of the specified device type.
Service: ISXCentralDeviceService
Parameter | Type | Description |
---|---|---|
deviceType | ISXCDeviceType |
One of the valid device type identifiers for devices that can be monitored by the Data Center Expert server. |
locale (optional) | String |
Specifies the locale results are translated into before being returned. The default value is the locale configured in the Data Center Expert. |
getDevicesBySerialNumber
Returns a list of ISXCDevice objects that represent devices being monitored by the Data Center Expert server and have the specified serial number.
Service: ISXCentralDeviceService
Parameter | Type | Description |
---|---|---|
serialNumber | String |
The serial number of one of the devices being monitored by the Data Center Expert server. For NetBotz devices, the “virtual” parent device inherits the serial number of the child enclosure device, hence the need to return a list of devices. |
locale (optional) | String |
Specifies the locale results are translated into before being returned. The default value is the locale configured in the Data Center Expert. |
getDevicesByModelNumber
Returns a list of ISXCDevice objects that represent devices being monitored by the Data Center Expert server and have the specified model number.This method is currently not functional, so will return no devices.
Service: ISXCentralDeviceService
Parameter | Type | Description |
---|---|---|
modelNumber | String |
The model number of one or more of the devices being monitored by the Data Center Expert server. For NetBotz devices, the “virtual” parent device inherits the serial number of the child enclosure device, hence the need to return a list of devices. |
locale (optional) | String |
Specifies the locale results are translated into before being returned. The default value is the locale configured in the Data Center Expert. |
getDevicesByModelName
Returns a list of ISXCDevice objects that represent devices being monitored by the Data Center Expert server and have the specified model name.
Service: ISXCentralDeviceService
Parameter | Type | Description |
---|---|---|
modelName | String |
The model name of one or more of the devices being monitored by the Data Center Expert server. |
locale (optional) | String |
Specifies the locale results are translated into before being returned. The default value is the locale configured in the Data Center Expert. |
getChildDevices
Returns a list of ISXCDevice objects that represent any devices being managed by the device with the specified ID.
Service: ISXCentralDeviceService
Parameter | Type | Description |
---|---|---|
ISXCElementID | String |
The unique identifier of a device being monitored by the Data Center Expert server. |
locale (optional) | String |
Specifies the locale results are translated into before being returned. The default value is the locale configured in the Data Center Expert. |
getParentDevice
Returns an ISXCDevice object that represents a device managing the device with the specified ID.
Service: ISXCentralDeviceService
Parameter | Type | Description |
---|---|---|
ISXCElementID | String |
The unique identifier of a device being monitored by the Data Center Expert server. |
locale (optional) | String |
Specifies the locale results are translated into before being returned. The default value is the locale configured in the Data Center Expert. |
getDeviceControlTypes
Returns a list of ISXCDeviceControlType objects that represent a grouping of a particular type of device control (example: Outlet Control).
Service: ISXCentralDeviceService
Parameter | Type | Description |
---|---|---|
locale (optional) | String |
Specifies the locale results are translated into before being returned. The default value is the locale configured in the Data Center Expert. |
getControllableDevicesByControlType
Returns a list of ISXCDevice objects that represent devices being monitored by the Data Center Expert server and have controls of the specified type.
Service: ISXCentralDeviceService
Parameter | Type | Description |
---|---|---|
controlTypeID | String |
Specifies the control type ID used to identify a control type. |
locale (optional) | String |
Specifies the locale results are translated into before being returned. The default value is the locale configured in the Data Center Expert. |
getDeviceControlsForDevice
Returns a list of ISXCDeviceControl objects representing the device controls, of the specified type, supplied by this device.
Service: ISXCentralDeviceService
Parameter | Type | Description |
---|---|---|
ISXCElementIDForDevice | String |
Specifies the unique identifier of a device being monitored by the Data Center Expert server. |
controlTypeID | String |
Specifies the control type ID used to identify a control type. |
locale (optional) | String |
Specifies the locale results are translated into before being returned. The default value is the locale configured in the Data Center Expert. |
setDeviceControlByID
Set the value of a device control. Note: This method does not supply a response.
Service: ISXCentralDeviceService
Parameter | Type | Description |
---|---|---|
ISXCElementIDForDevice | String |
The unique identifier of a device being monitored by the Data Center Expert server. |
controlTypeID | String |
Specifies the control type ID used to identify a control type. |
locale (optional) | String |
Specifies the locale results are translated into before being returned. The default value is the locale configured in the Data Center Expert. |
0 comments
Please sign in to leave a comment.