trigger.exists

Description

boolean trigger.exists(object filter)

This method checks if at least one trigger that matches the given filter criteria exists.

This method is deprecated and will be removed in the future. Please use trigger.get instead.

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.

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"
           },
           "auth": "3a57200802b24cda67c4e4010b50c065",
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": true,
           "id": 1
       }

Source

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

Documentation