Runtimes (GET)
Retrieves metadata for the list of runtimes.
Roles
Users in the following roles are authorized to perform this operation:
- worklightadmin
- worklightdeployer
- worklightmonitor
- worklightoperator
Method
GET
Path
/management-apis/1.0/runtimes
Example
https://www.example.com/worklightadmin/management-apis/1.0/runtimes?fullInfo=true&locale=de_DE&mode=db
Query Parameters
Query parameters are optional.
- fullInfo
- The default value false returns basic list of properties of a runtime, while the value true returns all properties of this runtime (see a GET on a single runtime for the complete list of properties).
- locale
- The locale used for error messages.
- mode
- The default mode running retrieves only the running runtimes, while the mode db retrieves also the runtimes stored in the database that might not be running.
Produces
application/json, application/xml, text/xml
Response
The metadata for the list of runtimes.
JSON Example
{
"productVersion" : "7.0.0",
"projects" : [
{
"auditEnabled" : true,
"link" : "https://www.example.com/worklightadmin/management-apis/1.0/runtimes/myruntime",
"name" : "myruntime",
"numberOfActiveDevices" : 100,
"numberOfAdapters" : 1,
"numberOfApplications" : 1,
"numberOfDecommisionedDevices" : 5,
"running" : true,
"synchronizationStatus" : "ok",
"topology" : "STANDALONE",
},
...
],
}
XML Example
<?xml version="1.0" encoding="UTF-8"?>
<projectconfiguration productVersion="7.0.0">
<projects>
<project
auditEnabled="true"
link="https://www.example.com/worklightadmin/management-apis/1.0/runtimes/myruntime"
name="myruntime"
numberOfActiveDevices="100"
numberOfAdapters="1"
numberOfApplications="1"
numberOfDecommisionedDevices="5"
running="true"
synchronizationStatus="ok"
topology="STANDALONE"/>
...
</projects>
</projectconfiguration>
Response Properties
The response has the following properties:
- productVersion
- The exact product version.
- projects
- The array of runtimes.
The runtime has the following properties:
- auditEnabled
- Whether audit is enabled.
- link
- The URL to access detail information about the runtime.
- name
- The name of the runtime. This is the context root of the runtime web application, without the leading slash.
- numberOfActiveDevices
- The number of active devices using this runtime.
- numberOfAdapters
- The number of adapters deployed in this runtime.
- numberOfApplications
- The number of applications deployed in this runtime.
- numberOfDecommisionedDevices
- The number of devices decommissioned for this runtime.
- running
- Whether the runtime is currently active or has stopped.
- synchronizationStatus
- The status of the nodes of the runtime. Can contain the values "ok" if all nodes of the runtime are running without error, "synchronizing" if some node is in progress of synchronizing, or an error message if some nodes failed to synchronize.
- topology
- Server topology. Can contain the values "STANDALONE", "CLUSTER" or "FARM"
Errors
403The user is not authorized to call this service.
500
An internal error occurred.