[comment]: # translation:outdated

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

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



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

`object hostgroup.propagate(object parameters)`

Deze methode maakt het mogelijk om rechten en tag-filters toe te passen op alle subgroepen van een hostgroep.

::: noteclassic
Deze methode is alleen beschikbaar voor gebruikerstypes *Superadmin*. Rechten om de methode aan te roepen kunnen worden ingetrokken in de instellingen van gebruikersrollen. Zie [Gebruikersrollen](/manual/web_interface/frontend_sections/users/user_roles) voor meer informatie.
:::

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



[comment]: # ({f61f45b9-6102edd8})
### Parameters

`(object)` Parameters die de gewenste uitvoer definiëren.

De methode ondersteunt de volgende parameters.

|Parameter|[Type](/manual/api/reference_commentary#data_types)|Beschrijving|
|--|--|------|
|groups|object/array|Te verspreiden hostgroepen.<br><br>De hostgroepen moeten de eigenschap `groupid` gedefinieerd hebben.<br><br>[Gedrag van parameter](/manual/api/reference_commentary#parameter-behavior):<br>- *verplicht*|
|permissions|boolean|Stel in op "true" om machtigingen te verspreiden.<br><br>[Gedrag van parameter](/manual/api/reference_commentary#parameter-behavior):<br>- *verplicht* indien `tag_filters` niet is ingesteld|
|tag_filters|boolean|Stel in op "true" om tagfilters te verspreiden.<br><br>[Gedrag van parameter](/manual/api/reference_commentary#parameter-behavior):<br>- *verplicht* indien `permissions` niet is ingesteld|

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



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

`(object)` Geeft een object terug met de ID's van de verspreide hostgroepen onder de eigenschap `groupids`.

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



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

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



[comment]: # ({bd95271f-8ec85132})
#### Machtigingen van hostgroep en tagfilters verspreiden naar de onderliggende groepen.

Verspreid machtigingen van hostgroep en tagfilters naar de onderliggende groepen.

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

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

Reactie:

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

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



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

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

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



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

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

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