[comment]: # ({de01ad95-f9e8f670})
# hostgroup.propagate

[comment]: # ({/de01ad95-f9e8f670})



[comment]: # ({84212e5d-b5ff62ed})
### Описание

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

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

::: noteclassic
Этот метод доступен только пользователю с типом доступа *Супер-администратор*.
Разрешения на вызов метода можно отозвать в настройках ролей пользователя.
Дополнительную информацию см. в разделе [Роли пользователей](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/84212e5d-b5ff62ed})



[comment]: # ({946f3f47-6102edd8})
### Параметры



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



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



|Parameter|[Type](/manual/api/reference_commentary#data-types)|Description|

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

|groups|object/array|[Группы узлов сети](/manual/api/reference/hostgroup/object), которые нужно распространить.<br><br>Группы узлов сети должны иметь определенное свойство `groupid`.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|

|permissions|boolean|Установите значение "true", чтобы распространить права доступа.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *required* если `tag_filters` не задан|

|tag_filters|boolean|Установите значение "true", чтобы распространить фильтры тегов.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *required* если `permissions` не задан|

[comment]: # ({/946f3f47-6102edd8})



[comment]: # ({f0b30152-42ead635})
### Возвращаемые значения



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

[comment]: # ({/f0b30152-42ead635})



[comment]: # ({b41637d2-018502e3})
### Примеры

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



[comment]: # ({bd95271f-8ec85132})
#### Распространение прав доступа к группе узлов сети и фильтров тегов на ее подгруппы.

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

[Запрос](/manual/api#performing-requests):

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

Ответ:

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

[comment]: # ({/bd95271f-8ec85132})



[comment]: # ({5e0375b3-10bafee5})
### См. также



-   [hostgroup.update](update)

-   [hostgroup.massadd](massadd)

-   [Узел сети](/manual/api/reference/host/object#host)

[comment]: # ({/5e0375b3-10bafee5})



[comment]: # ({fb50ec6c-a745b72a})
### Исходный код



CHostGroup::propagate() в

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

[comment]: # ({/fb50ec6c-a745b72a})