usermacro.update

描述

object usermacro.update(object/array hostMacros)

此方法用于 update 现有的 主机宏。

此方法仅适用于 管理员 和 超级管理员 用户类型。调用该方法的权限可以在用户角色设置中撤销。更多信息请参见 User roles。

参数

(object/array) 主机宏 将被 更新。

必须为每个 主机 宏定义 hostmacroid 属性，所有其他属性均为可选。仅更新传递的属性，其他属性将保持不变。

返回值

(object) 返回一个 object，其中包含已更新的 主机 宏的 ID，这些 ID 位于 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
}

Response:

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

来源

CUserMacro::update() 在 ui/include/classes/api/services/CUserMacro.php 中。