usermacro.create

Описание

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

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

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

Параметры

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

Этот метод принимает макросы узла сети со стандартными свойствами макроса узла сети.

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

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

Примеры

Создание макроса узла сети

Создание макроса узла сети "{$SNMP_COMMUNITY}" со значением "public" на узле сети "10198".

Запрос:

{
           "jsonrpc": "2.0",
           "method": "usermacro.create",
           "params": {
               "hostid": "10198",
               "macro": "{$SNMP_COMMUNITY}",
               "value": "public"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

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

Источник

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

Documentation