[comment]: # translation:outdated

[comment]: # ({259f747f-259f747f})
# hostgroup.update

[comment]: # ({/259f747f-259f747f})

[comment]: # ({fbba55d3-32bf01b5})
### Опис

`object hostgroup.update(object/array hostGroups)`

Цей метод дозволяє оновити існуючі групи хостів.

::: noteclassic
Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації.
:::

[comment]: # ({/fbba55d3-32bf01b5})

[comment]: # ({9c20e34d-9c20e34d})
### Параметри

`(object/array)` [Властивості групи хостів](object#host_group) потрібно оновити.

Властивість groupid має бути визначена для кожної групи хостів, усі інші властивості необов’язкові. Будуть оновлені лише вказані властивості, всі інші залишаться незмінними.

[comment]: # ({/9c20e34d-9c20e34d})

[comment]: # ({736f3b05-736f3b05})
### Повернуті значення

`(object)` Повертає об’єкт, що містить ідентифікатори оновлених груп хостів у властивості `groupids`.

[comment]: # ({/736f3b05-736f3b05})

[comment]: # ({b41637d2-b41637d2})
### Приклади

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

[comment]: # ({b7400238-a296ad88})
#### Перейменування групи хостів

Перейменуйте групу хостів на «Linux hosts».

Запит:

```json
{
    "jsonrpc": "2.0",
    "method": "hostgroup.update",
    "params": {
        "groupid": "7",
        "name": "Linux hosts"
    },
    "auth": "700ca65537074ec963db7efabda78259",
    "id": 1
}
```

Відповідь:

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

[comment]: # ({/b7400238-a296ad88})

[comment]: # ({b75d89b4-b75d89b4})
### Джерело

CHostGroup::update() в *ui/include/classes/api/services/CHostGroup.php*.

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