[comment]: # translation:outdated

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

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



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

`object hostgroup.propagate(object parameters)`

Questo metodo consente di applicare permessi e filtri tag a tutti i sottogruppi di un gruppo di host.

::: noteclassic
Questo metodo è disponibile solo per gli utenti di tipo *Super admin*.
I permessi per chiamare il metodo possono essere revocati nelle impostazioni dei ruoli utente.
Vedi [Ruoli
utente](/manual/web_interface/frontend_sections/users/user_roles)
per ulteriori informazioni.
:::

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



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

`(object)` Parametri che definiscono l'output desiderato.

Il metodo supporta i seguenti parametri.

|Parametro|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|groups|object/array|[Gruppi di host](/manual/api/reference/hostgroup/object) da propagare.<br><br>I gruppi di host devono avere la proprietà `groupid` definita.<br><br>[Comportamento dei parametri](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio*|
|permissions|boolean|Impostare su "true" per propagare i permessi.<br><br>[Comportamento dei parametri](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio* se `tag_filters` non è impostato|
|tag_filters|boolean|Impostare su "true" per propagare i filtri tag.<br><br>[Comportamento dei parametri](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio* se `permissions` non è impostato|

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



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

`(object)` Restituisce un oggetto contenente gli ID dei gruppi di host propagati
sotto la proprietà `groupids`.

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



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

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



[comment]: # ({bd95271f-8ec85132})
#### Propagazione dei permessi del gruppo host e dei filtri tag ai suoi sottogruppi.

Propaga i permessi del gruppo host e i filtri tag ai suoi sottogruppi.

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

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

Risposta:

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

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



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

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

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



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

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

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