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.