usermacro.update
Описание
object usermacro.update(object/array hostMacros)
Этот метод позволяет обновлять существующие макросы узла сети.
Этот метод доступен только пользователям типов Admin и Super admin. Разрешения на вызов метода можно отозвать в настройках роли пользователя. Дополнительную информацию см. в разделе Роли пользователей.
Параметры
(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
}Изменение значения макроса, созданного правилом обнаружения
Преобразуйте созданный правилом обнаружения "automatic" макрос в "manual" и измените его значение на "new-value".
{
"jsonrpc": "2.0",
"method": "usermacro.update",
"params": {
"hostmacroid": "1",
"value": "new-value",
"automatic": "0"
},
"id": 1
}Response:
{
"jsonrpc": "2.0",
"result": {
"hostmacroids": [
"1"
]
},
"id": 1
}Источник
CUserMacro::update() в ui/include/classes/api/services/CUserMacro.php.