Skip to main content
Version: v5.0

Notification Service events

Overview#

In the Notification Service, event triggers are set up which listen to events and determine when to send a notification. This section provides a list of the events which are available to use.

Resource events#

Events are linked to resources. The actual type of the resource is indicated by the resource.type property.

The other properties shown for a given resource depend on the type.

Refer to the event listings later in this section for different services, indicating the resource types and the properties which are available.

Event filtering#

In an event type trigger, filtering on the properties of a incoming event is supported.

An event filter is of the form:

{  "filter": {    <property...>: <wildcard>  }}

For example, to match create events from the Item Service, the event filter would look like the code listing below.

{  "filter": {    "event": "resource.ResourceCreated",    "resource.type": "itemsvc.*"  }}

List of events#

These sections list the following types of events:

List of resource types#

These sections list the following resource types:

Common events#

resource.ResourceCreated#

A resource created event is emitted when a resource is created.

PropertyType
uuidUUID
resource
user
_idstring
timestamptimestamp
requestIdstring

Example event#

{    "event": "resource.ResourceCreated",    "uuid": "8f2792c7-b01a-4493-ba5a-d0588a4aad8e",    "resource": {        "type": "custom.Resource",        ...    }    "user": {        "id": "00b82755-b5e6-4c8b-a4cf-66bb4f697f17"    },    "requestId": "abe50236-cf30-435f-b7fc-c05cb8f0f320"
 }

resource.ResourceUpdated#

A resource updated event is emitted when a resource is changed.

PropertyType
uuidUUID
resource
user
_idstring
timestamptimestamp
requestIdstring

Example event#

{    "event": "resource.ResourceUpdated",    "uuid": "8f2792c7-b01a-4493-ba5a-d0588a4aad8e",    "resource": {        "type": "custom.Resource",        ...    }    "user": {        "id": "00b82755-b5e6-4c8b-a4cf-66bb4f697f17"    },    "requestId": "abe50236-cf30-435f-b7fc-c05cb8f0f320"
 }

resource.ResourceSoftDeleted#

A resource soft deleted event is emitted if a resource is marked for deletion but not yet permanently deleted.

Typically, a resource.ResourceHardDeleted event will follow a resource.ResourceSoftDeleted event. However, not all services support soft delete and in this case, only a resource.ResourceHardDeleted is emitted.

PropertyType
uuidUUID
resource
user
_idstring
timestamptimestamp
requestIdstring

Example event#

{    "event": "resource.ResourceSoftDeleted",    "uuid": "8f2792c7-b01a-4493-ba5a-d0588a4aad8e",    "resource": {        "type": "custom.Resource",        ...    }    "user": {        "id": "00b82755-b5e6-4c8b-a4cf-66bb4f697f17"    },    "requestId": "abe50236-cf30-435f-b7fc-c05cb8f0f320"
 }

resource.ResourceHardDeleted#

A resource hard deleted event is emitted if a resource is deleted permanently. This means is it either deleted with ?purge=true or otherwise deleted in a way that means it cannot be recovered.

PropertyType
uuidUUID
resource
user
_idstring
timestamptimestamp
requestIdstring

Example event#

{    "event": "resource.ResourceHardDeleted",    "uuid": "8f2792c7-b01a-4493-ba5a-d0588a4aad8e",    "resource": {        "type": "custom.Resource",        ...    }    "user": {        "id": "00b82755-b5e6-4c8b-a4cf-66bb4f697f17"    },    "requestId": "abe50236-cf30-435f-b7fc-c05cb8f0f320"
 }

Passport Service events#

passportsvc.Login#

A login event is emitted when a user logs into the Passport Service. This type of event is only emitted when a login is initiated through a user interface, for example, through a web page. It does not occur for requests that are only authenticated as a particular user.

PropertyType
uuidstring
user
_idstring
timestamptimestamp
requestIdstring

Example event#

{    "event": "passportsvc.Login",    "uuid": "8f2792c7-b01a-4493-ba5a-d0588a4aad8e",    "user": {        "id": "00b82755-b5e6-4c8b-a4cf-66bb4f697f17"    },    "requestId": "abe50236-cf30-435f-b7fc-c05cb8f0f320"
 }

passportsvc.Logout#

A logout event is emitted when a user logs outs of the Passport Service, for example, by clicking logout in the console.

PropertyType
uuidstring
user
_idstring
timestamptimestamp
requestIdstring

Example event#

{    "event": "passportsvc.Logout",    "uuid": "8f2792c7-b01a-4493-ba5a-d0588a4aad8e",    "user": {        "id": "00b82755-b5e6-4c8b-a4cf-66bb4f697f17"    },    "requestId": "abe50236-cf30-435f-b7fc-c05cb8f0f320"
 }

Workflow Service events#

workflowsvc.UserInput#

A user input event is emitted from a workflow at the point where a workflow requires user input.

This could be used to send a notification to the user that indicates they need to provide input in order to continue the workflow.

PropertyType
uuidstring
namespacesstring[]
notificationIdstring
urlstring
inputParamsmap
requestIdstring
timestamptimestamp

Example event#

{    "event": "workflowsvc.UserInput",    "uuid": "8f2792c7-b01a-4493-ba5a-d0588a4aad8e",    "notificationId": "00b82755-b5e6-4c8b-a4cf-66bb4f697f17",    "url": "http://example.com",    "inputParams": {        "some": "value",        "other": 1    },    "requestId": "abe50236-cf30-435f-b7fc-c05cb8f0f320" }

Resource types#

Passport Service resource types#

passportsvc.Application#

PropertyType
idstring
namespacesstring[]
configsmap
before/after
namestring
namespacesstring[]
configsmap
descriptionstring
userTypestring
shortNamestring[]
appOwnerstring

passportsvc.Namespace#

PropertyType
idstring
namespacesstring[]
before/after
namespacesstring[]

passportsvc.Organization#

PropertyType
idstring
namespacesstring[]
before/after
namestring
namespacesstring[]
descriptionstring

File Service resource types#

filesvc.File#

PropertyType
idstring
namespacesstring[]
fileTypestring
before/after
namestring
parentsstring[]
namespacesstring[]
fileTypestring
statusstring
tagsstring[]
tipVersioninteger

filesvc.FileVersion#

PropertyType
idstring
namespacesstring[]
fileTypestring
fieldstring
versioninteger
before/after
namestring
fieldstring
versioninteger
parentsstring[]
namespacesstring[]
fileTypestring
statusstring
tagsstring[]
sizeinteger

Item Service resource types#

itemsvc.NamedCompositeItem#

PropertyType
idstring
namespacesstring[]
userItemidstring
before/after
namestring
descriptionstring
userTypestring
shortNamestring
itemClassstring
kindstring
namespacesstring[]
tipVersioninteger

itemsvc.NamedCompositeItemVersion#

PropertyType
idstring
namespacesstring[]
userItemDbldstring
userItemIdstring
versioninteger
before/after
namespacesstring[]
userItemDbldstring
userItemIdstring
userTypestring
shortNamestring
itemClassstring
kindstring
namespacesstring[]
tipVersioninteger

itemsvc.NamedTelemetryCollectionVersion#

PropertyType
idstring
namespacesstring[]
userItemDbldstring
userItemIdstring
versioninteger
before/after
namespacesstring[]
userItemDbldstring
userItemIdstring
itemClassstring
versioninteger

itemsvc.NamedUserCollection#

PropertyType
idstring
namespacesstring[]
userItemIdstring
before/after
namestring
descriptionstring
userTypestring
shortNamestring
itemClassstring
kindstring
namespacesstring[]
tipversioninteger

itemsvc.NamedUserCollectionVersion#

PropertyType
idstring
namespacesstring[]
userItemDbIdstring
userItemIdstring
versioninteger
before/after
namespacesstring[]
userItemDbldstring
userItemIdstring
itemClassstring
versioninteger

itemsvc.SchemaDefinition#

PropertyType
idstring
namespacesstring[]
before/after
namestring
descriptionstring
userTypestring
shortNamestring
definitionstring
namespacesstring[]

itemsvc.Script#

PropertyType
idstring
namespacesstring[]
userItemIdstring
before/after
namestring
descriptionstring
userTypestring
shortNamestring
itemClassstring
kindstring
namespacesstring[]
tipVersioninteger

itemsvc.ScriptVersion#

PropertyType
idstring
namespacesstring[]
userItemDbIdstring
userItemIdstring
versioninteger
before/after
namespacesstring[]
userItemDbIdstring
userItemIdstring
itemClassstring
versioninteger

itemsvc.UserConfig#

PropertyType
idstring
namespacesstring[]
userItemIdstring
before/after
namestring
descriptionstring
userTypestring
shortNamestring
itemClassstring
kindstring
namespacesstring[]
tipVersioninteger

itemsvc.UserConfigVersion#

PropertyType
idstring
namespacesstring[]
userItemDbIdstring
userItemIdstring
versioninteger
before/after
namespacesstring[]
userItemDbIdstring
userItemIdstring
itemClassstring
versioninteger

Object Model Service resource types#

omapisvc.APIConfig#

PropertyType
idstring
namespacesstring[]
before/after
namestring
descriptionstring

Example:

{  "event": "resource.ResourceUpdated",  "resource": {     "type": "omapisvc.APIConfig",     "namespaces": ["X"],     "before": {         "name": "old name",         ...     },     "after": {        "name": "new name",        ...            },     ...  },  ... }

Datasources Service resource types#

datasources.Orchestrator#

PropertyType
idstring
namespacesstring[]
before/after
namestring
userTypestring
orchestratorClassstring

Example:

{  "event": "resource.ResourceUpdated",  "resource": {     "type": "datasources.Orchestrator",     "namespaces": ["X"],     "before": {         "name": "X",         ...     },     "after": {        "name": "Y",        ...            },     ...  },  ... }

datasources.OrchestratorRun#

PropertyType
idstring
namespacesstring[]
orchestratorIdstring
before/after
namespacesstring[]
orchestratorIdstring
statusstring

Example:

{  "event": "resource.ResourceUpdated",  "resource": {     "type": "datasources.OrchestratorRun",     "namespaces": ["X"],     "orchestratorId": "68a15d18-620c-4672-9e39-34106ed50b08"     "before": {         "status": "RUNNING",         ...     },     "after": {         "status": "COMPLETED",        ...            },     ...  },  ... }

datasources.OrchestratorSchedule#

PropertyType
idstring
namespacesstring[]
orchestratorIdstring
before/after
namespacesstring[]
orchestratorIdstring
runintervalstring

Example:

{  "event": "resource.ResourceUpdated",  "resource": {     "type": "datasources.OrchestratorSchedule",     "namespaces": ["X"],     "orchestratorId": "68a15d18-620c-4672-9e39-34106ed50b08",     "before": {         "runinterval": "* * * 0",         ...     },     "after": {         "runinterval": "* * * 1",        ...            },     ...  },  ... }