Объект user

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

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

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

Property Type Description
userid ID Идентификатор пользователя.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

По умолчанию: default - системный часовой пояс по умолчанию.

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

Медиа

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

Property Type Description
mediaid ID ID media пользователя.

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

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

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

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

Возможные значения:
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 сопоставления media каталога пользователей для подготовленных media.

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