Sidebar

manual:api:reference:graph:exists

graph.exists

Description

boolean graph.exists(object filter)

This method checks if at least one graph 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 graphs belong to.
hostids string/array IDs of the hosts that the graphs belong to.
name string/array Names of the graphs.
node string Name of the node the graphs must belong to.

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

Return values

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

Examples

Checking graph by name

Check if a graph named “CPU utilization” already exists on host “Zabbix server”.

Request:

{
    "jsonrpc": "2.0",
    "method": "graph.exists",
    "params": {
        "name": "CPU utilization",
        "host": "Zabbix server"
    },
    "auth": "3a57200802b24cda67c4e4010b50c065",
    "id": 1
}

Response:

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

Source

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