# hostgroup.delete

### Описание

`объект hostgroup.delete(массив hostGroupIds)`

Этот метод позволяет удалять группы узлов сети.

Группу узлов сети нельзя удалить в случае, если:

-   она содержит узлы сети, которые принадлежат только этой группе узлов
    сети;
-   она отмечена как внутренняя;
-   она используется прототипом узлов сети;
-   она используется в глобальном скрипте;
-   она используется в условии корреляции.

### Параметры

`(массив)` ID удаляемых групп узлов сети.

### Возвращаемые значения

`(объект)` Возвращает объект, который содержит ID удаленных групп узлов
сети под свойством `groupids`.

### Примеры

#### Удаление нескольких групп узлов сети

Удаление двух групп узлов сети.

Запрос:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "hostgroup.delete",
    "params": [
        "107824",
        "107825"
    ],
    "auth": "3a57200802b24cda67c4e4010b50c065",
    "id": 1
}
```

Ответ:

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

### Исходный код

CHostGroup::delete() в
*frontends/php/include/classes/api/services/CHostGroup.php*.