Это перевод страницы документации с английского языка. Помогите нам сделать его лучше.

usermacro.createglobal

Описание

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

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

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

Параметры

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

Этот метод принимает глобальные макросы со стандартными свойствами глобального макроса.

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

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

Примеры

Создание глобального макроса

Создание глобального макроса "{$SNMP_COMMUNITY}" со значением "public".

Запрос:

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

Ответ:

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

Источник

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