Справочный центр Wialon

update_item_access

Чтобы предоставить пользователю права доступа на элемент, используйте метод user/update_item_access.

Copied!
svc=user/update_item_access&params={
    "userId": <long>,
    "itemId": <long>,
    "accessMask": <long>
}

Сохраненная маска содержит только те права доступа, которые есть у текущего пользователя на элемент: биты, которых у текущего пользователя нет, отбрасываются. Метод не добавляет зависимые права доступа. Например, если в системе мониторинга выбрать право доступа Редактирование задач, право доступа Редактирование статусов задач и управление комментариями выбирается автоматически, однако этот метод сохраняет только биты, переданные в accessMask.

При обновлении прав доступа в журнал элемента и в журнал пользователя добавляется запись update_access. В журнале элемента параметр p1 содержит новую и предыдущую маски через запятую, а p2 — имя пользователя.

Параметры

Обязательные параметры отмечены звездочкой (*).

Название Описание
userId* ID пользователя.
itemId* ID элемента.
accessMask* Маска доступа. Описание флагов смотрите в разделе Флаги доступа.

Ответ

В случае успешного выполнения запроса возвращается пустой объект.

Copied!
{}

В случае неудачного выполнения запроса возвращается код ошибки.

Коды ошибок

Код ошибки Описание
4 Неверные входные параметры.
6 Не удалось обновить доступ к элементу.
7 Одна из следующих ошибок:
  • Пользователь или элемент не найден.
  • У вас нет права доступа Управление правами доступа пользователя на пользователя или права доступа Управление доступом к элементу на элемент.
  • Итоговая маска равна 0, а пользователь является создателем элемента или находится в иерархии выше создателя.

Если вы заметили ошибку в тексте, пожалуйста, выделите её и нажмите Ctrl+Enter.