Sidebar

批量更新

描述

hostgroup.massupdate(对象参数)对象

通过该方式,可以将多个主机组中的主机和模板替换为指定的主机和模板。

这个方法仅允许 管理员超级管理员 用户类型。可以在用户角色中撤销调用方法的权限设置。详情参考 用户角色

参数

(对象) 参数包含要更新的主机组id和应该更新的对象。

参数 描述
groups
(必填)
对象/数组 待更新的主机组。

主机组必须定义了 groupid 属性。
hosts
(必填)
对象/数组 主机替换给定主机组上的当前主机。
除上述主机外,其他所有主机将被排除在主机组之外。
发现的主机不受影响。

主机必须定义了 hostid 属性。
templates
(必填)
对象/数组 模板用于替换给定主机组上的当前模板。
除以上提到的模板外,其他所有模板将被排除在主机组之外。

模板必须定义了 templateid 属性。

返回值

(对象) 返回一个对象,该对象包含 groupids 属性下的已更新主机组的id。

示例

替换主机组中的主机

将主机组中的所有主机替换为hostid为30050的主机,并解除主机组中所有模板的链接。

请求:

{
           "jsonrpc": "2.0",
           "method": "hostgroup.massupdate",
           "params": {
               "groups": [
                   {
                       "groupid": "6"
                   }
               ],
               "hosts": [
                   {
                       "hostid": "30050"
                   }
               ],
               "templates": []
           },
           "auth": "f223adf833b2bf2ff38574a67bba6372",
           "id": 1
       }

响应:

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

另请参阅

源代码

CHostGroup::massUpdate() in ui/include/classes/api/services/CHostGroup.php.