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

403
The user is not authorized to call this service.
500
An internal error occurred.