更新

描述

object usermacro.update(object/array hostMacros)

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

此方法仅适用于Admin(管理员)和Super admin(超级管理员) 类型的用户。可在用户角色设置中撤销调用该方法的权限，参阅用户角色获取详情。

参数

(object/array) 需要更新的Host macro properties 。

必须为每个主机宏定义 hostmacroid 参数，其他所有参数都是可选的。 注意只有给定的属性将被更新，其他所有属性将保持不变。

返回值

(object) 返回包含 hostmacroids 属性（其中包含被更新主机宏的ID）的对象。

示例

更改一个主机宏的值

更改一个主机宏"public"的值。

请求:

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

响应:

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

更改自动发现规则创建的宏值

将“automatic”宏创建的发现规则转换为“manual”，并将其值更改为“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() in ui/include/classes/api/services/CUserMacro.php.