xUML Runtime API Reference
BRIDGE 7
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  |