Zabbix Documentation 4.2

3.04.05.0 (current)| In development:5.2 (devel)| Unsupported:1.82.02.22.43.23.44.24.4Guidelines

User Tools

Site Tools


manual:api:reference:discoveryrule:update

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
manual:api:reference:discoveryrule:update [2014/09/30 12:54]
127.0.0.1 external edit
manual:api:reference:discoveryrule:update [2020/05/20 12:36] (current)
iivs added missing macro paths
Line 17: Line 17:
 ^ Parameter ^ Type ^ Description ^ ^ Parameter ^ Type ^ Description ^
 | filter | object | LLD rule filter object to replace the current filter. | | filter | object | LLD rule filter object to replace the current filter. |
 +| preprocessing | array | LLD rule preprocessing options to replace the current preprocessing options. |
 +| lld_macro_paths | array | LLD rule lld_macro_path options. ​ |
  
 ==== Return values ==== ==== Return values ====
Line 23: Line 25:
  
 ==== Examples ==== ==== Examples ====
- 
 === Adding a filter to an LLD rule === === Adding a filter to an LLD rule ===
- 
 Add a filter so that the contents of the //​{#​FSTYPE}//​ macro would match the //@File systems for discovery// regexp. Add a filter so that the contents of the //​{#​FSTYPE}//​ macro would match the //@File systems for discovery// regexp.
  
 Request: Request:
-<​code ​js>+<​code ​java>
 { {
     "​jsonrpc":​ "​2.0",​     "​jsonrpc":​ "​2.0",​
     "​method":​ "​discoveryrule.update",​     "​method":​ "​discoveryrule.update",​
     "​params":​ {     "​params":​ {
-        "​itemid":​ "24682",+        "​itemid":​ "22450",
         "​filter":​ {         "​filter":​ {
             "​evaltype":​ 1,             "​evaltype":​ 1,
Line 51: Line 51:
  
 Response: Response:
-<​code ​js>+<​code ​java>
 { {
     "​jsonrpc":​ "​2.0",​     "​jsonrpc":​ "​2.0",​
Line 57: Line 57:
         "​itemids":​ [         "​itemids":​ [
             "​22450"​             "​22450"​
 +        ]
 +    },
 +    "​id":​ 1
 +}
 +</​code>​
 +
 +=== Adding LLD macro paths ===
 +
 +Request:
 +<code java>
 +{
 +    "​jsonrpc":​ "​2.0",​
 +    "​method":​ "​discoveryrule.update",​
 +    "​params":​ {
 +        "​itemid":​ "​22450",​
 +        "​lld_macro_paths":​ [
 +            {
 +                "​lld_macro":​ "​{#​MACRO1}",​
 +                "​path":​ "​$.json.path"​
 +            }
 +        ]
 +    },
 +    "​auth":​ "​038e1d7b1735c6a5436ee9eae095879e",​
 +    "​id":​ 1
 +}
 +</​code>​
 +
 +Response:
 +<code java>
 +{
 +    "​jsonrpc":​ "​2.0",​
 +    "​result":​ {
 +        "​itemids":​ [
 +            "​22450"​
 +        ]
 +    },
 +    "​id":​ 1
 +}
 +</​code>​
 +
 +=== Disable trapping ===
 +
 +Disable LLD trapping for discovery rule.
 +
 +Request:
 +
 +<code java>
 +{
 +    "​jsonrpc":​ "​2.0",​
 +    "​method":​ "​discoveryrule.update",​
 +    "​params":​ {
 +        "​itemid":​ "​28336",​
 +        "​allow_traps":​ "​0"​
 +    },
 +    "​id":​ 36,
 +    "​auth":​ "​d678e0b85688ce578ff061bd29a20d3b"​
 +}
 +</​code>​
 +
 +Response:
 +
 +<code java>
 +{
 +    "​jsonrpc":​ "​2.0",​
 +    "​result":​ {
 +        "​itemids":​ [
 +            "​28336"​
 +        ]
 +    },
 +    "​id":​ 36
 +}
 +</​code>​
 +
 +=== Updating LLD rule preprocessing options ===
 +
 +Update an LLD rule with preprocessing rule "​JSONPath"​.
 +
 +Request:
 +<code java>
 +{
 +    "​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
 +}
 +</​code>​
 +
 +Response:
 +<code java>
 +{
 +    "​jsonrpc":​ "​2.0",​
 +    "​result":​ {
 +        "​itemids":​ [
 +            "​44211"​
         ]         ]
     },     },
Line 65: Line 170:
 ==== Source ==== ==== Source ====
  
-CDiscoveryRule::​update() in //​frontends/​php/​api/​classes/​CDiscoveryRule.php//​.+CDiscoveryRule::​update() in //​frontends/​php/​include/classes/​api/​services/​CDiscoveryRule.php//​.