DCE web services API
Link copied. Please paste this link to share this article on your social media post.
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.
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
Link copied. Please paste this link to share this article on your social media post.
Hello, I tried to get the information
Application version and Mac address of a device but i can't find it in the API. Is the info available or not?
Create your free account or log in to subscribe to the forum - and gain access to more than 10,000+ support articles along with insights from experts and peers.