更新

描述

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.