The method allows to retrieve LLD rules according to the given parameters. 此方法允许根据给定的参数获取LLD规则。

    Parameters 参数

    (object) Parameters defining the desired output. (object) 参数定义期望输出。

    The method supports the following parameters. 此方法支持如下参数。

    (integer/array) Returns either:

    • an array of objects;

    • the count of retrieved objects, if the countOutput parameter has been used.

    Examples 示例

    Retrieving discovery rules from a host 从一个主机获取多有的发现规则

    Request:

    Response:

    1. {
    2.     "jsonrpc": "2.0",
    3.     "result": [
    4.         {
    5.             "itemid": "27425",
    6.             "type": "0",
    7.             "snmp_community": "",
    8.             "snmp_oid": "",
    9.             "hostid": "10202",
    10.             "name": "Network interface discovery",
    11.             "key_": "net.if.discovery",
    12.             "delay": "1h",
    13.             "state": "0",
    14.             "status": "0",
    15.             "trapper_hosts": "",
    16.             "snmpv3_securityname": "",
    17.             "snmpv3_securitylevel": "0",
    18.             "snmpv3_authpassphrase": "",
    19.             "snmpv3_privpassphrase": "",
    20.             "error": "",
    21.             "templateid": "22444",
    22.             "params": "",
    23.             "ipmi_sensor": "",
    24.             "authtype": "0",
    25.             "username": "",
    26.             "password": "",
    27.             "publickey": "",
    28.             "privatekey": "",
    29.             "interfaceid": "119",
    30.             "port": "",
    31.             "description": "Discovery of network interfaces as defined in global regular expression \"Network interfaces for discovery\".",
    32.             "lifetime": "30d",
    33.             "snmpv3_authprotocol": "0",
    34.             "snmpv3_privprotocol": "0",
    35.             "snmpv3_contextname": "",
    36.             "jmx_endpoint": "",
    37.             "master_itemid": "0",
    38.             "timeout": "3s",
    39.             "url": "",
    40.             "query_fields": [],
    41.             "posts": "",
    42.             "status_codes": "200",
    43.             "follow_redirects": "1",
    44.             "post_type": "0",
    45.             "http_proxy": "",
    46.             "headers": [],
    47.             "retrieve_mode": "0",
    48.             "request_method": "1",
    49.             "ssl_cert_file": "",
    51.             "ssl_key_password": "",
    52.             "verify_peer": "0",
    53.             "verify_host": "0",
    54.             "allow_traps": "0"
    55.         },
    56.         {
    57.             "itemid": "27426",
    58.             "type": "0",
    59.             "snmp_community": "",
    60.             "snmp_oid": "",
    61.             "hostid": "10202",
    62.             "name": "Mounted filesystem discovery",
    63.             "key_": "vfs.fs.discovery",
    64.             "delay": "1h",
    65.             "state": "0",
    66.             "status": "0",
    67.             "trapper_hosts": "",
    68.             "snmpv3_securityname": "",
    69.             "snmpv3_authpassphrase": "",
    70.             "snmpv3_privpassphrase": "",
    71.             "error": "",
    72.             "templateid": "22450",
    73.             "params": "",
    74.             "ipmi_sensor": "",
    75.             "authtype": "0",
    76.             "username": "",
    77.             "password": "",
    78.             "publickey": "",
    79.             "privatekey": "",
    80.             "interfaceid": "119",
    81.             "port": "",
    82.             "description": "Discovery of file systems of different types as defined in global regular expression \"File systems for discovery\".",
    83.             "lifetime": "30d",
    84.             "snmpv3_authprotocol": "0",
    85.             "snmpv3_privprotocol": "0",
    86.             "snmpv3_contextname": "",
    87.             "jmx_endpoint": "",
    88.             "master_itemid": "0",
    89.             "timeout": "3s",
    90.             "url": "",
    91.             "query_fields": [],
    92.             "posts": "",
    93.             "status_codes": "200",
    94.             "follow_redirects": "1",
    95.             "post_type": "0",
    96.             "http_proxy": "",
    97.             "headers": [],
    98.             "retrieve_mode": "0",
    99.             "request_method": "1",
    100.             "ssl_cert_file": "",
    101.             "ssl_key_file": "",
    102.             "ssl_key_password": "",
    103.             "verify_peer": "0",
    104.             "verify_host": "0",
    105.             "allow_traps": "0"
    106.         }
    107.     ],
    108.     "id": 1
    109. }

    Retrieving filter conditions

    Retrieve the name of the LLD rule “24681” and its filter conditions. The filter uses the “and” evaluation type, so the formula property is empty and eval_formula is generated automatically.

    Request:

    Response:

    1. {
    2.     "jsonrpc": "2.0",
    3.     "result": [
    4.         {
    5.             "itemid": "24681",
    6.             "name": "Filtered LLD rule",
    7.             "filter": {
    8.                 "evaltype": "1",
    9.                 "formula": "",
    10.                 "conditions": [
    11.                     {
    12.                         "macro": "{#MACRO1}",
    13.                         "value": "@regex1",
    14.                         "operator": "8",
    15.                         "formulaid": "A"
    16.                     },
    17.                     {
    18.                         "macro": "{#MACRO2}",
    19.                         "value": "@regex2",
    20.                         "operator": "8",
    21.                         "formulaid": "B"
    22.                     },
    23.                     {
    24.                         "macro": "{#MACRO3}",
    26.                         "operator": "8",
    27.                         "formulaid": "C"
    28.                     }
    29.                 ],
    30.                 "eval_formula": "A and B and C"
    31.             }
    32.         }
    33.     ],
    34.     "id": 1
    35. }

    Retrieve LLD rule by URL 根据URL获取LLD规则

    Retrieve LLD rule for host by rule URL field value. Only exact match of URL string defined for LLD rule is supported. 根据主机的规则URL字段值获取LLD规则。仅返回精确匹配定义的URL字符串的规则。

    Response:

    1. {
    2.     "jsonrpc": "2.0",
    3.     "result": [
    4.             "itemid": "28336",
    5.             "type": "19",
    6.             "snmp_community": "",
    7.             "snmp_oid": "",
    8.             "hostid": "10257",
    9.             "name": "API HTTP agent",
    10.             "key_": "api_discovery_rule",
    11.             "delay": "5s",
    12.             "history": "90d",
    13.             "trends": "0",
    14.             "status": "0",
    15.             "value_type": "4",
    16.             "trapper_hosts": "",
    17.             "units": "",
    18.             "snmpv3_securityname": "",
    19.             "snmpv3_securitylevel": "0",
    20.             "snmpv3_authpassphrase": "",
    21.             "snmpv3_privpassphrase": "",
    22.             "error": "",
    23.             "lastlogsize": "0",
    24.             "logtimefmt": "",
    25.             "templateid": "0",
    26.             "valuemapid": "0",
    27.             "params": "",
    28.             "ipmi_sensor": "",
    29.             "authtype": "0",
    30.             "username": "",
    31.             "password": "",
    32.             "publickey": "",
    33.             "privatekey": "",
    34.             "mtime": "0",
    35.             "flags": "1",
    36.             "interfaceid": "5",
    37.             "port": "",
    38.             "description": "",
    39.             "inventory_link": "0",
    40.             "lifetime": "30d",
    41.             "snmpv3_authprotocol": "0",
    42.             "snmpv3_privprotocol": "0",
    43.             "state": "0",
    44.             "snmpv3_contextname": "",
    45.             "jmx_endpoint": "",
    46.             "master_itemid": "0",
    47.             "timeout": "3s",
    48.             "url": "http://127.0.0.1/discoverer.php",
    49.             "query_fields": [
    50.                 {
    51.                     "mode": "json"
    52.                 },
    53.                 {
    54.                     "elements": "2"
    55.                 }
    56.             ],
    57.             "posts": "",
    58.             "status_codes": "200",
    59.             "follow_redirects": "1",
    60.             "post_type": "0",
    61.             "http_proxy": "",
    62.             "headers": {
    63.                 "X-Type": "api",
    64.                 "Authorization": "Bearer mF_A.B5f-2.1JcM"
    65.             },
    66.             "retrieve_mode": "0",
    67.             "request_method": "1",
    68.             "ssl_cert_file": "",
    69.             "ssl_key_file": "",
    70.             "ssl_key_password": "",
    71.             "verify_peer": "0",
    72.             "verify_host": "0",
    73.             "allow_traps": "0"
    74.         }
    75.     ],
    77. }

    Source