Объект пользователя

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

Пользователь

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

Свойство Type Описание
userid ID ID пользователя.

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

Поведение свойства:
- обязательно для операций создания
- только для чтения для подготовленных пользователей, если пользователь связан с каталогом пользователей (userdirectoryid имеет корректное значение, отличное от "0"), включен статус подготовки каталога пользователей (provision_status объекта User directory object установлен в "1"), а также включен статус аутентификации для всей LDAP- или SAML-подготовки (ldap_jit_status объекта Authentication object установлен в "Enabled for configured LDAP IdPs" или saml_jit_status объекта Authentication object установлен в "Enabled for configured SAML IdPs")
passwd string Пароль пользователя.

Значение этого параметра может быть пустой строкой, если пользователь связан с каталогом пользователей.

Поведение свойства:
- только для записи
roleid ID ID роли пользователя.

Обратите внимание, что пользователи без роли могут входить в Zabbix только с использованием аутентификации LDAP или SAML, при условии, что их информация LDAP/SAML соответствует сопоставлениям групп пользователей, настроенным в Zabbix.
attempt_clock timestamp Время последней неуспешной попытки входа.

Поведение свойства:
- только для чтения
attempt_failed integer Количество недавних неуспешных попыток входа.

Поведение свойства:
- только для чтения
attempt_ip string IP-адрес, с которого была выполнена последняя неуспешная попытка входа.

Поведение свойства:
- только для чтения
autologin integer Следует ли включить автоматический вход.

Возможные значения:
0 - (по умолчанию) автоматический вход отключен;
1 - автоматический вход включен.
autologout string Время жизни сеанса пользователя. Принимает секунды и единицу времени с суффиксом. Если установлено значение 0s, срок действия сеанса никогда не истечет.

По умолчанию: 15m.
lang string Код языка пользователя, например en_US.

По умолчанию: default - системное значение по умолчанию.
name string Имя пользователя.
provisioned integer Был ли пользователь подготовлен.

Возможные значения:
0 - не подготовлен;
1 - подготовлен.

Поведение свойства:
- только для чтения
refresh string Период автоматического обновления. Принимает секунды или единицу времени с суффиксом (например, 30s, 90s, 1m, 1h).

По умолчанию: 30s.
rows_per_page integer Количество строк объектов, отображаемых на странице.

По умолчанию: 50.
surname string Фамилия пользователя.
theme string Тема пользователя.

Возможные значения:
default - (по умолчанию) системная тема по умолчанию;
blue-theme - Blue;
dark-theme - Dark.
ts_provisioned timestamp Время выполнения последней операции подготовки.

Поведение свойства:
- только для чтения
- поддерживается для пользователей типа Super admin
url string URL страницы, на которую пользователь будет перенаправлен после входа в систему.
userdirectoryid ID ID каталога пользователей, с которым связан пользователь.

Используется для подготовки (создания или обновления), а также для входа пользователя, связанного с каталогом пользователей.

Для операций входа значение этого свойства будет иметь приоритет над свойством userdirectoryid групп пользователей, к которым принадлежит пользователь.

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

Поведение свойства:
- только для чтения
- поддерживается для пользователей типа Super admin
timezone string Часовой пояс пользователя, например Europe/London, UTC.

По умолчанию: default - системное значение по умолчанию.

Полный список поддерживаемых часовых поясов см. в документации PHP.

Способ оповещения

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

Свойство Тип Описание
mediaid ID ID способа оповещения пользователя.

Поведение свойства:
- только для чтения
mediatypeid ID ID типа способа оповещения, используемого способом оповещения пользователя.

Поведение свойства:
- обязательно
sendto string/array Адрес, имя пользователя или другой идентификатор получателя.

Если type у типа способа оповещения установлен в значение "Email", значения представлены в виде массива. Для других типов способов оповещения значение представлено в виде строки.

Поведение свойства:
- обязательно
active integer Включен ли способ оповещения.

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

Возможные значения битовой маски:
1 - Не классифицировано;
2 - Информация;
4 - Предупреждение;
8 - Средняя;
16 - Высокая;
32 - Катастрофическая.

Это поле битовой маски; допустима любая сумма возможных значений битовой маски (например, 48 для Средняя, Высокая и Катастрофическая).

По умолчанию: 63.
period string Время, когда могут отправляться уведомления, в виде периода времени или пользовательских макросов, разделенных точкой с запятой.

По умолчанию: 1-7,00:00-24:00.
provisioned integer Был ли пользователь подготовлен.

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

Поведение свойства:
- только для чтения
- поддерживается для пользователей типа Super admin