usermacro.update

Описание

object usermacro.update(object/array hostMacros)

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

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

Параметры

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

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

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

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

Примеры

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

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

Запрос:

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

Ответ:

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

Изменение значения макроса, созданного правилом обнаружения

Преобразуйте созданный правилом обнаружения "автоматический" макрос в "ручной" и измените его значение на "new-value".

Запрос:

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

Ответ:

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

Источник

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