[comment]: # translation:outdated

[comment]: # ({0a1af107-0a1af107})
# drule.update

[comment]: # ({/0a1af107-0a1af107})

[comment]: # ({81317531-ac17a9e2})
### Description

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

Cette méthode permet de mettre à jour les règles de découverte existantes.

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

[comment]: # ({/81317531-ac17a9e2})

[comment]: # ({cdfb53ac-0dd5b0c8})
### Paramètres

`(object/array)` Propriétés de la règle de découverte à mettre à jour.

La propriété `druleid` doit être définie pour chaque règle de découverte, toutes les autres propriétés sont facultatives. Seules les propriétés transmises seront mises à jour, toutes les autres resteront inchangées.

En plus des [propriétés de l'objet règle de découverte standard](object#discovery_rule), la méthode accepte les paramètres suivants.

|Paramètre|[Type](/manual/api/reference_commentary#data_types)|Description|
|---------|---------------------------------------------------|-----------|
|dchecks|array|[Tests](/manual/api/reference/dcheck/object) de découverte en remplacement des tests existants.|

[comment]: # ({/cdfb53ac-0dd5b0c8})

[comment]: # ({495f933e-495f933e})
### Valeurs retournées

`(object)` Retourne un objet contenant les identifiants des règles de découverte mises à jour sous la propriété `druleids`.

[comment]: # ({/495f933e-495f933e})

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

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

[comment]: # ({42634012-11119b8e})
#### Modification de la plage IP d'une règle de découverte

Définir la plage d'adresses IP d'une règle de découverte à "192.168.2.1-255".

Requête :

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "drule.update",
    "params": {
        "druleid": "6",
        "iprange": "192.168.2.1-255"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Réponse :

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

[comment]: # ({/42634012-11119b8e})

[comment]: # ({54664cce-54664cce})
### Voir également

-   [Test de découverte](/manual/api/reference/dcheck/object#discovery_check)

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

[comment]: # ({d9252108-d9252108})
### Source

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

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