[comment]: # aside: 1 [comment]: # ({5fa5406d-502c65c3}) # Объект действия Следующие объекты напрямую связаны с методом API `action`. [comment]: # ({/5fa5406d-502c65c3}) [comment]: # ({cc3f51c7-73117797}) ### Действие Объект действия имеет следующие свойства. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|--| |actionid|ID|ID действия.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *только для чтения*
- *обязательно* для операций обновления| |esc\_period|string|Длительность шага операции по умолчанию. Должна быть не менее 60 секунд. Допускаются секунды, единица времени с суффиксом или пользовательский макрос.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *поддерживается*, если `eventsource` установлено в "event created by a trigger", "internal event" или "event created on service status update"| |eventsource|integer|Тип событий, которые будет обрабатывать действие.

См. [свойство `source` события](/manual/api/reference/event/object#event) для списка поддерживаемых типов событий.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *константа*
- *обязательно* для операций создания| |name|string|Имя действия.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *обязательно* для операций создания| |status|integer|Включено действие или отключено.

Возможные значения:
0 - *(по умолчанию)* включено;
1 - отключено.| |pause\_symptoms|integer|Следует ли приостанавливать эскалацию, если событие является симптомом.

Возможные значения:
0 - Не приостанавливать эскалацию для проблем-симптомов;
1 - *(по умолчанию)* Приостанавливать эскалацию для проблем-симптомов.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *поддерживается*, если `eventsource` установлено в "event created by a trigger"| |pause\_suppressed|integer|Следует ли приостанавливать эскалацию во время периодов обслуживания.

Возможные значения:
0 - Не приостанавливать эскалацию;
1 - *(по умолчанию)* Приостанавливать эскалацию.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *поддерживается*, если `eventsource` установлено в "event created by a trigger"| |notify\_if\_canceled|integer|Следует ли уведомлять об отмене эскалации.

Возможные значения:
0 - Не уведомлять об отмене эскалации;
1 - *(по умолчанию)* Уведомлять об отмене эскалации.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *поддерживается*, если `eventsource` установлено в "event created by a trigger"| [comment]: # ({/cc3f51c7-73117797}) [comment]: # ({59c01820-8757165b}) ### Объект операции действия Объект операции действия определяет операцию, которая будет выполнена при запуске действия. Он имеет следующие свойства. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |operationtype|integer|Тип операции.

Возможные значения:
0 - отправить сообщение;
1 - глобальный скрипт;
2 - добавить узел сети;
3 - удалить узел сети;
4 - добавить в группу узлов сети;
5 - удалить из группы узлов сети;
6 - привязать шаблон;
7 - отвязать шаблон;
8 - включить узел сети;
9 - отключить узел сети;
10 - задать режим инвентаризации узла сети;
13 - добавить теги узла сети;
14 - удалить теги узла сети.

Возможные значения, если `eventsource` объекта [Action object](#action) установлен в "event created by a trigger" или "event created on service status update":
0 - "send message";
1 - "global script".

Возможные значения, если `eventsource` объекта [Action object](#action) установлен в "internal event":
0 - "send message".

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required*| |esc\_period|string|Длительность шага эскалации в секундах. Должна быть больше 60 секунд. Допускаются секунды, единица времени с суффиксом или пользовательский макрос. Если задано 0 или 0s, будет использован период эскалации действия по умолчанию.

По умолчанию: 0s.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *supported* если `eventsource` объекта [Action object](#action) установлен в "event created by a trigger", "internal event" или "event created on service status update"| |esc\_step\_from|integer|Шаг, с которого начинается эскалация.

По умолчанию: 1.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *supported* если `eventsource` объекта [Action object](#action) установлен в "event created by a trigger", "internal event" или "event created on service status update"| |esc\_step\_to|integer|Шаг, на котором заканчивается эскалация.

По умолчанию: 1.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *supported* если `eventsource` объекта [Action object](#action) установлен в "event created by a trigger", "internal event" или "event created on service status update"| |evaltype|integer|Метод [вычисления](/manual/config/notifications/action/conditions#type-of-calculation) условий операции.

Возможные значения:
0 - *(по умолчанию)* И/ИЛИ;
1 - И;
2 - ИЛИ.| |opcommand|object|Глобальный скрипт для выполнения.

Глобальный скрипт должен содержать свойство `scriptid`.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required* если `operationtype` установлен в "global script"| |opcommand\_grp|array|Группы узлов сети, на которых будут выполняться глобальные скрипты.

Группы узлов сети должны содержать свойство `groupid`.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required* если `operationtype` установлен в "global script" и `opcommand_hst` не задан| |opcommand\_hst|array|Узел сети, на котором будут выполняться глобальные скрипты.

Узлы сети должны содержать свойство `hostid`.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required* если `operationtype` установлен в "global script" и `opcommand_grp` не задан| |opconditions|array|Условия операции, используемые для действий триггера.

Объект условия операции [подробно описан ниже](/manual/api/reference/action/object#action-operation-condition).| |opgroup|array|Группы узлов сети, в которые будут добавляться узлы сети.

Группы узлов сети должны содержать свойство `groupid`.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required* если `operationtype` установлен в "add to host group" или "remove from host group"| |opmessage|object|Объект, содержащий данные о сообщении, отправляемом операцией.

Объект сообщения операции [подробно описан ниже](/manual/api/reference/action/object#action-operation-message).

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required* если `operationtype` установлен в "send message"| |opmessage\_grp|array|Группы пользователей, которым будут отправляться сообщения.

Группы пользователей должны содержать свойство `usrgrpid`.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required* если `operationtype` установлен в "send message" и `opmessage_usr` не задан| |opmessage\_usr|array|Пользователи, которым будут отправляться сообщения.

Пользователи должны содержать свойство `userid`.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required* если `operationtype` установлен в "send message" и `opmessage_grp` не задан| |optemplate|array|Шаблоны, которые будут привязаны к узлам сети.

Шаблоны должны содержать свойство `templateid`.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required* если `operationtype` установлен в "link template" или "unlink template"| |opinventory|object|Режим инвентаризации, который будет задан узлу сети.

Инвентаризация должна содержать свойство `inventory_mode`.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required* если `operationtype` установлен в "set host inventory mode"| |optag|array|Теги узла сети, которые будут добавлены или удалены.

Теги должны содержать свойство `tag`.
Свойство `value` необязательно.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *supported* если `operationtype` установлен в "add host tags" или "remove host tags".| [comment]: # ({/59c01820-8757165b}) [comment]: # ({2b6e61d1-4aeccf9f}) #### Сообщение операции действия Объект сообщения операции содержит данные о сообщении, которое будет отправлено операцией. Он имеет следующие свойства. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |default\_msg|integer|Использовать ли текст и тему сообщения действия по умолчанию.

Возможные значения:
0 - использовать данные из операции;
1 - *(по умолчанию)* использовать данные из типа медиа.| |mediatypeid|ID|ID типа медиа, который будет использоваться для отправки сообщения.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *поддерживается*, если `operationtype` [объекта операции действия](#action-operation), [объекта операции восстановления действия](#action-recovery-operation) или [объекта операции обновления действия](#action-update-operation) установлен в "send message", либо если `operationtype` [объекта операции обновления действия](#action-update-operation) установлен в "notify all involved"| |message|string|Текст сообщения операции.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *поддерживается*, если `default_msg` установлен в "use the data from the operation"| |subject|string|Тема сообщения операции.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *поддерживается*, если `default_msg` установлен в "use the data from the operation"| [comment]: # ({/2b6e61d1-4aeccf9f}) [comment]: # ({87768497-6762fd66}) #### Условие операции действия Объект условия операции действия определяет условие, которое должно быть выполнено для выполнения текущей операции. Он имеет следующие свойства. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |conditiontype|integer|Тип условия.

Возможные значения:
14 - событие подтверждено.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required*| |value|string|Значение для сравнения.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required*| |operator|integer|Оператор условия.

Возможные значения:
0 - *(по умолчанию)* =| Для каждого типа условия операции поддерживаются следующие операторы и значения. |Condition|Condition name|Supported operators|Expected value| |---------|--------------|-------------------|--------------| |14|Событие подтверждено|=|Подтверждено ли событие.

Возможные значения:
0 - не подтверждено;
1 - подтверждено.| [comment]: # ({/87768497-6762fd66}) [comment]: # ({fe3a08b5-d1e6762b}) ### Операция восстановления действия Объект операции восстановления действия определяет операцию, которая будет выполнена, когда проблема будет устранена. Операции восстановления возможны **только** для действий типа триггер, внутреннее событие и сервис. Он имеет следующие свойства. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |operationtype|integer|Тип операции.

Возможные значения, если `eventsource` объекта [Action object](#action) установлен в "event created by a trigger" или "event created on service status update":
0 - отправить сообщение;
1 - глобальный скрипт;
11 - уведомить всех участников.

Возможные значения, если `eventsource` объекта [Action object](#action) установлен в "internal event":
0 - отправить сообщение;
11 - уведомить всех участников.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required*| |opcommand|object|Глобальный скрипт для выполнения.

Глобальный скрипт должен иметь определенное свойство `scriptid`.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required* если `operationtype` установлен в "global script"| |opcommand\_grp|array|Группы узлов сети, на которых запускать глобальные скрипты.

Группы узлов сети должны иметь определенное свойство `groupid`.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required* если `eventsource` объекта [Action object](#action) установлен в "event created by a trigger", и `operationtype` установлен в "global script", и `opcommand_hst` не задан| |opcommand\_hst|array|Узел сети, на котором запускать глобальные скрипты.

Узлы сети должны иметь определенное свойство `hostid`.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required* если `eventsource` объекта [Action object](#action) установлен в "event created by a trigger", и `operationtype` установлен в "global script", и `opcommand_grp` не задан| |opmessage|object|Объект, содержащий данные о сообщении, отправляемом операцией восстановления.

Объект сообщения операции подробно [описан выше](/manual/api/reference/action/object#action-operation-message).

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required* если `operationtype` установлен в "send message"| |opmessage\_grp|array|Группы пользователей, которым отправлять сообщения.

Группы пользователей должны иметь определенное свойство `usrgrpid`.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required* если `operationtype` установлен в "send message" и `opmessage_usr` не задан| |opmessage\_usr|array|Пользователи, которым отправлять сообщения.

Пользователи должны иметь определенное свойство `userid`.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required* если `operationtype` установлен в "send message" и `opmessage_grp` не задан| [comment]: # ({/fe3a08b5-d1e6762b}) [comment]: # ({37748b62-f41f59ea}) ### Операция обновления действия Объект операции обновления действия определяет операцию, которая будет выполнена при обновлении проблемы (при добавлении комментария, подтверждении, изменении серьезности или ручном закрытии). Операции обновления возможны **только** для действий триггера и сервиса. Он имеет следующие свойства. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |operationtype|integer|Тип операции.

Возможные значения:
0 - отправить сообщение;
1 - глобальный скрипт;
12 - уведомить всех участников.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required*| |opcommand|object|Глобальный скрипт для выполнения.

Глобальный скрипт должен иметь определенное свойство `scriptid`.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required* если `operationtype` установлено в "global script"| |opcommand\_grp|array|Группы узлов сети, на которых нужно запускать глобальные скрипты.

Группы узлов сети должны иметь определенное свойство `groupid`.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required* если `eventsource` объекта [Action object](#action) установлено в "event created by a trigger", и `operationtype` установлено в "global script", и `opcommand_hst` не задано| |opcommand\_hst|array|Узел сети, на котором нужно запускать глобальные скрипты.

Узлы сети должны иметь определенное свойство `hostid`.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required* если `eventsource` объекта [Action object](#action) установлено в "event created by a trigger", и `operationtype` установлено в "global script", и `opcommand_grp` не задано| |opmessage|object|Объект, содержащий данные о сообщении, отправляемом операцией обновления.

Объект сообщения операции [подробно описан выше](/manual/api/reference/action/object#action-operation-message).| |opmessage\_grp|array|Группы пользователей, которым нужно отправлять сообщения.

Группы пользователей должны иметь определенное свойство `usrgrpid`.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required* если `operationtype` установлено в "send message" и `opmessage_usr` не задано| |opmessage\_usr|array|Пользователи, которым нужно отправлять сообщения.

Пользователи должны иметь определенное свойство `userid`.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required* если `operationtype` установлено в "send message" и `opmessage_grp` не задано| [comment]: # ({/37748b62-f41f59ea}) [comment]: # ({aeaafcdb-0d8b3bb1}) ### Фильтр действия Объект фильтра действия определяет набор условий, которые должны быть выполнены для выполнения настроенных операций действия. Он имеет следующие свойства. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |conditions|array|Набор [условий фильтра](#action-filter-condition), используемых для фильтрации результатов. Условия будут отсортированы в порядке их размещения в формуле.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required*| |evaltype|integer|[Метод вычисления](/manual/config/notifications/action/conditions#type-of-calculation) условий фильтра.

Возможные значения:
0 - And/Or;
1 - And;
2 - Or;
3 - Пользовательское выражение.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required*| |eval\_formula|string|Сгенерированное выражение, которое будет использоваться для вычисления условий фильтра. Выражение содержит идентификаторы, которые ссылаются на конкретные условия фильтра по их `formulaid`. Значение `eval_formula` равно значению `formula` для фильтров с пользовательским выражением.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *read-only*| |formula|string|Определяемое пользователем выражение, используемое для вычисления условий фильтров с пользовательским выражением. Выражение должно содержать идентификаторы, которые ссылаются на конкретные условия фильтра по их `formulaid`. Идентификаторы, используемые в выражении, должны точно совпадать с идентификаторами, определенными в условиях фильтра: ни одно условие не может остаться неиспользованным или быть пропущенным.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required* если `evaltype` установлено в "custom expression"| [comment]: # ({/aeaafcdb-0d8b3bb1}) [comment]: # ({2cc23997-dd860074}) #### Условие фильтра действия Объект условия фильтра действия определяет конкретное условие, которое должно быть проверено перед выполнением операций действия. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|--| |conditiontype|integer|Тип условия.

Возможные значения, если `eventsource` объекта [Action object](#action) установлен в "event created by a trigger":
0 - группа узлов сети;
1 - узел сети;
2 - триггер;
3 - имя события;
4 - серьезность триггера;
6 - период времени;
13 - шаблон узла сети;
16 - проблема подавлена;
25 - тег события;
26 - значение тега события.

Возможные значения, если `eventsource` объекта [Action object](#action) установлен в "event created by a discovery rule":
7 - IP-адрес узла сети;
8 - тип обнаруженной службы;
9 - порт обнаруженной службы;
10 - статус обнаружения;
11 - длительность времени работы или простоя;
12 - полученное значение;
18 - правило обнаружения;
19 - проверка обнаружения;
20 - прокси;
21 - объект обнаружения.

Возможные значения, если `eventsource` объекта [Action object](#action) установлен в "event created by active agent autoregistration":
20 - прокси;
22 - имя узла сети;
24 - метаданные узла сети.

Возможные значения, если `eventsource` объекта [Action object](#action) установлен в "internal event":
0 - группа узлов сети;
1 - узел сети;
13 - шаблон узла сети;
23 - тип события;
25 - тег события;
26 - значение тега события.

Возможные значения, если `eventsource` объекта [Action object](#action) установлен в "event created on service status update":
25 - тег события;
26 - значение тега события;
27 - служба;
28 - имя службы.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required*| |value|string|Значение для сравнения.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required*| |value2|string|Вторичное значение для сравнения.

[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required* если `eventsource` объекта [Action object](#action) установлен в "event created by a trigger", `conditiontype` установлен в любое возможное значение для действий триггера, а тип условия (см. ниже) равен "26"
- *required* если `eventsource` объекта [Action object](#action) установлен в "internal event", `conditiontype` установлен в любое возможное значение для внутренних действий, а тип условия (см. ниже) равен "26"
- *required* если `eventsource` объекта [Action object](#action) установлен в "event created on service status update", `conditiontype` установлен в любое возможное значение для действий службы, а тип условия (см. ниже) равен "26"| |formulaid|string|Произвольный уникальный ID, который используется для ссылки на условие из пользовательского выражения. Может содержать только заглавные буквы. ID должен быть задан пользователем при изменении условий фильтра, но будет сгенерирован заново при последующем запросе.| |operator|integer|[Оператор](/manual/config/notifications/action/conditions) условия.

Возможные значения:
0 - *(по умолчанию)* равно;
1 - не равно;
2 - содержит;
3 - не содержит;
4 - входит в;
5 - больше или равно;
6 - меньше или равно;
7 - не входит в;
8 - соответствует;
9 - не соответствует;
10 - Да;
11 - Нет.| ::: notetip Чтобы лучше понять, как использовать фильтры с различными типами выражений, см. примеры на страницах методов [action.get](get#retrieve-discovery-actions) и [action.create](create#using-a-custom-expression-filter). ::: Для каждого типа условия поддерживаются следующие операторы и значения. |Condition|Condition name|Supported operators|Expected value| |-|--|--|------| |0|Группа узлов сети|равно,
не равно|ID группы узлов сети.| |1|Узел сети|равно,
не равно|ID узла сети.| |2|Триггер|равно,
не равно|ID триггера.| |3|Имя события|содержит,
не содержит|Имя события.| |4|Серьезность триггера|равно,
не равно,
больше или равно,
меньше или равно|Серьезность триггера. Список поддерживаемых уровней серьезности триггера см. в [свойстве `severity` триггера](/manual/api/reference/trigger/object#trigger).| |5|Значение триггера|равно|Значение триггера. Список поддерживаемых значений триггера см. в [свойстве `value` триггера](/manual/api/reference/trigger/object#trigger).| |6|Период времени|входит в, не входит в|Время, когда событие было сгенерировано, в виде [периода времени](/manual/appendix/time_period).| |7|IP-адрес узла сети|равно,
не равно|Один или несколько диапазонов IP-адресов, разделенных запятыми. Дополнительные сведения о поддерживаемых форматах диапазонов IP-адресов см. в разделе [конфигурации сетевого обнаружения](/manual/discovery/network_discovery/rule).| |8|Тип обнаруженной службы|равно,
не равно|Тип обнаруженной службы. Тип службы соответствует типу проверки обнаружения, использованной для обнаружения службы. Список поддерживаемых типов см. в [свойстве `type` проверки обнаружения](/manual/api/reference/dcheck/object#discovery-check).| |9|Порт обнаруженной службы|равно,
не равно|Один или несколько диапазонов портов, разделенных запятыми.| |10|Статус обнаружения|равно|Статус обнаруженного объекта.

Возможные значения:
0 - узел сети или служба доступны;
1 - узел сети или служба недоступны;
2 - узел сети или служба обнаружены;
3 - узел сети или служба потеряны.| |11|Длительность времени работы или простоя|больше или равно,
меньше или равно|Время в секундах, в течение которого обнаруженный объект находится в текущем статусе.| |12|Полученные значения|равно,
не равно,
больше или равно,
меньше или равно,
содержит,
не содержит|Значение, возвращаемое при выполнении проверки обнаружения агентом Zabbix, SNMPv1, SNMPv2 или SNMPv3.| |13|Шаблон узла сети|равно,
не равно|ID связанного шаблона.| |16|Проблема подавлена|Да, Нет|Значение не требуется: использование оператора "Да" означает, что проблема должна быть подавлена, "Нет" - не подавлена.| |18|Правило обнаружения|равно,
не равно|ID правила обнаружения.| |19|Проверка обнаружения|равно,
не равно|ID проверки обнаружения.| |20|Прокси|равно,
не равно|ID прокси.| |21|Объект обнаружения|равно|Тип объекта, который вызвал событие обнаружения.

Возможные значения:
1 - обнаруженный узел сети;
2 - обнаруженная служба.| |22|Имя узла сети|содержит,
не содержит,
соответствует,
не соответствует|Имя узла сети.
Использование регулярного выражения поддерживается для операторов *соответствует* и *не соответствует* в условиях авто-регистрации.| |23|Тип события|равно|Конкретное внутреннее событие.

Возможные значения:
0 - элемент данных в состоянии "не поддерживается";
1 - элемент данных в состоянии "нормально";
2 - правило LLD в состоянии "не поддерживается";
3 - правило LLD в состоянии "нормально";
4 - триггер в состоянии "неизвестно";
5 - триггер в состоянии "нормально".| |24|Метаданные узла сети|содержит,
не содержит,
соответствует,
не соответствует|Метаданные автоматически зарегистрированного узла сети.
Использование регулярного выражения поддерживается для операторов *соответствует* и *не соответствует*.| |25|Тег|равно,
не равно,
содержит,
не содержит|Тег события.| |26|Значение тега|равно,
не равно,
содержит,
не содержит|Значение тега события.| |27|Служба|равно,
не равно|ID службы.| |28|Имя службы|равно,
не равно|Имя службы.| [comment]: # ({/2cc23997-dd860074})