hostgroup.delete

Description

object hostgroup.delete(array hostGroupIds)

Cette méthode permet de supprimer des groupes d'hôtes.

Un groupe d'hôtes ne peut pas être supprimé si :

  • il contient des hôtes qui n'appartiennent qu'à ce groupe ;
  • il est marqué comme interne ;
  • il est utilisé par un prototype d'hôte ;
  • il est utilisé dans un script global ;
  • il est utilisé dans une condition de corrélation.

Cette méthode est disponible uniquement pour les types d'utilisateur Admin et Super admin. Les autorisations d'appel de la méthode peuvent être révoquées dans les paramètres des rôles utilisateur. Voir Rôles utilisateur pour plus d'informations.

Paramètres

(array) ID des groupes d’hôtes à supprimer.

Valeurs de retour

(object) Renvoie un objet contenant les ID des groupes d’hôtes supprimés dans la propriété groupids.

Exemples

Suppression de plusieurs groupes d’hôtes

Supprimez deux groupes d’hôtes.

Requête :

{
    "jsonrpc": "2.0",
    "method": "hostgroup.delete",
    "params": [
        "107824",
        "107825"
    ],
    "id": 1
}

Réponse :

{
    "jsonrpc": "2.0",
    "result": {
        "groupids": [
            "107824",
            "107825"
        ]
    },
    "id": 1
}

Source

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