Query events
GET {{baseUrl}}/events?size=20&page=0&filter=<json>&sort=<json>&history=false&includeShared=false&enablePageCache=false
Returns events based on the request parameters. If no typeId
is given in the filter expression then MindsphereStandardEvent
typed events (and its descendants excluding descendant specific fields) will be returned.
\ Note: Clients must always expect incompleteness of the list of returned events, as internal processing is limited by eventual consistency.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
size | number | Specifies the number of elements in a page. Default is 20, minimum is 1 , maximum is 500. | |
page | number | Specifies the requested page index. Default is 0 | |
filter | string | description: | |
Filter parameter (JSON) encoded format. Events can be filtered by the following fields |
timestamp
typeId
correlationId
entityId
code
severity
source
acknowledged
assetTypeId
parentAssetId
- Other custom filters, based on filterable field in custom EventType can also be used.
Following conditions apply for filtering events,
- If
timestamp
is not provided in the filter, the events from the 7 days will be filtered for by default. - The
timestamp
property can be filtered bybefore
,after
andbetween
functions. - Multiple
typeId
expressions (by using and, or logical operators) in filter parameter is not allowed. Only equality function is supported on it. - Filtering with typeId having
BaseEvent
is not supported. If typeId is missing from filter expression thenMindsphereStandardEvent
typed (including) descendants - polymorphic query) events will be returned. - Negation of
typeId
in filter expression is not allowed. - If there are multiple events that have the same
correlationId
,entityId
andtypeId
then only the latest one will be present in the returning list of events ifhistory
is false (false is default value). - Negation of
assetTypeId
in filter expression is not allowed. - Only equality and IN function (with max 5 values) in filter are allowed with
assetTypeId
. - Negation of 'parentAssetId' in filter expression is not allowed.
- Only equality function in filter is allowed with
parentAssetId
. | |sort
| string | | Order in which events are returned. Supported only on filterable fields. Default istimestamp
descending order | |history
| boolean | | Optional paramater, if we want to retrieve the history of an event which is based on using the same correlationID, entityID, typeID. If the latest event instance in a history of an event is deleted then the history of the event will be deleted. | |includeShared
| boolean | | To specify if received event or eventTypes should be consider for the API operation. | |enablePageCache
| boolean | | To specify if page caching is enabled or not. This property enables faster fetching of events from multiple pages for same filter criteria. |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
If-None-Match | string | ETag hash of previous request to allow caching | |
Accept | string |
RESPONSES
status: OK
{"_embedded":{"events":[{"id":"urn:uuid:d48fa919-ca2f-af45-9db5-f10ef55f884c","typeId":"sit dolor Duis","correlationId":"50ffd539-3f7b-0e67-505a-8afe306246ee","timestamp":"quis nostrud ea","entityId":"a3909fa6-98e4-2732-ed9c-b2bd769295a6","etag":-93404448,"_links":{"self":{"href":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}},"sharing":{"modes":[{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}]},"severity":49,"description":"do adipisicing non ut","code":"ut","source":"nostrud velit magna","acknowledged":true},{"id":"urn:uuid:3e21b369-74a3-f027-7cbe-9c715bb339a1","typeId":"ex","correlationId":"21536f85-ec40-d6f6-57c6-c8b37460b91b","timestamp":"pariatur elit aliqua conseq","entityId":"595526f7-6ff7-12cc-ec65-6cfacec25c5d","etag":-1326454,"_links":{"self":{"href":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}},"sharing":{"modes":[{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}]},"severity":11,"description":"anim","code":"ipsum es","source":"reprehenderit ut aliquip","acknowledged":true}]},"_links":{"first":{"href":"http://VoHhARxLCuoPigGwXKuKCfZnDq.ayswn,hb0dWQQhgv"},"self":{"href":"https://SfTwqKJYB.sjpmHf","templated":true},"next":{"href":"https://qxweCNcJneeWNG.ajfwtUKnPlyQ4c4t64vy,19izBjMmE7pFmMSKoL.-"},"prev":{"href":"http://prlGtLszuFCPsIzYDUStsHIZWc.ecnseYhGQLGlXHjKWb,5iczxR77.J.xuQ5SDyul8QuG0c,n"},"last":{"href":"http://jEHHWMVqyBisVwRZYy.muSJds,9qwUMWfVes,tc9xt.o2cS"}},"page":{"size":16928505,"totalElements":61473582,"totalPages":26192063,"number":-25228288}}