item.exists

Описание

логическое item.exists(объект фильтр)

Этот метод проверяет соответствует ли по крайней мере один элемент данных заданному фильтром критерию.

Параметры

(объект) Критерий по которому производить поиск.

Критериями поиска поддерживатся следующие параметры.

Параметр Тип Описание
key_
(требуется)		 строка/массив Ключи элементов данных.
host строка/массив Имена узлов сети, которым должны принадлежать элементы данных.
hostid строка/массив ID узлов сети, которым должны принадлежать элементы данных.
node строка Имя ноды, которой должны принадлежать элементы данных.

Этот параметр переписывает параметр nodeids.
nodeids строка/массив ID нод, которым должны принадлежать элементы данных.

Возвращаемые значения

(логическое) Возвращает true, если имеется по крайней мере один элемент данных, который соответствует заданному фильтром критерию.

Примеры

Проверка элемента данных по ключу

Проверка имеется ли элемент данных с ключем "vm.memory.size[available]" у узла сети "Linux Server."

Запрос:

{
    "jsonrpc": "2.0",
    "method": "item.exists",
    "params": {
        "host": "Linux Server",
        "key_": "vm.memory.size[available]"
    },
    "auth": "3a57200802b24cda67c4e4010b50c065",
    "id": 1
}

Ответ:

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

Смотрите также

Исходный код

CItem::exists() в frontends/php/api/classes/CItem.php.