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:drule:exists

drule.exists

Description

boolean drule.exists(object filter)

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

Parameters

(object) Criteria to search by.

The following parameters are supported as search criteria.

Parameter Type Description
druleids string/array IDs of discovery rules.
name string/array Names of discovery rules.
node string Name of the node the discrovery rules must belong to.

This will override the nodeids parameter.
nodeids string/array IDs of the nodes the discrovery rules must belong to.

Return values

(boolean) Returns true if at least one discrovery rule that matches the given filter criteria exists.

Examples

Check a discovery rule by name

Check if a discovery rule called “Local network” exists.

Request:

{
    "jsonrpc": "2.0",
    "method": "drule.exists",
    "params": {
        "name": "Local network"
    },
    "auth": "3a57200802b24cda67c4e4010b50c065",
    "id": 1
}

Response:

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

See also

Source

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