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

Параметры

(object) Параметры, определяющие желаемый вывод.

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

Параметр	Тип	Описание
active	flag	Возвращать только включённые прототипы триггеров, принадлежащие отслеживаемым узлам сети.
discoveryids	ID/array	Возвращать только прототипы триггеров, принадлежащие указанным правилам LLD.
functions	string/array	Возвращать только триггеры, использующие указанные функции. Список поддерживаемых функций см. на странице Поддерживаемые функции.
group	string	Возвращать только прототипы триггеров, принадлежащие узлам сети или шаблонам из групп узлов сети или групп шаблонов с указанным именем.
groupids	ID/array	Возвращать только прототипы триггеров, принадлежащие узлам сети или шаблонам из указанных групп узлов сети или групп шаблонов.
host	string	Возвращать только прототипы триггеров, принадлежащие узлам сети с указанным именем.
hostids	ID/array	Возвращать только прототипы триггеров, принадлежащие указанным узлам сети.
inherited	boolean	Если установлено в `true`, возвращать только прототипы триггеров, унаследованные от шаблона.
maintenance	boolean	Если установлено в `true`, возвращать только включённые прототипы триггеров, принадлежащие узлам сети, находящимся на обслуживании.
min_severity	integer	Возвращать только прототипы триггеров с важностью больше или равной указанной важности.
monitored	flag	Возвращать только включённые прототипы триггеров, принадлежащие отслеживаемым узлам сети и содержащие только включённые элементы данных.
templated	boolean	Если установлено в `true`, возвращать только прототипы триггеров, принадлежащие шаблонам.
templateids	ID/array	Возвращать только прототипы триггеров, принадлежащие указанным шаблонам.
triggerids	ID/array	Возвращать только прототипы триггеров с указанными ID.
expandExpression	flag	Разворачивать функции и макросы в выражении триггера.
selectDependencies	query	Возвращать прототипы триггеров и триггеры, от которых зависит прототип триггера, в свойстве `dependencies`.
selectDiscoveryData	query	Возвращать свойство `discoveryData` с данными объекта обнаружения прототипа триггера. Объект обнаружения прототипа триггера связывает обнаруженный прототип триггера с прототипом триггера, из которого он был обнаружен. Он имеет следующие свойства: `parent_triggerid` - `(ID)` ID прототипа триггера, из которого был создан прототип триггера; `status` - `(int)` статус обнаружения прототипа триггера: 0 - (по умолчанию) прототип триггера обнаружен, 1 - прототип триггера больше не обнаруживается; `ts_delete` - `(timestamp)` время, когда прототип триггера, который больше не обнаруживается, будет удалён; `ts_disable` - `(timestamp)` время, когда прототип триггера, который больше не обнаруживается, будет отключён; `disable_source` - `(int)` индикатор того, был ли прототип триггера отключён правилом LLD или вручную: 0 - (по умолчанию) отключён автоматически, 1 - отключён правилом LLD.
selectDiscoveryRule	query	Возвращать правило LLD, которому принадлежит прототип триггера, в свойстве `discoveryRule`.
selectDiscoveryRulePrototype	query	Возвращать свойство `discoveryRulePrototype` с родительским прототипом правила LLD, которому принадлежит прототип триггера.
selectFunctions	query	Возвращать функции, используемые в прототипе триггера, в свойстве `functions`. Объекты функций представляют функции, используемые в выражении триггера, и имеют следующие свойства: `functionid` - `(ID)` ID функции; `itemid` - `(ID)` ID элемента данных, используемого в функции; `function` - `(string)` имя функции; `parameter` - `(string)` параметр, передаваемый функции. Параметр запроса заменяется символом `$` в возвращаемой строке.
selectHostGroups	query	Возвращать группы узлов сети, которым принадлежит прототип триггера, в свойстве `hostgroups`.
selectHosts	query	Возвращать узлы сети, которым принадлежит прототип триггера, в свойстве `hosts`.
selectInheritedTags	query	Возвращать свойство `inheritedTags` с тегами, унаследованными от шаблонов, связанных шаблонов и узлов сети, а также от прототипов элементов данных, на которые есть ссылки в выражениях триггера или восстановления.
selectItems	query	Возвращать элементы данных и прототипы элементов данных, используемые прототипом триггера, в свойстве `items`.
selectTags	query	Возвращать теги прототипа триггера в свойстве `tags`.
selectTemplateGroups	query	Возвращать группы шаблонов, которым принадлежит прототип триггера, в свойстве `templategroups`.
filter	object	Возвращать только те результаты, которые точно соответствуют указанному фильтру. Принимает объект, где ключи — это имена свойств, а значения — либо одно значение, либо массив значений для сопоставления. Не поддерживает свойства типа данных `text` data type. Поддерживает дополнительные свойства: `host` - техническое имя узла сети, которому принадлежит прототип триггера; `hostid` - ID узла сети, которому принадлежит прототип триггера.
limitSelects	integer	Ограничивает количество записей, возвращаемых подзапросами. Применяется к следующим подзапросам: `selectHosts` - результаты будут отсортированы по `host`.
sortfield	string/array	Сортировать результат по указанным свойствам. Возможные значения: `triggerid`, `description`, `status`, `priority`, `discovered`.
countOutput	boolean	Эти параметры описаны в справочном комментарии.
editable	boolean
excludeSearch	boolean
limit	integer
output	query
preservekeys	boolean
search	object
searchByAny	boolean
searchWildcardsEnabled	boolean
sortorder	string/array
startSearch	boolean

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

(integer/array) Возвращает одно из следующего:

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

Примеры

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

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

Запрос:

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

Ответ:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "triggerid": "13272",
            "expression": "{12598}<20",
            "description": "Свободных inode менее 20% на томе {#FSNAME}",
            "url": "",
            "status": "0",
            "value": "0",
            "priority": "2",
            "lastchange": "0",
            "comments": "",
            "error": "",
            "templateid": "0",
            "type": "0",
            "state": "0",
            "flags": "2",
            "recovery_mode": "0",
            "recovery_expression": "",
            "correlation_mode": "0",
            "correlation_tag": "",
            "manual_close": "0",
            "opdata": "",
            "discover": "0",
            "event_name": "",
            "uuid": "6ce467d05e8745409a177799bed34bb3",
            "url_name": "",
            "functions": [
                {
                    "functionid": "12598",
                    "itemid": "22454",
                    "triggerid": "13272",
                    "parameter": "$",
                    "function": "last"
                }
            ]
        },
        {
            "triggerid": "13266",
            "expression": "{13500}<20",
            "description": "Свободное место на диске менее 20% на томе {#FSNAME}",
            "url": "",
            "status": "0",
            "value": "0",
            "priority": "2",
            "lastchange": "0",
            "comments": "",
            "error": "",
            "templateid": "0",
            "type": "0",
            "state": "0",
            "flags": "2",
            "recovery_mode": "0",
            "recovery_expression": "",
            "correlation_mode": "0",
            "correlation_tag": "",
            "manual_close": "0",
            "opdata": "",
            "discover": "0",
            "event_name": "",
            "uuid": "74a1fc62bfe24b7eabe4e244c70dc384",
            "url_name": "",
            "functions": [
                {
                    "functionid": "13500",
                    "itemid": "22686",
                    "triggerid": "13266",
                    "parameter": "$",
                    "function": "last"
                }
            ]
        }
    ],
    "id": 1
}

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

Запрос:

{
    "jsonrpc": "2.0",
    "method": "triggerprototype.get",
    "params": {
        "output": [
            "triggerid",
            "description"
        ],
        "selectTags": "extend",
        "triggerids": [
            "17373"
        ]
    },
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "triggerid": "17373",
            "description": "Свободное место на диске меньше 20% на томе {#FSNAME}",
            "tags": [
                {
                    "tag": "volume",
                    "value": "{#FSNAME}"
                },
                {
                    "tag": "type",
                    "value": "{#FSTYPE}"
                }
            ]
        }
    ],
    "id": 1
}

См. также

Источник

CTriggerPrototype::get() в ui/include/classes/api/services/CTriggerPrototype.php.

What’s next?

triggerprototype.update

Docs

triggerprototype.get

Описание