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

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



[comment]: # ({84212e5d-b5ff62ed})
### Descripción

`object hostgroup.propagate(object parameters)`

Este método permite aplicar permisos y filtros de etiquetas a todos los subgrupos de un grupo de equipos.

::: noteclassic
Este método solo está disponible para los tipos de usuario *Super admin*.
Los permisos para llamar al método pueden ser revocados en la configuración del rol de usuario.
Consulte [Roles de usuario](/manual/web_interface/frontend_sections/users/user_roles) para más información.
:::

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



[comment]: # ({946f3f47-6102edd8})
### Parámetros

`(object)` Parámetros que definen la salida deseada.

El método admite los siguientes parámetros.

|Parámetro|[Tipo](/manual/api/reference_commentary#data-types)|Descripción|
|--|--|------|
|groups|object/array|[Grupos de hosts](/manual/api/reference/hostgroup/object) a propagar.<br><br>Los grupos de hosts deben tener definida la propiedad `groupid`.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio*|
|permissions|boolean|Establecer en "true" para propagar los permisos.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio* si `tag_filters` no está establecido|
|tag_filters|boolean|Establecer en "true" para propagar los filtros de etiquetas.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio* si `permissions` no está establecido|

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



[comment]: # ({f0b30152-42ead635})
### Valores de retorno

`(object)` Devuelve un objeto que contiene los IDs de los grupos de equipos propagados bajo la propiedad `groupids`.

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



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

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



[comment]: # ({bd95271f-8ec85132})
#### Propagando permisos de grupo de equipos y filtros de etiquetas a sus subgrupos.

Propaga los permisos de grupo de equipos y los filtros de etiquetas a sus subgrupos.

[Solicitud](/manual/api#performing-requests):

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

Respuesta:

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

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



[comment]: # ({5e0375b3-10bafee5})
### Véase también

-   [hostgroup.update](update)
-   [hostgroup.massadd](massadd)
-   [Equipo](/manual/api/reference/host/object#host)

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



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

CHostGroup::propagate() en
*ui/include/classes/api/services/CHostGroup.php*.

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