drule.create

Description

object drule.create(object/array discoveryRules)

Cette méthode permet de créer de nouvelles règles de découverte.

Cette méthode est disponible uniquement pour les types d’utilisateurs Admin et Super admin. Les autorisations permettant d’appeler la méthode peuvent être révoquées dans les paramètres du rôle utilisateur. Voir User roles pour plus d’informations.

Paramètres

(object/array) Règles de découverte à créer.

En plus des propriétés standard des règles de découverte, la méthode accepte les paramètres suivants.

Paramètre Type Description
dchecks array Contrôles de découverte à créer pour la règle de découverte.

Comportement du paramètre :
- obligatoire

Valeurs retournées

(object) Retourne un objet contenant les identifiants des règles de découverte créées sous la propriété druleids. L'ordre des ID retournés correspond à l'ordre des règles de découverte passées.

Exemples

Créer une règle de découverte

Créez une règle de découverte pour trouver les machines exécutant l'agent Zabbix sur le réseau local. La règle doit utiliser une seule vérification de l'agent Zabbix sur le port 10050.

Requête:

{
    "jsonrpc": "2.0",
    "method": "drule.create",
    "params": {
        "name": "Zabbix agent discovery",
        "iprange": "192.168.1.1-255",
        "concurrency_max": "10",
        "dchecks": [
            {
                "type": "9",
                "key_": "system.uname",
                "ports": "10050",
                "uniq": "0"
            }
        ]
    },
    "id": 1
}

Réponse :

{
    "jsonrpc": "2.0",
    "result": {
        "druleids": [
            "6"
        ]
    },
    "id": 1
}

Voir également

Source

CDRule::create() dans ui/include/classes/api/services/CDRule.php.