[comment]: # translation:outdated

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

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



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

`object hostgroup.propagate(object parameters)`

Cette méthode permet d’appliquer les autorisations et les filtres de tags à tous les sous-groupes d’un groupe d’hôtes.

::: noteclassic
Cette méthode est disponible uniquement pour les types d’utilisateurs *Super admin*.
Les autorisations d’appel de la méthode peuvent être révoquées dans les paramètres du rôle utilisateur.
Voir [Rôles
utilisateur](/manual/web_interface/frontend_sections/users/user_roles)
pour plus d’informations.
:::

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



[comment]: # ({946f3f47-6102edd8})
### Paramètres

`(object)` Paramètres définissant la sortie souhaitée.

La méthode prend en charge les paramètres suivants.

|Paramètre|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|groups|object/array|[Groupes d'hôtes](/manual/api/reference/hostgroup/object) à propager.<br><br>Les groupes d'hôtes doivent avoir la propriété `groupid` définie.<br><br>[Comportement des paramètres](/manual/api/reference_commentary#parameter-behavior) :<br>- *obligatoire*|
|permissions|boolean|Définissez sur "true" pour propager les autorisations.<br><br>[Comportement des paramètres](/manual/api/reference_commentary#parameter-behavior) :<br>- *obligatoire* si `tag_filters` n'est pas défini|
|tag_filters|boolean|Définissez sur "true" pour propager les filtres de tags.<br><br>[Comportement des paramètres](/manual/api/reference_commentary#parameter-behavior) :<br>- *obligatoire* si `permissions` n'est pas défini|

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



[comment]: # ({f0b30152-42ead635})
### Valeurs de retour

`(object)` Retourne un objet contenant des ID des hotes propagés
groupe sous la propriété `groupids`.

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



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

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



[comment]: # ({bd95271f-8ec85132})
#### Propagation des permissions de groupe d’hôtes et des filtres de tags à ses sous-groupes.

Propager les permissions de groupe d’hôtes et les filtres de tags à ses sous-groupes.

[Requête](/manual/api#performing-requests) :

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

Réponse :

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

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



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

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

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



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

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

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