[comment]: # ({ddce888e-ddce888e}) # discoveryrule.get [comment]: # ({/ddce888e-ddce888e}) [comment]: # ({e9f79f9b-b87cd1ee}) ### Apraksts `integer/array discoveryrule.get(object parameters)` Šī metode ļauj izgūt LLD noteikumus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Tiesības izsaukt šo metodi var atsaukt lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: [comment]: # ({/e9f79f9b-b87cd1ee}) [comment]: # ({ae0c9661-57007d3d}) ### Parametri `(object)` Parametri, kas nosaka vēlamo izvadi. Metode atbalsta šādus parametrus. |Parametrs|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |itemids|ID/array|Atgriezt tikai LLD kārtulas ar norādītajiem ID.| |groupids|ID/array|Atgriezt tikai LLD kārtulas, kas pieder hostiem no norādītajām grupām.| |hostids|ID/array|Atgriezt tikai LLD kārtulas, kas pieder norādītajiem hostiem.| |inherited|boolean|Ja iestatīts uz `true`, atgriezt tikai no veidnes mantotās LLD kārtulas.| |interfaceids|ID/array|Atgriezt tikai LLD kārtulas, kas izmanto norādītās hosta saskarnes.| |monitored|boolean|Ja iestatīts uz `true`, atgriezt tikai iespējotās LLD kārtulas, kas pieder uzraudzītiem hostiem.| |templated|boolean|Ja iestatīts uz `true`, atgriezt tikai LLD kārtulas, kas pieder veidnēm.| |templateids|ID/array|Atgriezt tikai LLD kārtulas, kas pieder norādītajām veidnēm.| |selectDiscoveryData|query|Atgriezt `discoveryData` īpašību ar LLD kārtulas atklāšanas objekta datiem. LLD kārtulas atklāšanas objekts sasaista atklātu LLD kārtulu ar LLD kārtulas prototipu, no kura tā tika atklāta.| |selectDiscoveryRulePrototypes|query|Atgriezt [`discoveryRulePrototypes`](/manual/api/reference/discoveryruleprototype/object) īpašību ar LLD kārtulu prototipiem, kas pieder LLD kārtulai.

Atbalsta `count`.| |selectFilter|query|Atgriezt [`filter`](/manual/api/reference/discoveryrule/object#lld-rule-filter) īpašību ar LLD kārtulas izmantotā filtra datiem.| |selectGraphs|query|Atgriež [`graphs`](/manual/api/reference/graph/object) īpašību ar grafiku prototipiem, kas pieder LLD kārtulai.

Atbalsta `count`.| |selectHostPrototypes|query|Atgriezt [`hostPrototypes`](/manual/api/reference/hostprototype/object) īpašību ar hostu prototipiem, kas pieder LLD kārtulai.

Atbalsta `count`.| |selectHosts|query|Atgriezt [`hosts`](/manual/api/reference/host/object) īpašību ar hostu masīvu, kuriem pieder LLD kārtula.| |selectItems|query|Atgriezt [`items`](/manual/api/reference/item/object) īpašību ar vienumu prototipiem, kas pieder LLD kārtulai.

Atbalsta `count`.| |selectTriggers|query|Atgriezt [`triggers`](/manual/api/reference/trigger/object) īpašību ar trigeru prototipiem, kas pieder LLD kārtulai.

Atbalsta `count`.| |selectLLDMacroPaths|query|Atgriezt [`lld_macro_paths`](/manual/api/reference/discoveryrule/object#lld-macro-path) īpašību ar LLD makrosu sarakstu un ceļiem uz vērtībām, kas piešķirtas katram atbilstošajam makrosam.| |selectPreprocessing|query|Atgriezt [`preprocessing`](/manual/api/reference/discoveryrule/object#lld-rule-preprocessing) īpašību ar LLD kārtulas priekšapstrādes opcijām.| |selectOverrides|query|Atgriezt [`lld_rule_overrides`](/manual/api/reference/discoveryrule/object#lld-rule-overrides) īpašību ar ignorēšanas filtru, nosacījumu un darbību sarakstu, kas tiek izpildītas ar prototipu objektiem.| |filter|object|Atgriezt tikai tos rezultātus, kas precīzi atbilst norādītajam filtram.

Pieņem objektu, kurā atslēgas ir īpašību nosaukumi, bet vērtības ir vai nu viena vērtība, vai vērtību masīvs salīdzināšanai.

Neatbalsta `text` [datu tipa](/manual/api/reference_commentary#data-types) īpašības.

Atbalsta papildu īpašības:
`host` - hosta tehniskais nosaukums, kuram pieder LLD kārtula.| |limitSelects|integer|Ierobežo apakšatlases vaicājumos atgriezto ierakstu skaitu.

Attiecas uz šādiem apakšatlases vaicājumiem: `selectItems`, `selectGraphs`, `selectTriggers`.| |sortfield|string/array|Kārtot rezultātu pēc norādītajām īpašībām.

Iespējamās vērtības: `itemid`, `name`, `key_`, `delay`, `type`, `status`.| |countOutput|boolean|Šie parametri ir aprakstīti [atsauces komentārā](/manual/api/reference_commentary#common-get-method-parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^| [comment]: # ({/ae0c9661-57007d3d}) [comment]: # ({7223bab1-7223bab1}) ### Atgrieztās vērtības `(integer/array)` Atgriež vienu no šiem: - objektu masīvu; - izgūto objektu skaitu, ja ir izmantots parametrs `countOutput`. [comment]: # ({/7223bab1-7223bab1}) [comment]: # ({b41637d2-b41637d2}) ### Piemēri [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({ab9d9991-5f8b5429}) #### Atklāšanas noteikumu izgūšana no hosta Izgūst visus atklāšanas noteikumus konkrētam hosta ID. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.get", "params": { "output": "extend", "hostids": "10202" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "27425", "type": "0", "snmp_oid": "", "hostid": "10202", "name": "Network interface discovery", "key_": "net.if.discovery", "delay": "1h", "status": "0", "trapper_hosts": "", "templateid": "22444", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "1", "interfaceid": "119", "description": "Tīkla interfeisu atklāšana, kā noteikts globālajā regulārajā izteiksmē \"Network interfaces for discovery\".", "lifetime": "30d", "jmx_endpoint": "", "master_itemid": "0", "timeout": "", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "lifetime_type": "0", "enabled_lifetime_type": "2", "enabled_lifetime": "0", "state": "0", "error": "", "parameters": [] }, { "itemid": "27426", "type": "0", "snmp_oid": "", "hostid": "10202", "name": "Mounted filesystem discovery", "key_": "vfs.fs.discovery", "delay": "1h", "status": "0", "trapper_hosts": "", "templateid": "22450", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "1", "interfaceid": "119", "description": "Failu sistēmu atklāšana dažādiem tipiem, kā noteikts globālajā regulārajā izteiksmē \"File systems for discovery\".", "lifetime": "30d", "jmx_endpoint": "", "master_itemid": "0", "timeout": "", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "lifetime_type": "0", "enabled_lifetime_type": "2", "enabled_lifetime": "0", "state": "0", "error": "", "parameters": [] } ], "id": 1 } ``` [comment]: # ({/ab9d9991-5f8b5429}) [comment]: # ({22ef0184-4d0af030}) #### Filtra nosacījumu izgūšana Iegūstiet LLD noteikuma "24681" nosaukumu un tā filtra nosacījumus. Filtrs izmanto "and" izvērtēšanas tipu, tāpēc `formula` īpašība ir tukša un `eval_formula` tiek ģenerēta automātiski. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.get", "params": { "output": ["name"], "selectFilter": "extend", "itemids": ["24681"] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "24681", "name": "Filtered LLD rule", "filter": { "evaltype": "1", "formula": "", "conditions": [ { "macro": "{#MACRO1}", "value": "@regex1", "operator": "8", "formulaid": "A" }, { "macro": "{#MACRO2}", "value": "@regex2", "operator": "9", "formulaid": "B" }, { "macro": "{#MACRO3}", "value": "", "operator": "12", "formulaid": "C" }, { "macro": "{#MACRO4}", "value": "", "operator": "13", "formulaid": "D" } ], "eval_formula": "A and B and C and D" } } ], "id": 1 } ``` [comment]: # ({/22ef0184-4d0af030}) [comment]: # ({6830cd5d-e3de6fe8}) #### LLD noteikuma izgūšana pēc URL Izgūst LLD noteikumu hostam pēc noteikuma URL lauka vērtības. Tiek atbalstīta tikai precīza LLD noteikumam definētās URL virknes atbilstība. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.get", "params": { "hostids": "10257", "filter": { "type": 19, "url": "http://127.0.0.1/discoverer.php" } }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "28336", "type": "19", "snmp_oid": "", "hostid": "10257", "name": "API HTTP agent", "key_": "api_discovery_rule", "delay": "5s", "status": "0", "trapper_hosts": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "1", "interfaceid": "5", "description": "", "lifetime": "30d", "jmx_endpoint": "", "master_itemid": "0", "timeout": "", "url": "http://127.0.0.1/discoverer.php", "query_fields": [ { "name": "mode", "value": "json" }, { "name": "elements", "value": "2" } ], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [ { "name" : "X-Type", "value": "api" }, { "name": "Authorization", "value": "Bearer mF_A.B5f-2.1JcM" } ], "retrieve_mode": "0", "request_method": "1", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "lifetime_type": "0", "enabled_lifetime_type": "2", "enabled_lifetime": "0", "state": "0", "error": "", "parameters": [] } ], "id": 1 } ``` [comment]: # ({/6830cd5d-e3de6fe8}) [comment]: # ({cbbe028e-c0ae2d21}) #### Iegūt LLD kārtulu ar ignorēšanas iestatījumiem Iegūt vienu LLD kārtulu, kurai ir dažādi ignorēšanas iestatījumi. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.get", "params": { "output": ["name"], "itemids": "30980", "selectOverrides": ["name", "step", "stop", "filter", "operations"] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": [ { "name": "Discover database host", "overrides": [ { "name": "Discover MySQL host", "step": "1", "stop": "1", "filter": { "evaltype": "2", "formula": "", "conditions": [ { "macro": "{#UNIT.NAME}", "operator": "8", "value": "^mysqld\\.service$", "formulaid": "A" }, { "macro": "{#UNIT.NAME}", "operator": "8", "value": "^mariadb\\.service$", "formulaid": "B" } ], "eval_formula": "A or B" }, "operations": [ { "operationobject": "3", "operator": "2", "value": "Database host", "opstatus": { "status": "0" }, "optag": [ { "tag": "database", "value": "mysql" } ], "optemplate": [ { "templateid": "10170" } ] } ] }, { "name": "Discover PostgreSQL host", "step": "2", "stop": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [ { "macro": "{#UNIT.NAME}", "operator": "8", "value": "^postgresql\\.service$", "formulaid": "A" } ], "eval_formula": "A" }, "operations": [ { "operationobject": "3", "operator": "2", "value": "Database host", "opstatus": { "status": "0" }, "optag": [ { "tag": "database", "value": "postgresql" } ], "optemplate": [ { "templateid": "10263" } ] } ] } ] } ], "id": 1 } ``` [comment]: # ({/cbbe028e-c0ae2d21}) [comment]: # ({590f198c-f25d02bb}) ### Skatiet arī - [Grafika prototips](/manual/api/reference/graphprototype/object#graph-prototype) - [Hosts](/manual/api/reference/host/object#host) - [Vienuma prototips](/manual/api/reference/itemprototype/object#item-prototype) - [LLD kārtulas filtrs](object#lld-rule-filter) - [Trigera prototips](/manual/api/reference/triggerprototype/object#trigger-prototype) [comment]: # ({/590f198c-f25d02bb}) [comment]: # ({e14efed8-e14efed8}) ### Avots CDiscoveryRule::get() in *ui/include/classes/api/services/CDiscoveryRule.php*. [comment]: # ({/e14efed8-e14efed8})