批量更新

描述

hostgroup.massupdate(对象参数)对象

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

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

参数

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

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

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

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

模板必须定义了 templateid 属性。

返回值

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

示例

替换主机组中的主机

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

请求:

  1. {
  2.            "jsonrpc": "2.0",
  3.            "method": "hostgroup.massupdate",
  4.            "params": {
  5.                "groups": [
  6.                    {
  7.                        "groupid": "6"
  8.                    }
  9.                ],
  10.                "hosts": [
  11.                    {
  12.                        "hostid": "30050"
  13.                    }
  14.                ],
  15.                "templates": []
  16.            },
  17.            "auth": "f223adf833b2bf2ff38574a67bba6372",
  18.            "id": 1
  19.        }

响应:

  1. {
  2.            "jsonrpc": "2.0",
  3.            "result": {
  4.                "groupids": [
  5.                    "6",
  6.                ]
  7.            },
  8.            "id": 1
  9.        }

另请参阅

源代码

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