usermacro.update

Описание

object usermacro.update(объект/массив hostMacros)

Этот метод позволяет обновлять существующие макросы хоста.

Этот метод доступен только пользователям с типом доступа Администратор и Супер-администратор. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.

Параметры

(объект/массив) Свойства макроса узла сети, которые будут обновлены.

Свойство hostmacroid должно быть указано по каждому макросу узла сети, все остальные свойства опциональны. Будут обновлены только переданные свойства, все остальные останутся неизменными.

Возвращаемые значения

(объект) Возвращает объект, который содержит ID обновленных макросов узла сети под свойством hostmacroids.

Примеры

Изменение значения макроса узла сети

Изменение значения макроса узла сети на "public".

Запрос:

{
           "jsonrpc": "2.0",
           "method": "usermacro.update",
           "params": {
               "hostmacroid": "1",
               "value": "public"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": {
               "hostmacroids": [
                   "1"
               ]
           },
           "id": 1
       }

Change macro value that was created by discovery rule

Convert discovery rule created "automatic" macro to "manual" and change its value to "new-value".

Request:

{
           "jsonrpc": "2.0",
           "method": "usermacro.update",
           "params": {
               "hostmacroid": "1",
               "value": "new-value",
               "automatic": "0"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "hostmacroids": [
                   "1"
               ]
           },
           "id": 1
       }

Источник

CUserMacro::update() в ui/include/classes/api/services/CUserMacro.php.

Documentation