Объект script

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

Скрипт

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

Property Type Description
scriptid ID ID скрипта.

Поведение свойства:
- только для чтения
- обязательно для операций обновления
name string Имя скрипта.

Поведение свойства:
- обязательно для операций создания
type integer Тип скрипта.

Возможные значения, если scope установлен в "action operation":
0 - Script;
1 - IPMI;
2 - SSH;
3 - TELNET;
5 - Вебхук.

Возможные значения, если scope установлен в "manual host action" или "manual event action":
6 - URL.

Поведение свойства:
- обязательно для операций создания
command string Команда для выполнения.

Поведение свойства:
- обязательно если type установлен в "Script", "IPMI", "SSH", "TELNET" или "Вебхук"
scope integer Область действия скрипта.

Возможные значения:
1 - action operation;
2 - manual host action;
4 - manual event action.

Поведение свойства:
- обязательно для операций создания
execute_on integer Где запускать скрипт.

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

Поведение свойства:
- поддерживается если type установлен в "Script"
menu_path string Папки, разделенные слешем, которые формируют навигацию в виде меню во веб-интерфейсе при щелчке по узлу сети или событию.

Поведение свойства:
- поддерживается если scope установлен в "manual host action" или "manual event action"
authtype integer Метод аутентификации, используемый для типа скрипта SSH.

Возможные значения:
0 - пароль;
1 - публичный ключ.

Поведение свойства:
- поддерживается если type установлен в "SSH"
username string Имя пользователя, используемое для аутентификации.

Поведение свойства:
- обязательно если type установлен в "SSH" или "TELNET"
password string Пароль, используемый для скриптов SSH с аутентификацией по паролю и для скриптов TELNET.

Поведение свойства:
- поддерживается если type установлен в "SSH" и authtype установлен в "password", или type установлен в "TELNET"
publickey string Имя файла открытого ключа, используемого для скриптов SSH с аутентификацией по открытому ключу.

Поведение свойства:
- обязательно если type установлен в "SSH" и authtype установлен в "public key"
privatekey string Имя файла закрытого ключа, используемого для скриптов SSH с аутентификацией по открытому ключу.

Поведение свойства:
- обязательно если type установлен в "SSH" и authtype установлен в "public key"
port string Номер порта, используемый для скриптов SSH и TELNET.

Поведение свойства:
- поддерживается если type установлен в "SSH" или "TELNET"
groupid ID ID группы узлов сети, на которой можно запускать скрипт.

Если установлено значение "0", скрипт будет доступен для всех групп узлов сети.

По умолчанию: 0.
usrgrpid ID ID группы пользователей, которым будет разрешено запускать скрипт.

Если установлено значение "0", скрипт будет доступен для всех групп пользователей.

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

Поведение свойства:
- поддерживается если scope установлен в "manual host action" или "manual event action"
host_access integer Права узла сети, необходимые для запуска скрипта.

Возможные значения:
2 - (по умолчанию) чтение;
3 - запись.

Поведение свойства:
- поддерживается если scope установлен в "manual host action" или "manual event action"
confirmation string Текст всплывающего окна подтверждения.
Всплывающее окно появится при попытке запустить скрипт из веб-интерфейса Zabbix.

Поведение свойства:
- поддерживается если scope установлен в "manual host action" или "manual event action"
timeout string Тайм-аут выполнения скрипта вебхука в секундах. Поддерживаются суффиксы времени (например, 30s, 1m).

Возможные значения: 1-60s.

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

Поведение свойства:
- обязательно если type установлен в "Webhook"
parameters array Массив входных параметров вебхука.

Поведение свойства:
- поддерживается если type установлен в "Webhook"
description string Описание скрипта.
url string Пользовательский URL.

Поведение свойства:
- обязательно если type установлен в "URL"
new_window integer Открывать URL в новом окне.

Возможные значения:
0 - Нет;
1 - (по умолчанию) Да.

Поведение свойства:
- поддерживается если type установлен в "URL"
manualinput integer Указывает, принимает ли скрипт ввод, предоставленный пользователем.

Возможные значения:
0 - (по умолчанию) Отключено;
1 - Включено;

Поведение свойства:
- поддерживается если scope установлен в "manual host action" или "manual event action"
manualinput_prompt string Текст приглашения для ручного ввода.

Поведение свойства:
- обязательно если manualinput установлен в "Enabled"
manualinput_validator string Строковое поле, используемое для проверки ввода, предоставленного пользователем. Строка состоит либо из регулярного выражения, либо из набора значений, разделенных запятыми.

Поведение свойства:
- обязательно если manualinput установлен в "Enabled"
manualinput_validator_type integer Определяет тип ожидаемого пользовательского ввода.

Возможные значения:
0 - (по умолчанию) String. Указывает, что manualinput_validator следует трактовать как регулярное выражение;
1 - List. Указывает, что manualinput_validator следует трактовать как список возможных значений ввода, разделенных запятыми.

Поведение свойства:
- поддерживается если manualinput установлен в "Enabled"
manualinput_default_value string Значение по умолчанию для автоматического заполнения пользовательского ввода.

Поведение свойства:
- поддерживается если manualinput_validator_type установлен в "String"

Параметры вебхука

Параметры, передаваемые в скрипт вебхука при его вызове, имеют следующие свойства.

Property Type Description
name string Имя параметра.

Поведение свойства:
- required
value string Значение параметра. Поддерживает макросы.

Отладка

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

Property Type Description
logs array Массив записей журнала.
ms string Длительность выполнения скрипта в миллисекундах.

Запись журнала

Объект записи журнала имеет следующие свойства.

Property Type Description
level integer Уровень журнала.
ms string Время, прошедшее в миллисекундах с момента запуска скрипта до добавления записи журнала.
message string Сообщение журнала.