xUML Runtime API Reference
Find below a list of resources that can be accessed via the xUML Runtime API. All resources refer to base path /api.
xUML Service
Resource | Method | Description | API Version | Runtime Version |
---|---|---|---|---|
| GET | Check if the xUML service is ready. A success HTTP code indicated readiness, an error HTTP code indicates startup still in progress. | 1.2.0 | Runtime 2021.6 |
| PUT | Fire the service shutdown activity. | 1.1.0 | Runtime 2020.13 |
| PUT | Fire the service startup activity. | 1.1.0 | Runtime 2020.13 |
| PUT | Fire the scheduler event (without checking the conditions). | 1.1.0 | Runtime 2020.13 |
| PUT | Fire the timer event (without checking the conditions). | 1.1.0 | Runtime 2020.13 |
| PUT | Fire the event (without checking the conditions). | 1.1.0 | Runtime 2020.13 |
| GET | Check if the xUML service uses persistent state and get general information on the persistent state configuration. | 1.0.0 | Runtime 2019.5 |
| GET | Get the status of the persistent state server. | 1.0.0 | Runtime 2019.5 |
| PUT | Stop the running xUML service. | 1.0.0 | Runtime 2019.5 |
Logging
Resource | Method | Description | API Version | Runtime Version |
---|---|---|---|---|
| GET | List all configured log channels. | 1.1.0 | Runtime 2020.1 |
| GET | List all configured sinks of a channel. | 1.1.0 | Runtime 2020.1 |
| PUT | Replace all filters of the given sink. | 1.1.0 | Runtime 2020.1 |
| GET | List filters on a given sink. | 1.1.0 | Runtime 2020.1 |
| POST | Create a new filter. | 1.1.0 | Runtime 2020.1 |
| DELETE | Remove the filter with the given number. | 1.1.0 | Runtime 2020.1 |
| GET | Retrieve the filter with the given number from the given sink. | 1.1.0 | Runtime 2020.1 |
| PUT | Change the filter with the given number. | 1.1.0 | Runtime 2020.1 |
Persistent State
Persistent State Classes
Resource | Method | Description | API Version | Runtime Version |
---|---|---|---|---|
| GET | List all available persistent state classes. | 1.0.0 | Runtime 2019.5 |
| GET | Get the persistent state object/state counters for a given class. | 1.0.0 | Runtime 2019.5 |
| GET | Get the persistent state metadata of a given class. | 1.0.0 | Runtime 2019.5 |
Persistent State Objects
Resource | Method | Description | API Version | Runtime Version |
---|---|---|---|---|
| GET | Get the metadata of a given persistent state object. The object is identified by its ID. | 1.0.0 | Runtime 2019.5 |
DELETE | Delete a persistent state object by its ID. | 1.0.0 | Runtime 2019.5 | |
| GET | Get all pending events of a persistent state object. The object is identified by its ID. | 1.0.0 | Runtime 2019.5 |
| POST | Send a completion signal to a persistent state object. The object is identified by its ID and the state it is stalled in. | 1.0.0 | Runtime 2019.5 |
| GET | Get all states a persistent state object is in and possible transitions. The object is identified by its ID. | 1.0.0 | Runtime 2019.5 |
| POST | Globally, find persistent state objects matching the search criteria given by parameter. | 1.0.0 | Runtime 2019.5 |
Persistent State Objects of <class name>
Resource | Method | Description | API Version | Runtime Version |
---|---|---|---|---|
| GET | Find a persistent state object of a given class by its primary key. | 1.0.0 | Runtime 2019.5 |
| GET | Get the details of a persistent state object of a given class by its object ID. | 1.0.0 | Runtime 2019.5 |
| POST | Send the given signal to a persistent state object. The object is identified by its ID. | 1.0.0 | Runtime 2019.5 |
| POST | Find all persistent state objects matching the search criteria given by parameter. | 1.0.0 | Runtime 2019.5 |
Persistent State Owners
Resource | Method | Description | API Version | Runtime Version |
---|---|---|---|---|
| GET | Get a list of all persistent state owners and some details on the xUML services and objects they own. | 1.0.0 | Runtime 2019.5 |
Peristent State Events
Resource | Method | Description | API Version | Runtime Version |
---|---|---|---|---|
| GET | Get the details of a given persistent state event. | 1.0.0 | Runtime 2019.5 |
Asynchronous Tracing
The API of asynchronous tracing allows to manage the trace settings and trace data of a service.
A classifier in this context is a model element that can be traced.
An identifier in this context identifies the recorded trace data.
You can clear all tracing of a service by performing
DELETE on
/trace/configurations/
to remove all active traces.DELETE on
/trace/identifiers/
to remove all trace data.
Resource | Method | Description | API Version | Runtime Version |
---|---|---|---|---|
| GET | List all asynchronous trace configurations of this service. | 1.1.0 | Runtime 2020.14 |
| POST | Insert a new asynchronous trace configuration to this service. | 1.1.0 | Runtime 2020.14 |
| DELETE | Remove all asynchronous trace configurations for this service. | 1.1.0 | Runtime 2020.14 |
| GET | List all asynchronous trace configurations for the given classifier. | 1.1.0 | Runtime 2020.14 |
| PUT | Replace the asynchronous trace configuration of the given classifier. | 1.1.0 | Runtime 2020.14 |
| DELETE | Remove all asynchronous trace configurations for the given classifier. | 1.1.0 | Runtime 2020.14 |
| GET | List all available trace identifiers of the the given classifier. | 1.1.0 | Runtime 2020.14 |
| DELETE | Remove all trace identifiers of the the given classifier. | 1.1.0 | Runtime 2020.14 |
| DELETE | Remove the trace identifier with the given ID within the the given classifier. | 1.1.0 | Runtime 2020.14 |
| GET | Get the tracing data of the identifier with the given ID within the the given classifier as stored internally (raw data). | 1.1.0 | Runtime 2020.14 |
| GET | List all asynchronous trace identifiers of the service. | 1.1.0 | Runtime 2020.14 |
| DELETE | Remove all asynchronous trace identifiers of the service. | 1.1.0 | Runtime 2020.14 |