Documentation
Table of Contents
discoveryrule.update
Description
object discoveryrule.update(object/array lldRules)
Cette méthode permet de mettre à jour les règles de découverte bas niveau existantes.
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) Propriété des règles de découverte bas niveau à mettre à jour.
La propriété itemid doit être définie pour chaque règle, 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é de l'objet règle de découverte bas niveau standard, la méthode accepte les paramètres suivants.
| Paramètre | Type | Description |
|---|---|---|
| filter | object | Objet de filtre de règle LLD pour remplacer le filtre actuel. |
| preprocessing | array | Options de prétraitement des règles LLD pour remplacer les options de prétraitement actuelles. |
| lld_macro_paths | array | Options lld_macro_path de la règle LLD. |
| overrides | array | Options de remplacement. |
Valeurs retournées
(object) Retourne un objet contenant les identifiants des règles mises à jour sous la propriété itemids.
Exemples
Ajout d'un filtre à une règle de découverte bas niveau
Ajoutez un filtre afin que le contenu de la macro {#FSTYPE} corresponde à l'expression régulière @File systems for discovery.
Requête :
{
"jsonrpc": "2.0",
"method": "discoveryrule.update",
"params": {
"itemid": "22450",
"filter": {
"evaltype": 1,
"conditions": [
{
"macro": "{#FSTYPE}",
"value": "@File systems for discovery"
}
]
}
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Réponse :
Ajouter des chemins de macro LLD
Requête :
{
"jsonrpc": "2.0",
"method": "discoveryrule.update",
"params": {
"itemid": "22450",
"lld_macro_paths": [
{
"lld_macro": "{#MACRO1}",
"path": "$.json.path"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Réponse :
Désactivation des traps
Désactiver les traps d'une règle
Requête :
{
"jsonrpc": "2.0",
"method": "discoveryrule.update",
"params": {
"itemid": "28336",
"allow_traps": "0"
},
"id": 36,
"auth": "d678e0b85688ce578ff061bd29a20d3b"
}Réponse :
Mise à jour des options de prétraitement des règles LLD
Mettre à jour une règle LLD avec la règle de prétraitement “JSONPath”.
Requête :
{
"jsonrpc": "2.0",
"method": "discoveryrule.update",
"params": {
"itemid": "44211",
"preprocessing": [
{
"type": "12",
"params": "$.path.to.json",
"error_handler": "2",
"error_handler_params": "5"
}
]
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Réponse :
Mise à jour du script de règle LLD
Mettre à jour un script de règle LLD avec un script différent et supprimer les paramètres inutiles qui ont été utilisés par le script précédent.
Requête :
{
"jsonrpc": "2.0",
"method": "discoveryrule.update",
"params": {
"itemid": "23865",
"parameters": [],
"script": "Zabbix.Log(3, 'Log test');\nreturn 1;"
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Réponse :
Source
CDiscoveryRule::update() dans ui/include/classes/api/services/CDiscoveryRule.php.