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
       }

Copy

✔ Copied

Ответ:

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

Copy

✔ Copied

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
       }

Copy

✔ Copied

Response:

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

Copy

✔ Copied

Источник

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

Documentation

usermacro.update

Описание

Параметры

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

Примеры

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

Change macro value that was created by discovery rule

Источник