update_image
Чтобы установить или изменить иконку объекта, используйте метод unit/update_image.
Чтобы скопировать иконку другого объекта, используйте следующую сигнатуру:
svc=unit/update_image¶ms={
"itemId": <long>,
"oldItemId": <long>
}
Чтобы использовать иконку из библиотеки, используйте следующую сигнатуру:
svc=unit/update_image¶ms={
"itemId": <long>,
"libId": <long>,
"path": <text>
}
Параметры
Запрос должен содержать следующие параметры:
| Параметр | Описание |
|---|---|
itemId |
ID объекта, к которому нужно применить иконку. |
oldItemId |
ID объекта, из которого нужно скопировать иконку. |
libId |
ID ресурса, в котором хранится нужное изображение. Чтобы использовать библиотеку по умолчанию, укажите 0. |
path |
Путь к файлу изображения. |
Ответ
Если запрос выполнен успешно, возвращается пустой объект:
{}
В противном случае возвращается код ошибки.
Коды ошибок
| Код ошибки | Описание |
|---|---|
| 4 | Неверные входные параметры: itemId отсутствует или имеет неверный тип, либо запрос не содержит ни oldItemId, ни libId вместе с path. |
| 6 | Не удалось установить или изменить иконку объекта. |
| 7 | Объект или группа объектов не существует, у пользователя нет права доступа Изменение иконки на него, или объект, указанный в oldItemId, недоступен. |