usermacro.create

Описание

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

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

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

Параметры

(object/array) Макросы узла сети для создания.

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

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

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

Примеры

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

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

Запрос:

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

Ответ:

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

Источник

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