This is the documentation page for an unsupported version of Zabbix.
Is this not what you were looking for? Switch to the current version or choose one from the drop-down menu.

hostgroup.exists

Description

boolean hostgroup.exists(object filter)

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

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

Parameters

(object) Criteria to search by.

The following parameters are supported as search criteria.

Parameter Type Description
groupid string/array Host group IDs.
name string/array Names of the host groups.

Return values

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

Examples

Check host group by name

Check if a host group called "Zabbix servers" exists.

Request:

{
           "jsonrpc": "2.0",
           "method": "hostgroup.exists",
           "params": {
               "name": "Linux servers"
           },
           "auth": "3a57200802b24cda67c4e4010b50c065",
           "id": 1
       }
Copy
✔ Copied

Response:

{
           "jsonrpc": "2.0",
           "result": true,
           "id": 1
       }
Copy
✔ Copied

See also

Source

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

To toggle search highlight, press Ctrl+Alt+H
Have an improvement suggestion for this page? Select the text that could be improved and press Ctrl+Enter to send it to the editors.