hostgroup.propagate

Описание

object hostgroup.propagate(параметры объекта)

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

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

Параметры

(object) Параметры, определяющие требуемый результат.

Метод поддерживает следующие параметры.

|Parameter|Type|Description|

|--|--|------|

|groups|object/array|Группы узлов сети, которые нужно распространить.

Группы узлов сети должны иметь определенное свойство groupid.

Поведение параметра:
- required|

|permissions|boolean|Установите значение "true", чтобы распространить права доступа.

Поведение параметра:
- required если tag_filters не задан|

|tag_filters|boolean|Установите значение "true", чтобы распространить фильтры тегов.

Поведение параметра:
- required если permissions не задан|

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

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

Примеры

Распространение прав доступа к группе узлов сети и фильтров тегов на ее подгруппы.

Распространить права доступа к группе узлов сети и фильтры тегов на ее подгруппы.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.propagate",
    "params": {
        "groups": [
            {
                "groupid": "6"
            }
        ],
        "permissions": true,
        "tag_filters": true
    },
    "id": 1
}

Ответ:

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

См. также

Исходный код

CHostGroup::propagate() в

ui/include/classes/api/services/CHostGroup.php.