hostgroup.update

Описание

object hostgroup.update(объект/массив hostGroups)

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

Этот метод доступен только пользователям с типом доступа Администратор и Супер-администратор. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.

Параметры

(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.