Zabbix Documentation 2.0

2.23.04.04.2 (current)In development:4.4 (devel)Unsupported:1.82.02.43.23.4

User Tools

Site Tools


Sidebar

manual:appendix:api:trigger:exists

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
}

See also

Source

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