> Объект действия

Следующие объекты напрямую связаны с action API.

Действие

Объект действия имеет следующие свойства.

Свойство	Тип	Описание
actionid	строка	(только чтение) ID действия.
esc_period (требуется)	строка	Длительность шага операции. Должно быть больше 60 секунд. Принимает секунды, единицы времени с суффиксом и пользовательские макросы.
eventsource (требуется)	целое число	(константа) Тип событий, которые будет обрабатывать действие. Обратитесь к свойству "source" событий для получения списка поддерживаемых типов событий.
name (требуется)	строка	Имя действия.
def_longdata	строка	Текст сообщения о проблеме.
def_shortdata	строка	Тема сообщения о проблеме.
r_longdata	строка	Текст сообщения о восстановлении.
r_shortdata	строка	Тема сообщения о восстановлении.
ack_longdata	строка	Текст сообщения о подтверждении.
ack_shortdata	строка	Тема сообщения о подтверждении.
status	целое число	Активировано ли действие или нет. Возможные значения: 0 - (по умолчанию) активировано; 1 - деактивировано.
pause_suppressed	целое число	Приостанавливать эскалацию в течении периодов обслуживания или нет. Возможные значения: 0 - Не приостанавливать эскалацию; 1 - (по умолчанию) Приостановить эскалацию.

Операция действия

Объект операции действия определяет операцию, которая будет выполнена при выполнении действия. Этот объект имеет следующие свойства.

Свойство	Тип	Описание
operationid	строка	(только чтение) ID операции действия.
operationtype (требуется)	целое число	Тип операции. Возможные значения: 0 - отправка сообщения; 1 - удаленная команда; 2 - добавление узла сети; 3 - удаление узла сети; 4 - добавление в группу узлов сети; 5 - удаление из группы узлов сети; 6 - присоединение шаблона; 7 - отсоединение от шаблона; 10 - установить режим инвентарных данных узла сети.
actionid	строка	ID действия, которому принадлежит операция.
esc_period	строка	Длительность шага эскалации в секундах. Должно быть больше 60 секунд. Принимает секунды, единицы времени с суффиксом и пользовательские макросы. Если задано равным 0 или 0s, будет использоваться период эскалации по умолчанию в действии. По умолчанию: 0s.
esc_step_from	целое число	Шаг начала эскалации. По умолчанию: 1.
esc_step_to	целое число	Шаг конца эскалации. По умолчанию: 1.
evaltype	целое число	Метод вычисления условия операции. Возможные значения: 0 - (по умолчанию) И / ИЛИ; 1 - И; 2 - ИЛИ.
opcommand	объект	Объект, который содержит данные о выполняемой команде в операции. Объект команды операции описан в деталях ниже. Требуется для операций с удаленной командой.
opcommand_grp	массив	Группы узлов сети на которых будут выполняться удаленные команды. Каждый объект имеет следующие свойства: `opcommand_grpid` - (строка, только чтение) ID объекта; `operationid` - (строка) ID операции; `groupid` - (строка) ID группы узлов сети. Требуется при операциях с удаленной командой, если не задано `opcommand_hst`.
opcommand_hst	массив	Узел сети на котором будут выполняться удаленные команды. Каждый объект имеет следующие свойства: `opcommand_hstid` - (строка, только чтение) ID объекта; `operationid` - (строка) ID операции; `hostid` - (строка) ID узла сети; если задано значение равное 0, команда будет выполняться на текущем узле сети. Требуется при операциях с удаленной командой, если не задано `opcommand_grp`.
opconditions	массив	Условия операции, которые используются для действий на триггеры. Объект условия операции детально описан ниже.
opgroup	массив	Группы узлов сети в которые будут добавлены узлы сети. Каждый объект имеет следующие свойства: `operationid` - (строка) ID операции; `groupid` - (строка) ID группы узлов сети. Требуется для операций "добавление в группу узлов сети" и "удаление из группы узлов сети".
opmessage	объект	Объект, который содержит данные об отправляемом сообщении в операции. Объект сообщения операции детально описан ниже. Требуется для операций с сообщениями.
opmessage_grp	массив	Группы пользователей которым будут отправляться сообщения. Каждый объект имеет следующие свойства: `operationid` - (строка) ID операции; `usrgrpid` - (строка) ID группы пользователей. Требуется при операциях с сообщениями, если не задано `opmessage_usr`.
opmessage_usr	массив	Пользователи которым будут отправляться сообщения. Каждый объект имеет следующие свойства: `operationid` - (строка) ID операции; `userid` - (строка) ID пользователя. Требуется при операциях с сообщениями, если не задано `opmessage_grp`.
optemplate	массив	Шаблоны к которым будет присоединён узел сети. Каждый объект имеет следующие свойства: `operationid` - (строка) ID операции; `templateid` - (строка) ID шаблона. Требуется для операций "присоединение шаблона" и "отсоединение от шаблона".
opinventory	объект	Режим инвентарных данных, который необходимо задать узлу сети. Объект имеет следующие свойства: `operationid` - (строка) ID операции; `inventory_mode` - (строка) Режим инвентарных данных. Требуется для операций "Установить режим инвентарных данных узлов сети".

Команда операции действия

Объект команды операции содержит данные о команде, которая будет выполнена операцией.

Свойство	Тип	Описание
operationid	строка	(только чтение) ID операции.
command (требуется)	строка	Выполняемая команда. Требуется, когда type IN (0,1,2,3)
type (требуется)	целое число	Тип команды операции. Возможные значения: 0 - пользовательский скрипт; 1 - IPMI; 2 - SSH; 3 - Telnet; 4 - глобальный скрипт.
authtype	целое число	Метод аутентификации, который используется при SSH командах. Возможные значения: 0 - пароль; 1 - публичный ключ. Требуется для SSH команд.
execute_on	целое число	Цель, на которой будет выполнен пользовательский скрипт команды операции. Возможные значения: 0 - Zabbix агент; 1 - Zabbix сервер; 2 - Zabbix сервер (прокси). Требуется для команд с пользовательским скриптом.
password	строка	Пароль, используемый для SSH команд с аутентификацией по паролю и для Telnet команд.
port	строка	Порт, используемый для команд SSH и Telnet.
privatekey	строка	Имя файла приватного ключа, который используется для SSH команд с аутентификацией по публичному ключу. Требуется для SSH команд с аутентификацией по публичному ключу.
publickey	строка	Имя файла публичного ключа, который используется для SSH команд с аутентификацией по публичному ключу Требуется для SSH команд с аутентификацией по публичному ключу.
scriptid	строка	ID скрипта, который используется в командах с глобальными скриптами. Требуется для команд с глобальным скриптом.
username	строка	Имя пользователя, которое используется для аутентификации. Требуется для команд SSH и Telnet.

Сообщение операции действия

Объект сообщения операции содержит данные о сообщении, которое будет отправлено операцией.

Свойство	Тип	Описание
operationid	строка	(только чтение) ID операции действия.
default_msg	целое число	Следует ли использовать текст и тему сообщения действия по умолчанию. Возможные значения: 0 - (по умолчанию) использование данных из операции; 1 - использование данных из действия.
mediatypeid	строка	ID способа оповещения, которое будет использоваться для отправки сообщения.
message	строка	Текст сообщения операции.
subject	строка	Тема сообщения операции.

Условие операции действия

Объект условия операции действия определяет условие, которое должно быть соблюдено для выполнения текущей операции. Этот объект имеет следующие свойства.

Свойство	Тип	Описание
opconditionid	строка	(только чтение) ID условия операции действия
conditiontype (требуется)	целое число	Тип условия. Возможные значения: 14 - событие подтверждено.
value (требуется)	строка	Значение с которым происходит сравнение.
operationid	строка	(только чтение) ID операции.
operator	целое число	Оператор условия. Возможные значения: 0 - (по умолчанию) =.

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

Условие	Имя условия	Поддерживаемые операторы	Ожидаемое значение
14	Событие подтверждено	=	Подтверждено ли событие. Возможные значения: 0 - не подтверждено; 1 - подтверждено.

Операция действия о восстановлении

Объект операции действия о восстановлении определяет операцию, которая будет выполнена когда проблема решена. Операции восстановления можно использовать для действий по триггерам и внутренним действиям. Этот объект имеет следующие свойства.

Свойство	Тип	Описание
operationid	строка	(только чтение) ID операции действия.
operationtype (требуется)	целое число	Тип операции. Возможные значения для действий на триггеры: 0 - отправка сообщения; 1 - удаленная команда; 11 - оповещать всех участников. Возможные значения для действий на внутренние события: 0 - отправка сообщения; 11 - оповещать всех участников.
actionid	строка	ID действия, которому принадлежит операция о восстановлении.
opcommand	массив	Объект, который содержит данные о выполняемой команде в операции о восстановлении. Объект команды операции описан в деталях выше. Требуется для операций с удаленной командой.
opcommand_grp	массив	Группы узлов сети на которых будут выполняться удаленные команды. Каждый объект имеет следующие свойства: `opcommand_grpid` - (строка, только чтение) ID объекта; `operationid` - (строка) ID операции; `groupid` - (строка) ID группы узлов сети. Требуется при операциях с удаленной командой, если не задано `opcommand_hst`.
opcommand_hst	массив	Узел сети на котором будут выполняться удаленные команды. Каждый объект имеет следующие свойства: `opcommand_hstid` - (строка, только чтение) ID объекта; `operationid` - (строка) ID операции; `hostid` - (строка) ID узла сети; если задано значение равное 0, команда будет выполняться на текущем узле сети. Требуется при операциях с удаленной командой, если не задано `opcommand_grp`.
opmessage	объект	Объект, который содержит данные об отправляемом сообщении в операции о восстановлении. Объект сообщения операции детально описан выше. Требуется для операций с сообщениями.
opmessage_grp	массив	Группы пользователей которым будут отправляться сообщения. Каждый объект имеет следующие свойства: `operationid` - (строка) ID операции; `usrgrpid` - (строка) ID группы пользователей. Требуется при операциях с сообщениями, если не задано `opmessage_usr`.
opmessage_usr	массив	Пользователи которым будут отправляться сообщения. Каждый объект имеет следующие свойства: `operationid` - (строка) ID операции; `userid` - (строка) ID пользователя. Требуется при операциях с сообщениями, если не задано `opmessage_grp`.

Операция действия о подтверждении

Объект операции действия о подтверждении определяет операцию, которая будет выполнена когда проблема подтверждена. Операции подтверждения можно использовать для действий по триггерам. Этот объект имеет следующие свойства.

Свойство	Тип	Описание
operationid	строка	(только чтение) ID операции действия.
operationtype (требуется)	целое число	Тип операции. Возможные значения для действий на триггеры: 0 - отправка сообщения; 1 - удаленная команда; 12 - оповещать всех участников.
opcommand	массив	Объект, который содержит данные о выполняемой команде в операции о подтверждении. Объект команды операции описан в деталях выше. Требуется для операций с удаленной командой.
opcommand_grp	массив	Группы узлов сети на которых будут выполняться удаленные команды. Каждый объект имеет следующие свойства: `groupid` - (строка) ID группы узлов сети. Требуется при операциях с удаленной командой, если не задано `opcommand_hst`.
opcommand_hst	массив	Узел сети на котором будут выполняться удаленные команды. Каждый объект имеет следующие свойства: `hostid` - (строка) ID узла сети; если задано значение равное 0, команда будет выполняться на текущем узле сети. Требуется при операциях с удаленной командой, если не задано `opcommand_grp`.
opmessage	объект	Объект, который содержит данные об отправляемом сообщении в операции о подтверждении. Объект сообщения операции детально описан выше. Требуется для операций с сообщениями.
opmessage_grp	массив	Группы пользователей которым будут отправляться сообщения. Каждый объект имеет следующие свойства: `usrgrpid` - (строка) ID группы пользователей. Требуется только при операциях `отправка сообщения`, если не задано `opmessage_usr`. Игнорируется для операций `отправка сообщения о подтверждении`.
opmessage_usr	массив	Пользователи которым будут отправляться сообщения. Каждый объект имеет следующие свойства: `userid` - (строка) ID пользователя. Требуется только при операциях `отправка сообщения`, если не задано `opmessage_grp`. Игнорируется для операций `отправка сообщения о подтверждении`.

Фильтр действия

Объект фильтра действия определяет набор условий, которые должны быть соблюдены для выполнения добавленных операций действия. Этот объект имеет следующие свойства.

Свойства	Тип	Описание
conditions (требуется)	массив	Набор условий фильтрации, которые используются для фильтрации результатов.
evaltype (требуется)	целое число	Метод вычисления условий фильтрации. Возможные значения: 0 - и/или; 1 - и; 2 - или; 3 - пользовательское выражение.
eval_formula	строка	(только чтение) Сгенерированное выражение, которое будет использоваться для вычисления условий фильтрации. Выражение содержит ID, которые являются ссылкой на определенные условия фильтрации по их `formulaid` полю. Значение `eval_formula` равно значению `formula` для фильтров с пользовательским выражением.
formula	строка	Заданное пользователем выражение, которое используется для вычисления условий фильтров с пользовательским выражением. Выражение должно содержать ID, которые являются ссылкой на определенные условия фильтрации по их `formulaid`. Эти ID используемые в выражении должны в точности совпадать с выражениями, которые заданы в условиях фильтрации: ни одно условие не должно остаться неиспользуемым или пропущенным. Требуется для фильтров с пользовательским выражением.

Условие фильтрации действия

Объект условия фильтрации действия задает определенное условие, которое необходимо проверить до выполнения операций действия.

Свойство	Тип	Описание
conditionid	строка	(только чтение) ID условия действия.
conditiontype (требуется)	целое число	Тип условия. Возможные значения для действий на триггеры: 0 - группа узлов сети; 1 - узел сети; 2 - триггер; 3 - имя триггера; 4 - важность триггера; 6 - период времени; 13 - шаблон узла сети; 15 - группа элементов данных; 16 - проблема подавлена; 25 - тег события; 26 - значения тега события. Возможные значения для действий на обнаружения: 7 - IP хоста; 8 - тип обнаруженного сервиса; 9 - порт обнаруженного сервиса; 10 - состояние обнаружения; 11 - длительность доступности или недоступности; 12 - полученное значение; 18 - правило обнаружения; 19 - проверка обнаружения; 20 - прокси; 21 - объект обнаружения. Возможные значения для действий на авторегистрацию: 20 - прокси; 22 - имя хоста; 24 - метаданные хоста. Возможные значения для действий на внутренние события: 0 - группа узлов сети; 1 - узел сети; 13 - шаблон узла сети; 15 - группа элементов данных; 23 - тип события.
value (требуется)	строка	Значение с которым будет идти сравнение.
value2	строка	Второе значение с которым будет идти сравнение. Требуется для действий на триггеры с типом условия 26.
actionid	строка	(только чтение) ID действия, которому принадлежит условие.
formulaid	строка	Произвольный уникальный ID, который используется в качестве ссылки на условие из пользовательского выражения. Может содержать только буквы в верхнем регистре. Этот ID должен быть задан пользователем при изменении условий фильтрации, однако ID будут сгенерированы заново при последующих их запросах.
operator	целое число	Оператор условия. Возможные значения: 0 - (по умолчанию) равно; 1 - не равно; 2 - содержит; 3 - не содержит; 4 - в; 5 - больше чем или равно; 6 - меньше чем или равно; 7 - не в; 10 - Да; 11 - Нет.

Чтобы лучше понимать как использовать фильтры с различными типами выражений, смотрите примеры на страницах action.get и action.create методов.

У каждого типа условия поддерживаются следующие операторы и значения.

Условие	Имя условия	Поддерживаемые операторы	Ожидаемое значение
0	Группа узлов сети	равно, не равно	ID группы узлов сети.
1	Узел сети	равно, не равно	ID узла сети.
2	Триггер	равно, не равно	ID триггера.
3	Имя триггера	содержит, не содержит	Имя триггера.
4	Важность триггера	равно, не равно, больше чем или равно, меньше чем или равно	Важность триггера. Обратитесь к свойству триггера "severity" для получения списка поддерживаемых важностей в триггерах.
5	Значение триггера	равно	Значение триггера. Обратитесь к свойству триггера "value" для получения списка поддерживаемых значений триггера.
6	Период времени	в, не в	Время, когда было вызвано событие в виде периода времени.
7	IP узла сети	равно, не равно	Проверяемый один или несколько диапазонов IP адресов, разделенных запятыми. Обратитесь к разделу настройки сетевого обнаружения для получения более подробной информации о поддерживаемых форматах диапазонов IP адресов.
8	Тип обнаруженного сервиса	равно, не равно	Тип обнаруженного сервиса. Тип сервиса соответствует проверке обнаружения, которая используется для обнаружения сервиса. Обратитесь к свойству "type" проверки обнаружения для получения списка поддерживаемых типов.
9	Порт обнаруженного сервиса	равно, не равно	Один или несколько диапазонов портов, разделенных запятыми.
10	Состояние обнаружения	равно	Состояние обнаруженного объекта. Возможные значения: 0 - хост или сервис доступны; 1 - хост или сервис недоступны; 2 - хост или сервис обнаружены; 3 - хост или сервис потеряны.
11	Длительность времени доступности или недоступности	больше чем или равно, меньше чем или равно	Время, которое указывает как долго обнаруженный объект находится в текущем состоянии, в секундах.
12	Полученное значение	равно, не равно, больше чем или равно, меньше чем или равно, содержит, не содержит	Полученное значение при выполнении проверки обнаружения Zabbix агента, SNMPv1, SNMPv2 или SNMPv3.
13	Шаблон узла сети	равно, не равно	ID присоединенного шаблона.
15	Группа элементов данных	равно, содержит, не содержит	Имя группы элементов данных.
16	Проблема подавлена	Да, Нет	Значение не требуется: использование оператора "Да" подразумевает что проблема должен быть подавлена, "Нет" - не подавлена.
18	Правило обнаружения	равно, не равно	ID правила обнаружения.
19	Проверка обнаружения	равно, не равно	ID проверки обнаружения.
20	Прокси	равно, не равно	ID прокси.
21	Объект обнаружения	равно	Тип объекта, который вызвал событие обнаружения. Возможные значения: 1 - обнаружен узел сети; 2 - обнаружен сервис.
22	Имя узла сети	содержит, не содержит	Имя узла сети.
23	Тип события	равно	Специфично для внутренних событий. Возможные значения: 0 - элемент данных в "неподдерживаемом" состоянии; 1 - элемент данных в "нормальном" состоянии; 2 - LLD правило в "неподдерживаемом" состоянии; 3 - LLD правило в "нормальном" состоянии; 4 - триггер в "неизвестном" состоянии; 5 - триггер в "нормальном" состоянии.
24	Метаданные хоста	содержит, не содержит	Метаданные автоматически зарегистрированного узла сети.
25	Тег	равно, не равно, содержит, не содержит	Тег события.
26	Значение тега	равно, не равно, содержит, не содержит	Значение тега события.

Documentation