triggerprototype.get

Описание

integer/array triggerprototype.get(параметры объекта)

Метод позволяет получать прототипы триггеров по заданным параметрам.

Этот метод доступен пользователям любого типа. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.

Параметры

(объект) Параметры задают желаемый вывод.

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

Параметр	Тип	Описание
active	флаг	Возврат только активированных прототипов триггеров, которые принадлежат узлам сети под наблюдением.
applicationids	строка/массив	Возврат только тех прототипов триггеров, которые содержат элементы данных из заданных групп элементов данных.
discoveryids	строка/массив	Возврат только тех прототипов триггеров, которые принадлежат заданным правилам LLD.
functions	строка/массив	Возврат только тех прототипов триггеров, которые используют заданные функции. Обратитесь к странице поддерживаемых функций триггеров для получения списка поддерживаемых функций.
group	строка	Возврат только тех прототипов триггеров, которые принадлежат узлам сети из группы узлов сети с заданным именем.
groupids	строка/массив	Возврат только тех прототипов триггеров, которые принадлежат узлам сети из заданных групп узлов сети.
host	строка	Возврат только тех прототипов триггеров, которые принадлежат узлу сети с заданным именем.
hostids	строка/массив	Возврат только тех прототипов триггеров, которые принадлежат заданным узлам сети.
inherited	логический	Если задано значение `true`, возвращать только те прототипы триггеров, которые унаследованы из шаблона.
maintenance	логический	Если задано значение `true`, возвращать только активированные прототипы триггера, которые принадлежат узлам сети в обслуживании.
min_severity	целое число	Возврат только тех прототипов триггеров, у которых важность больше или равна заданной важности.
monitored	флаг	Возврат только активированных прототипов триггеров, которые принадлежат узлам сети под наблюдением и содержат только активированные элементы данных.
templated	логический	Если задано значение `true`, возвращать только те прототипы триггеров, которые принадлежат шаблонам.
templateids	строка/массив	Возврат только тех прототипов триггеров, которые принадлежат заданным шаблонам.
triggerids	строка/массив	Возврат прототипов триггеров только с заданными ID.
expandExpression	флаг	Раскрытие функций и макросов в выражении триггера.
selectDiscoveryRule	запрос	Возврат LLD правила, которому принадлежит прототип триггеров.
selectFunctions	запрос	Возврат функций, которые используются в прототипе триггеров, в свойстве `functions`. Объект функции представляет собой функции, которые используются в выражении триггера, и имеет следующие свойства: `functionid` - (строка) ID функции; `itemid` - (строка) ID элемента данных, который используется в функции; `function` - (строка) имя функции; `parameter` - (строка) переданный параметр в функцию.
selectGroups	запрос	Возврат групп узлов сети, которым принадлежит прототип триггеров, в свойстве `groups`.
selectHosts	запрос	Возврат узлов сети, которым принадлежит прототип триггеров, в свойстве `hosts`.
selectItems	запрос	Возврат элементов данных и прототипов элементов данных, которые содержатся в прототипе триггеров, в свойстве `items`.
selectDependencies	запрос	Возврат прототипов триггеров и триггеров, от которых зависит прототип триггеров, в свойстве `dependencies`.
selectTags	запрос	Возврат тегов прототипа триггеров в свойстве `tags`.
filter	объект	Возврат только тех результатов, которые в точности соответствуют заданному фильтру. Принимает массив, где ключи являются именами свойств и значения, которые являются либо одним значением, либо массивом сопоставляемых значений. Поддерживает дополнительные фильтры: `host` - техническое имя узла сети, которому принадлежит прототип триггеров; `hostid` - ID узла сети, которому принадлежит прототип триггеров.
limitSelects	целое число	Ограничение количества записей, возвращаемых подзапросами. Применимо только к следующим подзапросам: `selectHosts` - результаты сортируются по `host`.
sortfield	строка/массив	Сортировка результата в соответствии с заданными свойствами. Возможные значения: `triggerid`, `description`, `status` и `priority`.
countOutput	логический	Эти параметры являются общими для всех методов `get` и они описаны в справочных комментариях.
editable	логический
excludeSearch	логический
limit	целое число
output	запрос
preservekeys	логический
search	объект
searchByAny	логический
searchWildcardsEnabled	логический
sortorder	строка/массив
startSearch	логический

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

(целое число/массив) Возвращает либо:

· массив объектов;
· количество извлеченных объектов, если использовался параметр countOutput.

Примеры

Получение прототипов триггеров с правила LLD

Получение всех прототипов триггеров и их функций с правила LLD.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "triggerprototype.get",
           "params": {
               "output": "extend",
               "selectFunctions": "extend",
               "discoveryids": "22450"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "functions": [
                       {
                           "functionid": "12598",
                           "itemid": "22454",
                           "function": "last",
                           "parameter": "0"
                       }
                   ],
                   "triggerid": "13272",
                   "expression": "{12598}<20",
                   "description": "Free inodes is less than 20% on volume {#FSNAME}",
                   "url": "",
                   "status": "0",
                   "priority": "2",
                   "comments": "",
                   "templateid": "0",
                   "type": "0",
                   "flags": "2",
                   "recovery_mode": "0",
                   "recovery_expression": "",
                   "correlation_mode": "0",
                   "correlation_tag": "",
                   "manual_close": "0"
               },
               {
                   "functions": [
                       {
                           "functionid": "13500",
                           "itemid": "22686",
                           "function": "last",
                           "parameter": "0"
                       }
                   ],
                   "triggerid": "13266",
                   "expression": "{13500}<201",
                   "description": "Free disk space is less than 20% on volume {#FSNAME}",
                   "url": "",
                   "status": "0",
                   "priority": "2",
                   "comments": "",
                   "templateid": "0",
                   "type": "0",
                   "flags": "2",
                   "recovery_mode": "0",
                   "recovery_expression": "",
                   "correlation_mode": "0",
                   "correlation_tag": "",
                   "manual_close": "0"
               }
           ],
           "id": 1
       }

Получение заданного прототипа триггеров с тегами