Overview

Universal Controller supports the following RESTful-based web services for Cluster Nodes, which are listed alphabetically on this page.

Formatting specifications for each web service, including details about parameter requirements, are provided.

List All Cluster Nodes

	Description

	Description
URI	http://host_name/uc/resources/clusternode/list
HTTP Method	GET
Description	Retrieves information on all Cluster Nodes.
Example URI	http://localhost:8080/uc/resources/clusternode/list
Consumes Content-Type	n/a
Produces Content-Type	application/xml, application/json
Example Response	See List All Cluster Nodes: XML and JSON Examples.
Properties	See List All Cluster Nodes: Properties.

XML	JSON

XML

JSON

<clusterNodes> <clusterNode> <buildDate>12-18-2017_0529</buildDate> <buildId>build.development</buildId> <hostName>asus-pc</hostName> <ipAddress>192.168.1.21</ipAddress> <nodeId>asus-pc:8501-uc</nodeId> <nodeMode>Active</nodeMode> <nodeStart>2017-12-18 18:40:25</nodeStart> <nodeTs>2017-12-19 09:55:46</nodeTs> <nodeUptime>54920</nodeUptime> <nodeUptimeDisplay>15 Hours 15 Minutes 20 Seconds</nodeUptimeDisplay> <paused>false</paused> <pausedForMaintenance/> <relId>6.4.3.0</relId> <syslId>3a5385a3f6df47cb8eb7a2e29845d55b</syslId> </clusterNode> <clusterNode> <buildDate>12-18-2017_0629</buildDate> <buildId>build.development</buildId> <hostName>atut-pc</hostName> <ipAddress>192.168.1.22</ipAddress> <nodeId>asus-pc:8502-uc</nodeId> <nodeMode>Active</nodeMode> <nodeStart>2017-12-18 19:40:25</nodeStart> <nodeTs>2017-12-19 10:55:46</nodeTs> <nodeUptime>54930</nodeUptime> <nodeUptimeDisplay>16 Hours 15 Minutes 20 Seconds</nodeUptimeDisplay> <paused>false</paused> <pausedForMaintenance/> <relId>6.4.3.0</relId> <syslId>3a5385a3f6df47cb8eb7a2e29845d55c</syslId> </clusterNode> </clusterNodes>

[ { "buildDate": "12-18-2017_0529", "buildId": "build.18", "hostName": "Mark-4", "ipAddress": "192.168.1.21", "nodeId": "Mark-4:8080-uc6", "nodeMode": "Active", "nodeStart": "2017-12-18 18:40:25", "nodeTs": "2017-12-19 09:55:46", "nodeUptime": 54920, "nodeUptimeDisplay": "15 Hours 15 Minutes 20 Seconds", "paused": false, "pausedForMaintenance": null, "relId": "6.4.3.0", "syslId": "93ac346868fc4171a514d1d0b02487e1" }, { "buildDate": "12-18-2017_0629", "buildId": "build.18", "hostName": "Mark-5", "ipAddress": "192.168.1.22", "nodeId": "Mark-5:8080-uc6", "nodeMode": "Active", "nodeStart": "2017-12-18 19:40:25", "nodeTs": "2017-12-19 10:55:46", "nodeUptime": 54930, "nodeUptimeDisplay": "16 Hours 15 Minutes 20 Seconds", "paused": false, "pausedForMaintenance": null, "relId": "6.4.3.0", "syslId": "93ac346868fc4171a514d1d0b02487e2" } ]

Property	UI Field Name	Description

Property	UI Field Name	Description
`buildDate`	Build Date	Build date for this cluster node.
`buildId`	Build Id	Build ID for this cluster node.
`hostName`	Host Name	IP address or domain/name of the host machine where the cluster node resides.
`ipAddress`	IP Address	IP address of this cluster node.
`nodeId`	Node Id	URL of the cluster node.
`nodeMode`	Mode	Current mode of the cluster node.
`nodeStart`	Start Time	Date and time this cluster node was last started.
`nodeTs`	Timestamp	Date and time of the last heartbeat of this cluster node.
`nodeUptime`	n/a	`nodeUptimeDisplay` (in seconds).
`nodeUptimeDisplay`	Uptime	Amount of time this cluster node has been running.
`paused`	Paused	Indication that the Controller has been paused.
`pausedForMaintenance`	n/a	Deprecated. Indication that the Controller has been paused for maintenance.
`relId`	Release	Release number for this cluster node.
`sysId`	n/a	System ID field in the database for this cluster node record.

	Description

	Description
URI	http://host_name/uc/resources/clusternode/info
HTTP Method	GET
Description	Retrieves information on the current Cluster Node.
Example URI	http://localhost:8080/uc/resources/clusternode/info
Consumes Content-Type	n/a
Produces Content-Type	application/xml, application/json
Response Example	See Read Current Cluster Node: XML and JSON Examples.
Properties	See List All Cluster Nodes: Properties.