usermacro.update
Описание
object usermacro.update(объект/массив hostMacros)
Этот метод позволяет обновлять существующие макросы хоста.
Этот метод доступен только пользователям с типом доступа Администратор и Супер-администратор. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.
Параметры
(object/array) Свойства макроса узла сети, которые необходимо
обновить.
Свойство hostmacroid должно быть определено для каждого макроса узла сети, все
остальные свойства являются необязательными. Будут обновлены только переданные
свойства, все остальные останутся без изменений.
Возвращаемые значения
(object) Возвращает объект, содержащий идентификаторы обновлённых макросов узла сети в свойстве hostmacroids.
Примеры
Изменение значения макроса узла сети
Измените значение макроса узла сети на "public".
{
"jsonrpc": "2.0",
"method": "usermacro.update",
"params": {
"hostmacroid": "1",
"value": "public"
},
"id": 1
}Ответ:
{
"jsonrpc": "2.0",
"result": {
"hostmacroids": [
"1"
]
},
"id": 1
}Изменение значения макроса, который был создан правилом обнаружения
Преобразуйте созданный правилом обнаружения "автоматический" макрос в "ручной" и измените его значение на "new-value".
{
"jsonrpc": "2.0",
"method": "usermacro.update",
"params": {
"hostmacroid": "1",
"value": "new-value",
"automatic": "0"
},
"id": 1
}Ответ:
{
"jsonrpc": "2.0",
"result": {
"hostmacroids": [
"1"
]
},
"id": 1
}Источник
CUserMacro::update() в ui/include/classes/api/services/CUserMacro.php.