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 |
---|
/isAlive | 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 | /hooks/shutdown/fire | PUT | Fire the service shutdown activity. | 1.1.0 | Runtime 2020.13 |
/hooks/startup/fire | PUT | Fire the service startup activity. | 1.1.0 | Runtime 2020.13 |
/scheduler/events/{schedulerName}/fire | PUT | Fire the scheduler event (without checking the conditions). | 1.1.0 | Runtime 2020.13 |
/timer/events/{timerName}/fire | PUT | Fire the timer event (without checking the conditions). | 1.1.0 | Runtime 2020.13 |
/timer/events/{eventObserverActivity}/fire | PUT | Fire the event (without checking the conditions). | 1.1.0 | Runtime 2020.13 |
/pstate/engine | GET | Check if the xUML service uses persistent state and get general information on the persistent state configuration. | 1.0.0 | Runtime 2019.5
|
/status | GET | Get the status of the persistent state server. | 1.0.0 | Runtime 2019.5 |
/stop | PUT | Stop the running xUML service. | 1.0.0 | Runtime 2019.5 |
Logging
Resource | Method | Description | API Version | Runtime Version |
---|
/log/channels/ | GET | List all configured log channels. | 1.1.0 | Runtime 2020.1
|
/log/channels/{channel}/sinks | GET | List all configured sinks of a channel. | 1.1.0 | Runtime 2020.1 |
/log/channels/{channel}/sinks/{sink}/filters | PUT | Replace all filters of the given sink. | 1.1.0 | Runtime 2020.1 |
/log/channels/{channel}/sinks/{sink}/filters/ | GET | List filters on a given sink. | 1.1.0 | Runtime 2020.1 |
/log/channels/{channel}/sinks/{sink}/filters/ | POST | Create a new filter. | 1.1.0 | Runtime 2020.1 |
/log/channels/{channel}/sinks/{sink}/filters/{filterNum} | DELETE | Remove the filter with the given number. | 1.1.0 | Runtime 2020.1 |
/log/channels/{channel}/sinks/{sink}/filters/{filterNum} | GET | Retrieve the filter with the given number from the given sink. | 1.1.0 | Runtime 2020.1 |
/log/channels/{channel}/sinks/{sink}/filters/{filterNum} | PUT | Change the filter with the given number. | 1.1.0 | Runtime 2020.1 |
Persistent State
Multiexcerpt include |
---|
SpaceWithExcerpt | INTERNAL |
---|
MultiExcerptName | pstate_control_adapter |
---|
PageWithExcerpt | INTERNAL:_bridge_excerpts |
---|
|
Persistent State Classes
Resource | Method | Description | API Version | Runtime Version |
---|
/pstate/classes/ | GET | List all available persistent state classes. | 1.0.0 | Runtime 2019.5 |
/pstate/classes/{class} | GET | Get the persistent state object/state counters for a given class. | 1.0.0 | Runtime 2019.5 |
/pstate/classes/{class}/meta | 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 |
/pstate/objects/{objectId}
GET | Get the metadata of a given persistent state object. The object is identified by its ID. | 1.0.0 | Excerpt Include |
---|
| ADMIN:xUML Runtime API Reference |
---|
| ADMIN:xUML Runtime API Reference |
---|
nopanel | true |
---|
|
Runtime 2019.5 | DELETE | Delete a persistent state object by its ID. | 1.0.0 | Runtime 2019.5 |
/pstate/objects/{objectId}/events | GET | Get all pending events of a persistent state object. The object is identified by its ID. | 1.0.0 | Runtime 2019.5 |
/pstate/objects/{objectId}/signals/completion | 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 |
/pstate/objects/{objectId}/states | 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 |
/pstate/queryObjects | 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 |
---|
/pstate/classes/<class name>/object | GET | Find a persistent state object of a given class by its primary key. | 1.0.0 | Runtime 2019.5 |
/pstate/classes/<class name>/objects/{objectId} | GET | Get the details of a persistent state object of a given class by its object ID. | 1.0.0 | Runtime 2019.5 |
/pstate/classes/<class name>/ objects/{objectId}/signals/<signal name> | POST | Send the given signal to a persistent state object. The object is identified by its ID. | 1.0.0 | Runtime 2019.5 |
/pstate/classes/<class name>/queryObjects | 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 |
---|
/pstate/owners/ | 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 |
---|
/pstate/events/{eventId} | 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 |
---|
/trace/configurations/ | GET | List all asynchronous trace configurations of this service. | 1.1.0 | Runtime 2020.14 |
/trace/configurations/ | POST | Insert a new asynchronous trace configuration to this service. | 1.1.0 | Runtime 2020.14 |
/trace/configurations/ | DELETE | Remove all asynchronous trace configurations for this service. | 1.1.0 | Runtime 2020.14 |
/trace/configurations/{classifier} | GET | List all asynchronous trace configurations for the given classifier. | 1.1.0 | Runtime 2020.14 |
/trace/configurations/{classifier} | PUT | Replace the asynchronous trace configuration of the given classifier. | 1.1.0 | Runtime 2020.14 |
/trace/configurations/{classifier} | DELETE | Remove all asynchronous trace configurations for the given classifier. | 1.1.0 | Runtime 2020.14 |
/trace/configurations/{classifier}/identifiers/ | GET | List all available trace identifiers of the the given classifier. | 1.1.0 | Runtime 2020.14 |
/trace/configurations/{classifier}/identifiers/ | DELETE | Remove all trace identifiers of the the given classifier. | 1.1.0 | Runtime 2020.14 |
/trace/configurations/{classifier}/identifiers/{id} | DELETE | Remove the trace identifier with the given ID within the the given classifier. | 1.1.0 | Runtime 2020.14 |
/trace/configurations/{classifier}/identifiers/{id}/raw | 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 |
/trace/identifiers/ | GET | List all asynchronous trace identifiers of the service. | 1.1.0 | Runtime 2020.14 |
/trace/identifiers/ | DELETE | Remove all asynchronous trace identifiers of the service. | 1.1.0 | Runtime 2020.14