> Trigger object

The following objects are directly related to the trigger API.

Trigger

The trigger object has the following properties.

PropertyTypeDescription
triggeridstring(readonly) ID of the trigger.
description
(required)
stringName of the trigger.
expression
(required)
stringReduced trigger expression.
event_namestringEvent name generated by the trigger.
opdatastringOperational data.
commentsstringAdditional description of the trigger.
errorstring(readonly) Error text if there have been any problems when updating the state of the trigger.
flagsinteger(readonly) Origin of the trigger.

Possible values are:
0 - (default) a plain trigger;
4 - a discovered trigger.
lastchangetimestamp(readonly) Time when the trigger last changed its state.
priorityintegerSeverity of the trigger.

Possible values are:
0 - (default) not classified;
1 - information;
2 - warning;
3 - average;
4 - high;
5 - disaster.
stateinteger(readonly) State of the trigger.

Possible values:
0 - (default) trigger state is up to date;
1 - current trigger state is unknown.
statusintegerWhether the trigger is enabled or disabled.

Possible values are:
0 - (default) enabled;
1 - disabled.
templateidstring(readonly) ID of the parent template trigger.
typeintegerWhether the trigger can generate multiple problem events.

Possible values are:
0 - (default) do not generate multiple events;
1 - generate multiple events.
urlstringURL associated with the trigger.
valueinteger(readonly) Whether the trigger is in OK or problem state.

Possible values are:
0 - (default) OK;
1 - problem.
recovery_modeintegerOK event generation mode.

Possible values are:
0 - (default) Expression;
1 - Recovery expression;
2 - None.
recovery_expressionstringReduced trigger recovery expression.
correlation_modeintegerOK event closes.

Possible values are:
0 - (default) All problems;
1 - All problems if tag values match.
correlation_tagstringTag for matching.
manual_closeintegerAllow manual close.

Possible values are:
0 - (default) No;
1 - Yes.
uuidstringUniversal unique identifier, used for linking imported triggers to already existing ones. Used only for triggers on templates. Auto-generated, if not given.

For update operations this field is readonly.

Trigger tag

The trigger tag object has the following properties.

PropertyTypeDescription
tag
(required)
stringTrigger tag name.
valuestringTrigger tag value.