Это перевод страницы документации с английского языка. Помогите нам сделать его лучше.

triggerprototype.create

Описание

object triggerprototype.create(объект/массив triggerPrototypes)

Этот метод позволяет создавать новые прототипы триггеров.

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

Параметры

(объект/массив) Создаваемые прототипы триггеров.

В дополнение к стандартным свойствам прототипа триггеров, этот метод принимает следующие параметры.

Параметр Тип Описание
dependencies массив Триггеры и прототипы триггеров, от которых будет зависеть создаваемый прототип триггеров.

У триггеров должно быть задано свойство triggerid.
tags массив Теги прототипа триггеров.

Выражение триггера необходимо указывать в раскрытой форме и оно должно содержать по крайней мере один прототип элементов данных.

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

(объект) Возвращает объект, который содержит ID созданных прототипов триггеров под свойством triggerids. Порядок возвращаемых ID совпадает с порядком переданных прототипов триггеров.

Примеры

Создание прототипа триггеров

Создание прототипа триггеров для определения, когда на файловой системе останется менее чем 20% свободного места на диске.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "triggerprototype.create",
           "params": {
               "description": "Free disk space is less than 20% on volume {#FSNAME}",
               "expression": "{Zabbix server:vfs.fs.size[{#FSNAME},pfree].last()}<20",
               "tags": [
                   {
                       "tag": "volume",
                       "value": "{#FSNAME}"
                   },
                   {
                       "tag": "type",
                       "value": "{#FSTYPE}"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": {
               "triggerids": [
                   "17372"
               ]
           },
           "id": 1
       }

Источник

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