Zabbix Documentation 2.2

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

User Tools

Site Tools


Sidebar

manual:api:reference:graphprototype:exists

graphprototype.exists

Description

boolean graphprototype.exists(object filter)

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

Parameters

(object) Criteria to search by.

The following parameters are supported as search criteria.

Parameter Type Description
host string/array Technical names of the hosts that the graph prototypes belong to.
hostids string/array IDs of the hosts that the graph prototypes belong to.
name string/array Names of the graph prototypes.
node string Name of the node the graph prototypes must belong to.

This will override the nodeids parameter.
nodeids string/array ID of the node the graph prototypes must belong to.

Return values

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

Examples

Checking a graph prototype on a host

Check if graph prototype “Disk space usage {#FSNAME}” exists on host “Zabbix server”.

Request:

{
    "jsonrpc": "2.0",
    "method": "graphprototype.exists",
    "params": {
        "name": "Disk space usage {#FSNAME}",
        "host": "Zabbix server"
    },
    "auth": "3a57200802b24cda67c4e4010b50c065",
    "id": 1
}

Response:

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

Source

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