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` parameter.
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
       }

Source

CTrigger::exists() in frontends/php/api/classes/CTrigger.php.

Documentation