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 中。

Documentation

usermacro.update

描述

参数

返回值

示例

修改主机宏的值

更改由发现规则创建的宏值

来源