hostgroup.massadd
描述
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 文件中。