hostgroup.update

Описание

object hostgroup.update(object/array hostGroups)

Этот метод позволяет обновлять существующие группы узлов сети.

Этот метод доступен только для типов пользователей Admin и Super admin. Разрешения на вызов метода могут быть отозваны в настройках роли пользователя. Дополнительную информацию см. в разделе Роли пользователей.

Параметры

(object/array) Свойства группы узлов сети, которые необходимо обновить.

Свойство groupid должно быть определено для каждой группы узлов сети, все остальные свойства необязательны. Будут обновлены только указанные свойства, все остальные останутся без изменений.

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

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

Примеры

Переименование группы узлов сети

Переименуйте группу узлов сети в "Linux hosts".

Запрос:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.update",
    "params": {
        "groupid": "7",
        "name": "Linux hosts"
    },
    "id": 1
}

Ответ:

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

Переименование нескольких групп узлов сети

Переименуйте две группы узлов сети, чтобы включить информацию о регионе в их имена.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.update",
    "params": [
        {
            "groupid": "8",
            "name": "Europe/Linux hosts"
        },
        {
            "groupid": "9",
            "name": "Europe/Windows hosts"
        }
    ],
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "groupids": [
            "8",
            "9"
        ]
    },
    "id": 1
}

Источник

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