object event.acknowledge(object/array parameters)
This method allows to update events. Following update actions can be performed:
Only trigger events can be updated.
Only problem events can be updated.
Read/Write rights for trigger are required to close the event or to change event's severity.
To close event, it should be allowed in trigger.
(object/array) Parameters containing the IDs of the events and update operations that should be performed.
|string/object||IDs of the events to acknowledge.|
|integer||Event update action(s). This is bitmask field, any combination of values are acceptable.
1 - close problem;
2 - acknowledge event;
4 - add message;
8 - change severity.
|message||string||Text of the message.
Required, if action contains 'add message' flag.
|severity||integer||New severity for events.
Required, if action contains 'change severity' flag.
0 - not classified;
1 - information;
2 - warning;
3 - average;
4 - high;
5 - disaster.
(object) Returns an object containing the IDs of the updated events under the
Acknowledge a single event and leave a message.
Change multiple event's severity and leave a message.
CEvent::acknowledge() in frontends/php/include/classes/api/services/CEvent.php.