This is a translation of the original English documentation page. Help us make it better.

> Об'єкт дії

Наступні об’єкти безпосередньо пов’язані з action API.

Дія

Об'єкт дії має такі властивості.

Властивість Тип Опис
actionid string (лише читання) ID дії.
esc_period
(обов'язково)
string Тривалість кроку операції за замовчуванням. Має бути не менше 60 секунд. Приймає секунди, одиницю вимірювання часу з суфіксом і макрос користувача.

Зауважте, що ескалація підтримується лише для тригерів, внутрішніх і службових дій і лише в звичайних операціях.
eventsource
(обов’язково)
integer (константа) Тип подій, які дія оброблятиме.

Зверніться до event "source" property для списку підтримуваних типів подій.
name
(обов'язково)
string Назва дії.
status integer Увімкнено чи вимкнено дію.

Можливі значення:
0 - (за замовчуванням) увімкнено;
1 - вимкнено.
pause_suppressed integer Чи призупинити ескалацію під час періодів обслуговування чи ні.

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

Зверніть увагу, що цей параметр дійсний лише для тригерних дій.
notify_if_canceled integer Чи сповіщати, коли ескалацію скасовано.

Можливі значення:
0 - Не повідомляти, коли ескалацію скасовано;
1 - (за замовчуванням) Повідомляти, коли ескалацію скасовано.

Зверніть увагу, що цей параметр дійсний лише для дій ініціатора.

Зауважте, що для деяких методів (оновлення, видалення) комбінація обов’язкових/необов’язкових параметрів відрізняється.

Операція дії

Об’єкт операції дії визначає операцію, яка виконуватиметься під час виконання дії. Має такі властивості.

Властивість Тип Опис
operationid string (readonly) ID операції дії.
operationtype
(обов'язково)
integer Тип операції.

Можливі значення:
0 - надіслати повідомлення;
1 - глобальний сценарій;
2 - додати хост;
3 - видалити хост;
4 - додати до групи хостів;
5 - видалити з групи хостів;
6 - посилання на шаблон;
7 - видалити зв'язок із шаблоном;<br >8 - увімкнути хост;
9 - вимкнути хост;
10 - встановити режим інвентаризації хоста.

Зауважте, що лише типи «0» і «1» підтримуються для тригерів і дій служби, лише «0» підтримується для внутрішніх дій. Усі типи підтримуються для дій виявлення та автореєстрації.
actionid string (лише для читання) ID дії, до якої належить операція.
esc_period string Тривалість кроку ескалації в секундах. Має бути більше 60 секунд. Приймає секунди, одиниці вимірювання часу з суфіксом і макрос користувача. Якщо встановлено значення 0 або 0 с, використовуватиметься період ескалації дії за замовчуванням.

За замовчуванням: 0 с.

Зверніть увагу, що ескалація підтримується лише для ініціаторів, внутрішніх і службових дій і лише у звичайному режимі. операцій.
esc_step_from integer Крок, з якого починається ескалація.

За замовчуванням: 1.

Зауважте, що ескалація підтримується лише для ініціаторів, внутрішніх і службових дій і лише під час звичайних операцій .
esc_step_to integer Крок для завершення ескалації.

За замовчуванням: 1.

Зауважте, що ескалація підтримується лише для ініціаторів, внутрішніх і службових дій і лише під час звичайних операцій .
evaltype integer Метод оцінки умови операції.

Можливі значення:
0 - (за замовчуванням) І / АБО;
1 - І;
2 - АБО.
opcommand object Об’єкт, що містить дані про глобальний сценарій, запущений операцією.

Кожен об’єкт має таку властивість: scriptid - (string) ідентифікатор сценарію.

Обов’язково для глобальних операцій сценарію.
opcommand_grp array Групи хостів для запуску глобальних сценаріїв.

Кожен об'єкт має такі властивості:
opcommand_grpid - (string, readonly) ідентифікатор об'єкта;
operationid - (string, readonly) ID операції;
groupid - (string) ID групи хостів.

Потрібно для операцій глобального сценарію, якщо opcommand_hst є не встановлено.
opcommand_hst array Хост для запуску глобальних сценаріїв.

Кожен об’єкт має такі властивості:
opcommand_hstid - (string, readonly) ідентифікатор об’єкта;
operationid - (string, readonly) ID операції;
hostid - (string) ID хоста; якщо встановлено значення 0, команда буде виконана на поточному хості.

Потрібно для операцій глобального сценарію, якщо opcommand_grp не встановлено.
opconditions array Умови роботи, що використовуються для дій ініціатора.

Об’єкт умови операції докладно описано нижче.
opgroup array Групи хостів для додавання хостів.

Кожен об'єкт має такі властивості:
operationid - (string, readonly) ID операції;
groupid - (string) ID групи хостів.

Потрібно для операцій «додати до групи хостів» і «видалити з групи хостів».
opmessage object Об’єкт, що містить дані про повідомлення, надіслане операцією.

Об’єкт повідомлення про операцію докладно описано нижче.< br
Потрібно для операцій з повідомленнями.
opmessage_grp array Групи користувачів для надсилання повідомлень.

Кожен об’єкт має такі властивості:
operationid - (string, readonly) ID операції;
usrgrpid - (string) ID групи користувачів.

Потрібно для операцій з повідомленнями, якщо opmessage_usr не встановлено.
opmessage_usr масив Користувачі для надсилання повідомлень.

Кожен об’єкт має такі властивості:
operationid - (string, readonly) ID операції;
userid - (string) ID користувача.

Потрібно для операцій з повідомленнями, якщо opmessage_grp не встановлено.
optemplate array Шаблони для зв’язування хостів.

Кожен об’єкт має такі властивості:
operationid - (string, readonly) ID операції;
templateid - (string) Ідентифікатор шаблону.

Потрібно для операцій «посилання на шаблон» і «від’єднання від шаблону».
opinventory object Режим інвентаризації встановлено для хоста.

Об’єкт має такі властивості:
operationid - (string, readonly) ідентифікатор операції;
inventory_mode - * (string)* Режим інвентаризації.

Потрібен для операцій «Установити режим інвентаризації хоста».

Повідомлення про дію

Об'єкт повідомлення операції містить дані про повідомлення, яке буде надіслано операцією.

Властивість Тип Опис
default_msg integer Чи використовувати текст і тему повідомлення про дію за замовчуванням.

Можливі значення:
0 - використовувати дані з операції;
1 - (за замовчуванням) використовувати дані з способу оповіщення.
mediatypeid string Ідентифікатор способу оповіщення, який буде використано для надсилання повідомлення.
message string Текст повідомлення операції.
subject string Тема повідомлення операції.

Умова операції дії

Об’єкт операції дії визначає умову, яка має бути виконана для виконання поточної операції. Має такі властивості.

Властивість Тип Опис
opconditionid string (readonly) ID умови операції дії
conditiontype
(обов’язково)
integer Тип умови.

Можливі значення:
14 - подія підтверджена.
value
(обов’язково)
string Значення для порівняння.
operationid string (readonly) ID операції.
operator integer Оператор умови.

Можливі значення:
0 - (default) =.

Наступні оператори та значення підтримуються для кожного типу умови операції.

Умова Назва умови Підтримувані оператори Очікуване значення
14 Подію підтверджено = Чи підтверджено подію.

Можливі значення:
0 - не підтверджено;
1 - підтверджено.

Операція відновлення дії

Об'єкт операції відновлення дії визначає операцію, яка буде виконана після вирішення проблеми. Операції відновлення можливі для тригерних, внутрішніх і службових дій. Має такі властивості.

Властивість Тип Опис
operationid string (read only) ID операції дії.
operationtype
(обов’язково)
integer Тип операції.

Можливі значення для тригерів і дій служби:
0 - надіслати повідомлення;
1 - глобальний сценарій;
11 - повідомити всіх учасників.

Можливі значення для внутрішніх дій:
0 - надіслати повідомлення;
11 - повідомити всіх учасників.
actionid string (read only) Ідентифікатор дії, до якої належить операція відновлення.
opcommand object Об’єкт, що містить дані про глобальний сценарій типу дії, який виконується операцією.

Кожен об’єкт має одну таку властивість: scriptid - (string) ID сценарію типу дії.

Потрібно для глобальних операцій сценаріїв.
opcommand_grp масив Групи хостів для запуску глобальних сценаріїв.

Кожен об'єкт має такі властивості:
opcommand_grpid - (string, read only) ідентифікатор об'єкта;
operationid - (string, readonly) ID операції;
groupid - (string) ID групи хостів.

Потрібен для глобальних операцій скрипта, якщо opcommand_hst не встановлено.
opcommand_hst масив Хост для запуску глобальних сценаріїв.

Кожен об’єкт має такі властивості:
opcommand_hstid - (string, read only) ідентифікатор об’єкта;
operationid - (string, readonly) ID операції;
hostid - (string) ID хоста; якщо встановлено значення 0, команда буде виконана на поточному хості.

Потрібно для операцій глобального сценарію, якщо opcommand_grp не встановлено.
opmessage object Об’єкт, що містить дані про повідомлення, надіслане операцією відновлення.

Об’єкт повідомлення операції докладно описано вище.

Потрібно для операцій з повідомленнями.
opmessage_grp масив Групи користувачів для надсилання повідомлень.

Кожен об’єкт має такі властивості:
operationid - (string, read only) ID операції;
usrgrpid - (string) ID групи користувачів.

Потрібно для операцій з повідомленнями, якщо opmessage_usr не встановлено.
opmessage_usr масив Користувачі для надсилання повідомлень.

Кожен об’єкт має такі властивості:
operationid - (string, read only) ID операції;
userid - (string) ID користувача.

Потрібно для операцій з повідомленнями, якщо opmessage_grp не встановлено.

Операція оновлення дії

Об’єкт операції оновлення дії визначає операцію, яка виконуватиметься, коли проблему буде оновлено (прокоментовано, підтверджено, змінено серйозність або закрито вручну). Операції оновлення можливі для дій тригера та служби. Має такі властивості.

Властивість Тип Опис
operationid string (readonly) ID операції дії.
operationtype
(обов’язково)
integer Тип операції.

Можливі значення для тригерів і дій служби:
0 - надіслати повідомлення;
1 - глобальний сценарій;
12 - повідомити всіх причетних.
opcommand object Об’єкт, що містить дані про сценарій типу глобальної дії, який виконується операцією.

Кожен об’єкт має одну наступну властивість: scriptid - (string) ID сценарію типу дії.

Потрібно для глобальних операцій сценаріїв.
opcommand_grp array Групи хостів для запуску глобальних сценаріїв.

Кожен об’єкт має такі властивості:
groupid - (string) ID групи хостів.

Потрібно для глобальних операцій сценаріїв, якщо opcommand_hst не встановлено.
opcommand_hst array Хост для запуску глобальних сценаріїв.

Кожен об'єкт має такі властивості:
hostid - (string) ID хоста; якщо встановлено значення 0, команда буде виконана на поточному хості.

Потрібно для операцій глобального сценарію, якщо opcommand_grp не встановлено.
opmessage object Об’єкт, що містить дані про повідомлення, надіслане операцією оновлення.

Об’єкт повідомлення про операцію докладно описано вище.
opmessage_grp array Групи користувачів для надсилання повідомлень.

Кожен об’єкт має такі властивості:
usrgrpid - (string) ID групи користувачів.
<br >Потрібно лише для операцій надіслати повідомлення, якщо opmessage_usr не встановлено.
Ігнорується для операцій надіслати повідомлення оновлення.
opmessage_usr array Користувачі для надсилання повідомлень.

Кожен об’єкт має такі властивості:
userid - (string) ідентифікатор користувача.

Обов’язково лише для операцій надіслати повідомлення, якщо opmessage_grp не встановлено.
Ігнорується для операцій надіслати повідомлення оновлення.

Фільтр дій

Об’єкт фільтра дій визначає набір умов, які мають бути виконані для виконання налаштованих операцій дій. Має такі властивості.

Властивість Тип Опис
conditions
(обов’язково)
array Набір умов фільтра для використання для фільтрації результатів.
evaltype
(обов’язково)
integer Метод оцінки умови фільтра.

Можливі значення:
0 - та/або;
1 - і;
2 - або;
3 - спеціальний вираз.
eval_formula string (лише для читання) Згенерований вираз, який використовуватиметься для оцінки умов фільтра. Вираз містить ідентифікатори, які посилаються на конкретні умови фільтра за його formulaid. Значення eval_formula дорівнює значенню formula для фільтрів із спеціальним виразом.
formula string Визначений користувачем вираз, який буде використовуватися для оцінки умов фільтрів за допомогою спеціального виразу. Вираз має містити ідентифікатори, які посилаються на конкретні умови фільтра за його formulaid. Ідентифікатори, які використовуються у виразі, мають точно відповідати ідентифікаторам, визначеним в умовах фільтра: жодна умова не може залишатися невикористаною або пропущеною.

Потрібно для фільтрів користувацьких виразів.

Умова фільтра дій

Об’єкт умови фільтра дій визначає певну умову, яку необхідно перевірити перед виконанням операцій дії.

Властивість Тип Опис
conditionid string (лише для читання) ID умови дії.
conditiontype
(обов’язково)
integer Тип умови.

Можливі значення для тригерних дій:
0 - група хостів;
1 - хост;
2 - тригер;
3 - ім'я тригера;
4 - серйозність тригера;
6 - період часу;
13 - шаблон хосту;
16 - проблема припинена;
25 - подія тег;
26 - значення тегу події.

Можливі значення для дій виявлення:
7 - IP хоста;
8 - виявлений тип служби;
9 - виявлений порт служби;
10 - статус виявлення;
11 - тривалість роботи або простою;
12 - отримане значення;
18 - правило виявлення;
19 - перевірка виявлення;
20 - проксі;<br >21 - об'єкт виявлення.

Можливі значення для дій автореєстрації:
20 - проксі;
22 - ім'я хоста;
24 - метадані хоста.

Можливі значення для внутрішні дії:
0 - група хостів;
1 - хост;
13 - шаблон хосту;
23 - тип події;
25 - тег події;
26 - значення тегу події .

Можливі значення для дій служби:
25 - тег події;
26 - значення тегу події;
27 - послуга;
28 - назва служби.
value
(обов’язково)
string Значення для порівняння.
value2
string Вторинне значення для порівняння. Необхідний для тригерів, внутрішніх і службових дій, коли тип умови 26.
actionid string (лише для читання) ID дії, до якої належить умова.
formulaid string Довільний унікальний ідентифікатор, який використовується для посилання на умову з користувацького виразу. Може містити лише великі літери. Ідентифікатор має бути визначений користувачем під час зміни умов фільтра, але буде згенеровано заново під час їхнього запиту пізніше.
operator integer Оператор умови.

Можливі значення:
0 - (за замовчуванням) дорівнює;
1 - не дорівнює;
2 - містить;
3 - не містить;
4 - в;
5 - більше або дорівнює;
6 - менше або дорівнює;
7 - не в;
8 - збігається;<br >9 - не відповідає;
10 - Так;
11 - Ні.

Щоб краще зрозуміти, як використовувати фільтри з різними типами виразів, перегляньте приклади на сторінках методів action.get і action.create.

Наступні оператори та значення підтримуються для кожного типу умови.

Умова Назва умови Підтримувані оператори Очікуване значення
0 Група вузлів мережі дорівнює,
не дорівнює
Ідентифікатор групи вузлів мережі.
1 Вузол мережі дорівнює,
не дорівнює
Ідентифікатор вузла мережі.
2 Тригер дорівнює,
не дорівнює
Ідентифікатор тригера.
3 Ім'я тригера містить,
не містить
Ім'я тригера.
4 Важливість тригера дорівнює,
не дорівнює,
більша або дорівнює,
менша або дорівнює
Важливість тригера. Перегляньте властивість "важливості" тригера, щоб отримати список підтримуваних рівнів важливості тригера.
5 Значення тригера дорівнює Значення тригера. Перегляньте властивість "значення" тригера, щоб переглянути список підтримуваних значень тригера.
6 Період часу в, не в Час, коли подію було спровоковано як період часу.
7 IP вузла мережі дорівнює,
не дорівнює
Один або кілька діапазонів IP для перевірки, розділених комами. Зверніться до розділу конфігурація виявлення мережі, щоб дізнатися більше про підтримувані формати діапазонів IP-адрес.
8 Тип виявлення послуги дорівнює,
не дорівнює
Типу виявленя послуги. Тип служби відповідає типу перевірки виявлення, яка використовується для виявлення послуги. Перегляньте властивість "тип" перевірки виявлення, щоб переглянути список підтримуваних типів.
9 Порт виявлення послуги дорівнює,
не дорівнює
Один або кілька діапазонів портів, розділених комами.
10 Статус виявлення дорівнює Статусу виявленого об'єкта.

Можливі значення:
0 - хост або служба працює;
1 - хост або служба не працює;
2 - хост або службу виявлено;
3 - хост або послугу втрачено.
11 Тривалість безвідмовної роботи або простою більше або дорівнює,
менше або дорівнює
Час, що вказує, як довго виявлений об’єкт перебував у поточному статусі в секундах.
12 Отримані значення дорівнює,
не дорівнює,
більше або дорівнює,
менше або дорівнює,
містить,
не містить
Значення, що повертається під час виконання Агент Zabbix, перевірка виявлення SNMPv1, SNMPv2 або SNMPv3.
13 Шаблон хосту дорівнює,
не дорівнює
Ідентифікатор пов’язаного шаблону.
16 Проблема прихована Так, Ні Значення не обов'язкове: використання оператора "Так" означає, що проблему потрібно придушити, "Ні" - не придушувати.
18 Правило виявлення дорівнює,
не дорівнює
ID правила відкриття.
19 Перевірка виявлення дорівнює,
не дорівнює
ID перевірки виявлення.
20 Проксі дорівнює,
не дорівнює
ID проксі.
21 Об'єкт виявлення дорівнює Тип