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 uniquement disponible pour les utilisateurs type Admin et Super admin. Les autorisations d'appel de la méthode peuvent être révoquées dans les paramètres du rôle utilisateur. Voir les rôles utilisateur pour plus d'informations.

Paramètres

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

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

Paramètre	Type	Description
dchecks (obligatoire)	array	Tests de découverte à créer pour la règle de découverte.

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éation d'une règle de découverte

Créez une règle de découverte permettant de rechercher les machines exécutant l'agent Zabbix sur le réseau local. La règle doit utiliser un seul test de découverte d'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",
               "dchecks": [
                   {
                       "type": "9",
                       "key_": "system.uname",
                       "ports": "10050",
                       "uniq": "0"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Réponse :

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

Voir également

Test de découverte

Source

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

Documentation