trigger.exists
Description
boolean trigger.exists(object filter)
This method checks if at least one trigger that matches the given filter criteria exists.
Parameters
(object) Criteria to search by.
The following parameters are supported as search criteria.
| Parameter | Type | Description |
|---|---|---|
| expression (required) |
string | Exploded trigger expression. |
| host (required) |
string/array | Technical names of the hosts the triggers must belong to. |
| hostid (required) |
string/array | IDs of the hosts the triggers must belong to. |
| description | string/array | Names of the triggers. |
| node | string | Name of the node the triggers must belong to.
This will override the |
| nodeids | string/array | IDs of the nodes the triggers must belong to. |
Only one of the three parameters is required:
host, hostid or expression.
Return values
(boolean) Returns true if at least one trigger that matches the given filter criteria exists.
Examples
Check a trigger by expression
Check if a trigger with the given expression exists.
Request:
{ "jsonrpc": "2.0", "method": "trigger.exists", "params": { "expression": "{Linux server:vfs.file.cksum[/etc/passwd].diff(0)}>0" }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 }
Response:
{ "jsonrpc": "2.0", "result": true, "id": 1 }
See also
Source
CTrigger::exists() in frontends/php/api/classes/CTrigger.php.
Data source: Zabbix