This is a translation of the original English documentation page. Help us make it better.

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 appartiennent à ce groupe uniquement ;
  • 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 utilisateurs de type Admin et Super admin. Les autorisations d'appel de la méthode peuvent être révoquées dans les réglages du rôle d'utilisateur. Voir les Rôles utilisateur pour plus d'informations.

Paramètres

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

Valeurs retournées

(object) Renvoie un objet contenant les identifiants des groupes d'hôtes supprimés sous la propriété groupids.

Exemples

Suppression de plusieurs groupes d'hôtes

Supprimer deux groupes d'hôtes.

Requête:

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

Réponse :

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

Source

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