Приложение 1. Справочные комментарии

Обозначение

Типы данных

API Zabbix поддерживает следующие типы данных в качестве входных данных:

Поведение свойств

Некоторые свойства объекта помечены короткими метками, описывающими их поведение. Используются следующие метки:

• только для чтения - значение свойства устанавливается автоматически и не может быть задано или изменено пользователем, даже в некоторых особых условиях (например, только для чтения для унаследованных или обнаруженных объектов);
• только для записи - значение свойства может быть задано, но после этого к нему нельзя получить доступ;
• постоянное - значение свойства можно задать при создании объекта, но нельзя изменить позже;
• поддерживается - значение свойства не обязательно задавать, но его можно задавать в некоторых особых условиях (например, поддерживается, если type установлено в "Simple check", "External check", "SSH agent", "TELNET agent" или "HTTP agent"); однако обратите внимание, что свойства с меткой поддерживается все равно могут быть установлены в значения по умолчанию независимо от условий;
• обязательное - значение свойства обязательно должно быть задано для всех операций (кроме операций получения) или в некоторых особых условиях (например, обязательное для операций создания; обязательное, если operationtype установлено в "global script" и opcommand_hst не задано).

Свойства, не помеченные метками, являются необязательными.

Поведение параметров

Некоторые параметры операции помечены короткими метками, описывающими их поведение для операции. Используются следующие метки:

• только для чтения - значение параметра устанавливается автоматически и не может быть задано или изменено пользователем, даже в некоторых особых условиях (например, только для чтения для унаследованных объектов или обнаруженных объектов);
• только для записи - значение параметра можно задать, но после этого к нему нельзя получить доступ;
• поддерживается - значение параметра не требуется задавать, но его можно задавать в некоторых особых условиях (например, поддерживается, если operating_mode объекта прокси установлен в "passive proxy"); однако обратите внимание, что параметры со статусом поддерживается всё равно могут быть установлены в значения по умолчанию независимо от условий;
• обязательный - значение параметра должно быть задано.

Параметры, не помеченные метками, являются необязательными.

Зарезервированное значение ID равное "0"

Зарезервированное значение ID "0" можно использовать для фильтрации элементов и удаления связанных объектов. Например, для удаления ссылки на прокси с узла сети, proxytid необходимо задать значением 0 ("proxyid": "0") или для фильтрации узлов сети наблюдаемых сервером, опция proxyids должна быть задана значением 0 ("proxyids": "0").

Общие параметры методов "get"

Следующие параметры поддерживаются всеми методами get:

Флаги происхождения сущности

Методы получения возвращают свойство flags для сущностей, связанных с низкоуровневым обнаружением (LLD-правило/прототип LLD-правила, элемент данных/прототип элемента данных и т. д.). Это свойство полезно для обозначения того, была ли сущность обнаружена или нет, поскольку возможности редактирования для обнаруженных сущностей ограничены.

Свойство flags возвращает результат на основе комбинации (операция "+") следующих значений:

Комбинированное значение, возвращаемое свойством flags, может быть следующим:

Примеры

Проверка прав пользователя

Имеет ли пользователь разрешение на запись на хосты, имена которых начинаются с "MySQL" или "Linux"?

Запрос:

{
    "jsonrpc": "2.0",
    "method": "host.get",
    "params": {
        "countOutput": true,
        "search": {
            "host": ["MySQL", "Linux"]
        },
        "editable": true,
        "startSearch": true,
        "searchByAny": true
    },
    "id": 1
}

Ответ:

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

Подсчет несоответствий

Подсчитать количество хостов, имена которых не содержат подстроку "ubuntu"

Запрос:

{
    "jsonrpc": "2.0",
    "method": "host.get",
    "params": {
        "countOutput": true,
        "search": {
            "host": "ubuntu"
        },
        "excludeSearch": true
    },
    "id": 1
}

Ответ:

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

Поиск хостов по подстановочным знакам

Найти хосты, имя которых содержит слово «server» и имеют интерфейсные порты «10050» или «10071». Отсортировать результат по имени хоста в порядке убывания и ограничьте его до 5 хостов.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "host.get",
    "params": {
        "output": ["hostid", "host"],
        "selectInterfaces": ["port"],
        "filter": {
            "port": ["10050", "10071"]
        },
        "search": {
            "host": "*server*"
        },
        "searchWildcardsEnabled": true,
        "searchByAny": true,
        "sortfield": "host",
        "sortorder": "DESC",
        "limit": 5
    },
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "hostid": "50003",
            "host": "WebServer-Tomcat02",
            "interfaces": [
                {
                    "port": "10071"
                }
            ]
        },
        {
            "hostid": "50005",
            "host": "WebServer-Tomcat01",
            "interfaces": [
                {
                    "port": "10071"
                }
            ]
        },
        {
            "hostid": "50004",
            "host": "WebServer-Nginx",
            "interfaces": [
                {
                    "port": "10071"
                }
            ]
        },
        {
            "hostid": "99032",
            "host": "MySQL server 01",
            "interfaces": [
                {
                    "port": "10050"
                }
            ]
        },
        {
            "hostid": "99061",
            "host": "Linux server 01",
            "interfaces": [
                {
                    "port": "10050"
                }
            ]
        }
    ],
    "id": 1
}

Поиск хостов с использованием подстановочных знаков с «preservekeys»

Если к предыдущему запросу добавить параметр «preservekeys», то результат возвращается в виде ассоциативного массива, где ключами являются id объектов.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "host.get",
    "params": {
        "output": ["hostid", "host"],
        "selectInterfaces": ["port"],
        "filter": {
            "port": ["10050", "10071"]
        },
        "search": {
            "host": "*server*"
        },
        "searchWildcardsEnabled": true,
        "searchByAny": true,
        "sortfield": "host",
        "sortorder": "DESC",
        "limit": 5,
        "preservekeys": true
    },
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "50003": {
            "hostid": "50003",
            "host": "WebServer-Tomcat02",
            "interfaces": [
                {
                    "port": "10071"
                }
            ]
        },
        "50005": {
            "hostid": "50005",
            "host": "WebServer-Tomcat01",
            "interfaces": [
                {
                    "port": "10071"
                }
            ]
        },
        "50004": {
            "hostid": "50004",
            "host": "WebServer-Nginx",
            "interfaces": [
                {
                    "port": "10071"
                }
            ]
        },
        "99032": {
            "hostid": "99032",
            "host": "MySQL server 01",
            "interfaces": [
                {
                    "port": "10050"
                }
            ]
        },
        "99061": {
            "hostid": "99061",
            "host": "Linux server 01",
            "interfaces": [
                {
                    "port": "10050"
                }
            ]
        }
    },
    "id": 1
}