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


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



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

`object hostgroup.propagate(object parameters)`

Aquest mètode permet aplicar permisos i filtres d'etiquetes a tots els subgrups d'un grups d'equips.

::: noteclassic
Tenim aquest mètode disponible només per als usuaris *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/users/user_roles).
:::

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



[comment]: # ({946f3f47-6102edd8})
### Paràmetres

`(object)` Paràmetres que defineixen la sortida esperada.

El mètode admet els paràmetres següents.

|Paràmetre|[Tipus](/manual/api/reference_commentary#data-types)|Descripció|
|--|--|------|
|groups|object/array|[Grups d'equips](/manual/api/reference/hostgroup/object) on propagar.<br>Tots els altres equips excepte els esmentats seran exclosos dels grups d'equips. <br>Els equips descoberts no es veuran afectats.< br><br>Els grups d'equips han de tindre la propietat `groupid` establerta.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|
|permissions|boolean|Establir-ho a "cert" per propagar permissos.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `tag_filters` no s'ha establert pas|
|tag_filters|boolean|Establir-lo a "cert" per propagar filtres d'etiquetes.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `permissions` no s'ha establert pas|

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



[comment]: # ({f0b30152-42ead635})
### Valors de retorn

`(object)` Retorna un objecte contingut als IDs dels grups d'equips propagats sota la propietat `groupids`.

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



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

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



[comment]: # ({bd95271f-8ec85132})
#### Propagar els permisos d'un grup d'equips i filtres d'etiquetes als seus subgrups.

Propaga els permisos d'un grup d'equips i filtres d'etiquetes als seus subgrups.

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

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

Resposta:

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

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



[comment]: # ({5e0375b3-10bafee5})
### Veieu també

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

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



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

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

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