Table of Contents
> Trigger object
The following objects are directly related to the trigger API.
Trigger
The trigger object has the following properties.
| Property | Type | Description |
|---|---|---|
| triggerid | string | (readonly) ID of the trigger. |
| description (required) |
string | Name of the trigger. |
| expression (required) |
string | Reduced trigger expression. |
| comments | string | Additional comments to the trigger. |
| error | string | (readonly) Error text if there have been any problems when updating the state of the trigger. |
| flags | integer | (readonly) Origin of the trigger. Possible values are: 0 - (default) a plain trigger; 4 - a discovered trigger. |
| lastchange | timestamp | (readonly) Time when the trigger last changed its state. |
| priority | integer | Severity of the trigger. Possible values are: 0 - (default) not classified; 1 - information; 2 - warning; 3 - average; 4 - high; 5 - disaster. |
| status | integer | Whether the trigger is enabled or disabled. Possible values are: 0 - (default) enabled; 1 - disabled. |
| templateid | string | (readonly) ID of the parent template trigger. |
| type | integer | Whether the trigger can generate multiple problem events. Possible values are: 0 - (default) do not generate multiple events; 1 - generate multiple events. |
| url | string | URL associated with the trigger. |
| value | integer | (readonly) Whether the trigger is in OK or problem state. Possible values are: 0 - (default) OK; 1 - problem. |
| value_flags | integer | (readonly) Whether the trigger is currently in an unknown state. Possible values are: 0 - (default) trigger state is up to date; 1 - current trigger state is unknown. |