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 |