[comment]: # translation:outdated

[comment]: # ({8102730f-8102730f})
# drule.create

[comment]: # ({/8102730f-8102730f})

[comment]: # ({e51fc566-9e7d03a2})
### Description

`object drule.create(object/array discoveryRules)`

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

::: noteclassic
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](/manual/web_interface/frontend_sections/users/user_roles)
pour plus d’informations.
:::

[comment]: # ({/e51fc566-9e7d03a2})

[comment]: # ({b0b514c2-7afdb3b3})
### Paramètres

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

En plus des [propriétés standard des règles de
découverte](object#discovery-rule), la méthode accepte les paramètres
suivants.

|Paramètre|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|dchecks|array|[Contrôles de découverte](/manual/api/reference/dcheck/object) à créer pour la règle de découverte.<br><br>[Comportement des paramètres](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatoire*|

[comment]: # ({/b0b514c2-7afdb3b3})

[comment]: # ({8b5259e3-2eb6d0d5})
### 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.

[comment]: # ({/8b5259e3-2eb6d0d5})

[comment]: # ({b41637d2-b41637d2})
### Exemples

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({fd18072b-b03b87c1})
#### 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](/manual/api#performing-requests):

```json
{
    "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 :

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

[comment]: # ({/fd18072b-b03b87c1})

[comment]: # ({396b4d4f-54664cce})
### Voir aussi

-   [Vérification de découverte](/manual/api/reference/dcheck/object#discovery-check)

[comment]: # ({/396b4d4f-54664cce})

[comment]: # ({1333854c-1333854c})
### Source

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

[comment]: # ({/1333854c-1333854c})