hostinterface.massremove

Description

object hostinterface.massremove(object parameters)

Cette méthode permet de supprimer des interfaces d’hôte des hôtes donnés.

Cette méthode est disponible uniquement pour les types d’utilisateurs 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

(object) Paramètres contenant les ID des hôtes à mettre à jour et les interfaces à supprimer.

Paramètre Type Description
interfaces object/array Interfaces d’hôte à supprimer des hôtes donnés.

L’objet d’interface d’hôte doit avoir uniquement les propriétés ip, dns et port définies.

Comportement du paramètre :
- obligatoire
hostids ID/array ID des hôtes à mettre à jour.

Comportement du paramètre :
- obligatoire

Valeurs retournées

(object) Retourne un objet contenant les identifiants des interfaces hôtes supprimées sous la propriété interfaceids.

Exemples

Suppression d’interfaces

Supprimez l’interface SNMP "127.0.0.1" de deux hôtes.

Requête:

{
    "jsonrpc": "2.0",
    "method": "hostinterface.massremove",
    "params": {
        "hostids": [
            "30050",
            "30052"
        ],
        "interfaces": {
            "dns": "",
            "ip": "127.0.0.1",
            "port": "161"
        }
    },
    "id": 1
}

Réponse :

{
    "jsonrpc": "2.0",
    "result": {
        "interfaceids": [
            "30069",
            "30070"
        ]
    },
    "id": 1
}

Voir également

Source

CHostInterface::massRemove() dans ui/include/classes/api/services/CHostInterface.php.