Объект роли

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

Роль

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

Property Type Description
roleid ID ID роли.

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

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

Возможные значения:
1 - (по умолчанию) Пользователь;
2 - Администратор;
3 - Суперадминистратор.

Поведение свойства:
- обязательно для операций создания
readonly integer Указывает, является ли роль доступной только для чтения.

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

Поведение свойства:
- только для чтения

Правила роли

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

Property Type Description
ui array Массив объектов элемент интерфейса пользователя.
ui.default_access integer Включен ли доступ к новым элементам интерфейса пользователя.

Возможные значения:
0 - Отключено;
1 - (по умолчанию) Включено.
services.read.mode integer Доступ только для чтения к сервисам.

Возможные значения:
0 - Доступ только для чтения к сервисам, указанным в services.read.list или совпадающим со свойством services.read.tag;
1 - (по умолчанию) Доступ только для чтения ко всем сервисам.
services.read.list array Массив объектов Service.

Указанным сервисам, включая дочерние сервисы, будет предоставлен доступ только для чтения для пользовательской роли. Доступ только для чтения не переопределяет доступ на чтение и запись к сервисам.

Property behavior:
- supported if services.read.mode is set to "0"
services.read.tag object Массив объектов Service tag.

Сервисам, совпавшим по тегу, включая дочерние сервисы, будет предоставлен доступ только для чтения для пользовательской роли. Доступ только для чтения не переопределяет доступ на чтение и запись к сервисам.

Property behavior:
- supported if services.read.mode is set to "0"
services.write.mode integer Доступ на чтение и запись к сервисам.

Возможные значения:
0 - (по умолчанию) Доступ на чтение и запись к сервисам, указанным в services.write.list или совпадающим со свойством services.write.tag;
1 - Доступ на чтение и запись ко всем сервисам.
services.write.list array Массив объектов Service.

Указанным сервисам, включая дочерние сервисы, будет предоставлен доступ на чтение и запись для пользовательской роли. Доступ на чтение и запись переопределяет доступ только для чтения к сервисам.

Property behavior:
- supported if services.write.mode is set to "0"
services.write.tag object Массив объектов Service tag.

Сервисам, совпавшим по тегу, включая дочерние сервисы, будет предоставлен доступ на чтение и запись для пользовательской роли. Доступ на чтение и запись переопределяет доступ только для чтения к сервисам.

Property behavior:
- supported if services.write.mode is set to "0"
modules array Массив объектов module.
modules.default_access integer Включен ли доступ к новым модулям.

Возможные значения:
0 - Отключено;
1 - (по умолчанию) Включено.
api.access integer Включен ли доступ к API.

Возможные значения:
0 - Отключено;
1 - (по умолчанию) Включено.
api.mode integer Режим обработки методов API, перечисленных в свойстве api.

Возможные значения:
0 - (по умолчанию) Список запрещенных;
1 - Список разрешенных.
api array Массив методов API.
actions array Массив объектов action.
actions.default_access integer Включен ли доступ к новым действиям.

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

UI element

Объект UI element имеет следующие свойства:

Property Type Description
name string Имя UI element.

Возможные значения, если type объекта Role задан как "User", "Admin" или "Super admin":
monitoring.dashboard - Панели;
monitoring.problems - Мониторинг → Проблемы;
monitoring.hosts - Мониторинг → Узлы сети;
monitoring.latest_data - Мониторинг → Последние данные;
monitoring.maps - Мониторинг → Карты;
services.services - Услуги → Услуги;
services.sla_report - Услуги → Отчет SLA;
inventory.overview - Инвентаризация → Обзор;
inventory.hosts - Инвентаризация → Узлы сети;
reports.availability_report - Отчеты → Отчет о доступности;
reports.top_triggers - Отчеты → Триггеры топ 100.

Возможные значения, если type объекта Role задан как "Admin" или "Super admin":
monitoring.discovery - Мониторинг → Обнаружение;
services.sla - Услуги → SLA;
reports.scheduled_reports - Отчеты → Запланированные отчеты;
reports.notifications - Отчеты → Уведомления;
configuration.template_groups - Сбор данных → Группы шаблонов;
configuration.host_groups - Сбор данных → Группы узлов сети;
configuration.templates - Сбор данных → Шаблоны;
configuration.hosts - Сбор данных → Узлы сети;
configuration.maintenance - Сбор данных → Обслуживание;
configuration.discovery - Сбор данных → Обнаружение;
configuration.trigger_actions - Оповещения → Действия → Действия по триггерам;
configuration.service_actions - Оповещения → Действия → Действия по услугам;
configuration.discovery_actions - Оповещения → Действия → Действия по обнаружению;
configuration.autoregistration_actions - Оповещения → Действия → Действия автрорегистрации;
configuration.internal_actions - Оповещения → Действия → Внутренние действия.

Возможные значения, если type объекта Role задан как "Super admin":
reports.system_info - Отчеты → Сведения о системе;
reports.audit - Отчеты → Журнал аудита;
reports.action_log - Отчеты → Журнал действий;
configuration.event_correlation - Сбор данных → Корреляция событий;
administration.media_types - Оповещения → Типы медиа;
administration.scripts - Оповещения → Скрипты;
administration.user_groups - Пользователи → Группы пользователей;
administration.user_roles - Пользователи → Роли пользователей;
administration.users - Пользователи → Пользователи;
administration.api_tokens - Пользователи → API tokens;
administration.authentication - Пользователи → Аутентификация;
administration.general - Администрирование → Общие;
administration.audit_log - Администрирование → Журнал аудита;
administration.housekeeping - Администрирование → Housekeeping;
administration.proxy_groups - Администрирование → Группы прокси;
administration.proxies - Администрирование → Прокси;
administration.macros - Администрирование → Макросы;
administration.queue - Администрирование → Очередь.

Property behavior:
- required
status integer Включен ли доступ к UI element.

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

Сервис

Property Type Description
serviceid ID ID службы.

Поведение свойства:
- required

Тег сервиса

Property Type Description
tag string Имя тега.

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

Поведение свойства:
- required
value string Значение тега.

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

Модуль

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

Property Type Description
moduleid ID ID модуля.

Поведение свойства:
- required
status integer Включен ли доступ к модулю.

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

Действие

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

Property Type Description
name string Имя действия.

Возможные значения, если type объекта Role задан как "User", "Admin" или "Super admin":
edit_dashboards - Создание и редактирование панелей;
edit_maps - Создание и редактирование карт;
add_problem_comments - Добавление комментариев к проблемам;
change_severity - Изменение серьезности проблемы;
acknowledge_problems - Подтверждение проблем;
suppress_problems - Подавление проблем;
close_problems - Закрытие проблем;
execute_scripts - Выполнение скриптов;
manage_api_tokens - Управление API-токенами;
change_problem_ranking - Изменение ранга проблемы с причины на симптом и наоборот;
edit_own_media - Разрешить создавать/редактировать собственные медиа.

Возможные значения, если type объекта Role задан как "Admin" или "Super admin":
edit_maintenance - Создание и редактирование обслуживаний;
manage_scheduled_reports - Управление запланированными отчетами,
manage_sla - Управление SLA.

Возможные значения, если type объекта Role задан как "User" или "Admin":
invoke_execute_now - позволяет выполнять проверки элементов данных для пользователей, у которых есть только права на чтение на узле сети.

Возможные значения, если type объекта Role задан как "Super admin":
edit_user_media - Разрешить создавать/редактировать медиа для пользователей.

Поведение свойства:
- required
status integer Включен ли доступ для выполнения действия.

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