Data Center Expert Web Services API

[EcoStruxureIT]

Data Center Expert version 8.1.0 introduced the public DCE REST API.

Instructions are available at https://<server_address>/isxg/rest

The Data Center Expert web services API is vendor-neutral, scalable monitoring software that collects, organizes, and distributes critical alerts, surveillance video, and key information. It provides a unified view of complex physical infrastructure environments from anywhere on the network.

Manage your APC devices from a single system by forwarding SNMP traps (events) to your preferred enterprise management system.

Device Access, Authentication and Permissions

Data Center Expert web services supports basic authentication over HTTP or HTTPS (SSL).

User credentials (username/password) must be provided for every web service method invocation; the concept of a single-login-session is not supported. The credentials used must belong to a valid Data Center Expert user account configured on the Data Center Expert server being queried.

The permissions configured on the Data Center Expert server for the user account can affect the contents of web service query responses. Responses to web service queries will only contain references to devices and other entities that the user account has been granted permission to access.

Localization and Internationalization

Most of the methods specified in the Data Center Expert web service interface accept a locale parameter which may affect the representation of data returned by those methods. In all instances, a locale is specified as a string in the format “xx-YY” where xx represents a two letter language identifier (in compliance with ISO-639 language codes) and YY represents a two letter country identifier (in compliance with ISO-3166 country codes).

Note: If no locale (null) or an unsupported locale is specified in a method call, the current server locale configuration is assumed.

If a specified locale has a language code that matches the language code of a supported locale, even though the country codes may not match, the supported locale will be used.

Supported locales in Data Center Expert

• US English (en-US)
• Japanese (ja-JP)
• Korean (ko-KR)
• Simplified Chinese (zh-CN)
• Russian (ru-RU)
• Brazilian Portuguese (pt-BR)
• French (fr-FR)
• Spanish (es-ES)
• Italian (it-IT)
• German (de-DE)

Web Service Description Language Files

Web services often employ one or more Web Service Description Language (WSDL) files to describe, in a standardized format, the methods of a web service interface and the data passed to and from those methods.

WSDL files can be used by client application developers to generate “stub” code for invoking the methods of a particular web service. There are a large number of publicly available WSDL-to-code generators. WSDL files can also be used at run-time to format data sent to, or validate received from, a web service method.

Data Center Expert server provides access to separate WSDL files.

Sensor Service Methods	ISXCentralAlarmsService_v2_0
Device Groups Service Methods	ISXCentralDeviceGroupService_v2_0
Device Service Methods	ISXCentralDeviceService_v2_0
Alarms Service Methods	ISXCentralSensorService_v2_0

The Data Center Expert server publishes WSDL files at this URL:

http://<server>/integration/services/<WSDL>?wsdl

This URL returns dynamically generated WSDL files, guaranteeing the files reflect the version of the Data Center Expert software currently installed on the server. Access to this URL requires authentication credentials of a valid Data Center Expert user. Note the “?” in the URL.

Note: The dynamically generated WSDL contains references to the server from which it was obtained. In the static WSDL, server references are replaced with the string “SERVER_REPLACE_ME”.