[comment]: # translation:outdated

[comment]: # ({6a96957a-6a96957a})
# 删除

[comment]: # ({/6a96957a-6a96957a})

[comment]: # ({849053ec-3c7f9c00})
### 描述

`object hostgroup.delete(array hostGroupIds)`

通过此方法可以删除主机组。

如果出现以下情况，则无法删除主机组

-   它只包含属于该组的主机；
-   标记为内部；
-   由主机原型使用；
-   在全局脚本中使用；
-   在相关条件下使用。

::: noteclassic
此方法仅适用于 *Admin* 和 *Super admin* 用户类型。调用该方法的权限可在用户角色设置中撤销。更多信息，请参阅 [用户角色](/manual/web_interface/frontend_sections/users/user_roles)。
:::

[comment]: # ({/849053ec-3c7f9c00})

[comment]: # ({af1f0187-af1f0187})
### 参数

`(array)` 要删除的主机组的 ID。

[comment]: # ({/af1f0187-af1f0187})

[comment]: # ({288daefc-288daefc})
### 返回值

`(object)` 返回一个对象，在 `groupids` 属性下包含已删除的主机组的 ID。

[comment]: # ({/288daefc-288daefc})

[comment]: # ({b41637d2-b41637d2})
### 示例

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({4122f4d9-a6d8d11e})
#### 删除多个主机组

删除两个主机组。

[请求](/manual/api#performing-requests)：

```json
{
    "jsonrpc": "2.0",
    "method": "hostgroup.delete",
    "params": [
        "107824",
        "107825"
    ],
    "id": 1
}
```

响应：

```json
{
    "jsonrpc": "2.0",
    "result": {
        "groupids": [
            "107824",
            "107825"
        ]
    },
    "id": 1
}
```

[comment]: # ({/4122f4d9-a6d8d11e})

[comment]: # ({f496d50e-f496d50e})
### 来源

CHostGroup::delete() 在
*ui/include/classes/api/services/CHostGroup.php*.

[comment]: # ({/f496d50e-f496d50e})