批量添加

描述

hostgroup.massadd(对象参数)对象

该方法允许在给定的主机组中同时添加多个相关对象。

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

参数

(对象) 参数包含要更新的主机组id和要添加到所有主机组的对象。

该方法接受以下参数。

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

主机组必须定义了 groupid 属性。
hosts 对象/数组 待添加给所有主机组的主机。

主机必须定义了 hostid 属性。
templates 对象/数组 需要添加到所有主机组的模板。

模板必须定义了 templateid 属性。

返回值

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

示例

给主机组添加主机

给ID为5和6的主机组添加两个主机。

请求:

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

响应:

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

另请参阅

源代码

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