[comment]: # aside: 1
[comment]: # ({70c23b61-2135842b})
# Объект роли
Следующие объекты напрямую связаны с API `role`.
[comment]: # ({/70c23b61-2135842b})
[comment]: # ({4c760d03-1708e020})
### Роль
Объект role имеет следующие свойства:
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|roleid|ID|ID роли.
[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *только для чтения*
- *обязательно* для операций обновления|
|name|string|Имя роли.
[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *обязательно* для операций создания|
|type|integer|Тип пользователя.
Возможные значения:
1 - *(по умолчанию)* Пользователь;
2 - Администратор;
3 - Суперадминистратор.
[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *обязательно* для операций создания|
|readonly|integer|Указывает, является ли роль доступной только для чтения.
Возможные значения:
0 - *(по умолчанию)* Нет;
1 - Да.
[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *только для чтения*|
[comment]: # ({/4c760d03-1708e020})
[comment]: # ({28862318-8a9b3008})
### Правила роли
Объект правил роли имеет следующие свойства:
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|ui|array|Массив объектов [элемент интерфейса пользователя](object#ui-element).|
|ui.default\_access|integer|Включен ли доступ к новым элементам интерфейса пользователя.
Возможные значения:
0 - Отключено;
1 - *(по умолчанию)* Включено.|
|services.read.mode|integer|Доступ только для чтения к сервисам.
Возможные значения:
0 - Доступ только для чтения к сервисам, указанным в `services.read.list` или совпадающим со свойством `services.read.tag`;
1 - *(по умолчанию)* Доступ только для чтения ко всем сервисам.|
|services.read.list|array|Массив объектов [Service](object#service).
Указанным сервисам, включая дочерние сервисы, будет предоставлен доступ только для чтения для пользовательской роли. Доступ только для чтения не переопределяет доступ на чтение и запись к сервисам.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *supported* if `services.read.mode` is set to "0"|
|services.read.tag|object|Массив объектов [Service tag](object#service-tag).
Сервисам, совпавшим по тегу, включая дочерние сервисы, будет предоставлен доступ только для чтения для пользовательской роли. Доступ только для чтения не переопределяет доступ на чтение и запись к сервисам.
[Property behavior](/manual/api/reference_commentary#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](object#service).
Указанным сервисам, включая дочерние сервисы, будет предоставлен доступ на чтение и запись для пользовательской роли. Доступ на чтение и запись переопределяет доступ только для чтения к сервисам.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *supported* if `services.write.mode` is set to "0"|
|services.write.tag|object|Массив объектов [Service tag](object#service-tag).
Сервисам, совпавшим по тегу, включая дочерние сервисы, будет предоставлен доступ на чтение и запись для пользовательской роли. Доступ на чтение и запись переопределяет доступ только для чтения к сервисам.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *supported* if `services.write.mode` is set to "0"|
|modules|array|Массив объектов [module](object#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](object#action).|
|actions.default\_access|integer|Включен ли доступ к новым действиям.
Возможные значения:
0 - Отключено;
1 - *(по умолчанию)* Включено.|
[comment]: # ({/28862318-8a9b3008})
[comment]: # ({b7519b73-006cdfb5})
#### UI element
Объект UI element имеет следующие свойства:
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|name|string|Имя UI element.
Возможные значения, если `type` объекта [Role](#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](#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](#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](/manual/api/reference_commentary#property-behavior):
- *required*|
|status|integer|Включен ли доступ к UI element.
Возможные значения:
0 - Отключено;
1 - *(по умолчанию)* Включено.|
[comment]: # ({/b7519b73-006cdfb5})
[comment]: # ({e891a8d2-ebf4bb3a})
#### Сервис
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|serviceid|ID|ID службы.
[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required*|
[comment]: # ({/e891a8d2-ebf4bb3a})
[comment]: # ({62d78428-300e6d5b})
#### Тег сервиса
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|tag|string|Имя тега.
Если указана пустая строка, тег сервиса не будет использоваться для сопоставления сервиса.
[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required*|
|value|string|Значение тега.
Если значение не указано или указана пустая строка, для сопоставления сервиса будет использоваться только имя тега.|
[comment]: # ({/62d78428-300e6d5b})
[comment]: # ({bdcf5af8-f70e75e9})
#### Модуль
Объект module имеет следующие свойства:
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|moduleid|ID|ID модуля.
[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required*|
|status|integer|Включен ли доступ к модулю.
Возможные значения:
0 - Отключено;
1 - *(по умолчанию)* Включено.|
[comment]: # ({/bdcf5af8-f70e75e9})
[comment]: # ({17265016-957a00bb})
#### Действие
Объект action имеет следующие свойства:
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|name|string|Имя действия.
Возможные значения, если `type` объекта [Role](#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](#role) задан как "Admin" или "Super admin":
`edit_maintenance` - Создание и редактирование обслуживаний;
`manage_scheduled_reports` - Управление запланированными отчетами,
`manage_sla` - Управление SLA.
Возможные значения, если `type` объекта [Role](#role) задан как "User" или "Admin":
`invoke_execute_now` - позволяет выполнять проверки элементов данных для пользователей, у которых есть только права на чтение на узле сети.
Возможные значения, если `type` объекта [Role](#role) задан как "Super admin":
`edit_user_media` - Разрешить создавать/редактировать медиа для пользователей.
[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required*|
|status|integer|Включен ли доступ для выполнения действия.
Возможные значения:
0 - Отключено;
1 - *(по умолчанию)* Включено.|
[comment]: # ({/17265016-957a00bb})