删除
描述
object hostgroup.delete(array hostGroupIds)
通过此方法可以删除主机组。
如果出现以下情况,则无法删除主机组
- 它只包含属于该组的主机;
- 标记为内部;
- 由主机原型使用;
- 在全局脚本中使用;
- 在相关条件下使用。
此方法仅适用于 Admin 和 Super admin 用户类型。调用该方法的权限可在用户角色设置中撤销。更多信息,请参阅 用户角色。
参数
(array)
要删除的主机组的 ID。
返回值
(object)
返回一个对象,在 groupids
属性下包含已删除的主机组的 ID。
示例
删除多个主机组
删除两个主机组。
请求:
{
"jsonrpc": "2.0",
"method": "hostgroup.delete",
"params": [
"107824",
"107825"
],
"id": 1
}
响应:
{
"jsonrpc": "2.0",
"result": {
"groupids": [
"107824",
"107825"
]
},
"id": 1
}
来源
CHostGroup::delete() 在 ui/include/classes/api/services/CHostGroup.php.