object hostgroup.massadd(object parameters)
此方法允许同时向所有指定的主机组批量添加多个关联的objects。
此方法仅限管理员和超级管理员用户类型使用。调用权限可通过用户角色设置进行撤销。详见User roles获取更多信息。
(object)
参数包含待更新的主机组ID及需要添加到所有主机组的objects。
该方法接受以下参数。
参数 | 数据类型 | 说明 |
---|---|---|
groups (required) |
object/array | 待更新的主机组。 主机组必须定义 groupid 属性。 |
hosts | object/array | 需添加到所有主机组的主机。 主机必须定义 hostid 属性。 |
templates | object/array | 需添加到所有主机组的模板。 模板必须定义 templateid 属性。 |
(object)
返回一个包含已更新object的主机组ID的数组,该数组位于groupids
属性下。
将两个主机添加到ID为5和6的主机组中。
请求:
{
"jsonrpc": "2.0",
"method": "hostgroup.massadd",
"params": {
"groups": [
{
"groupid": "5"
},
{
"groupid": "6"
}
],
"hosts": [
{
"hostid": "30050"
},
{
"hostid": "30001"
}
]
},
"auth": "f223adf833b2bf2ff38574a67bba6372",
"id": 1
}
响应:
CHostGroup::massAdd() 方法位于 ui/include/classes/api/services/CHostGroup.php 文件中。