描述

    The method allows to retrieve discovery rules according to the given parameters. 该方法用于根据给定的参数获取发现规则。

    Parameters

    参数

    (object) Parameters defining the desired output. (对象) 定义所需输出的参数.

    The method supports the following parameters. 该方法支持以下参数。

    参数类型描述
    dhostidsstring/array仅返回创建给定已发现主机的发现规则
    druleidsstring/array仅返回给定ID的发现规则
    dserviceidsstring/array仅返回创建给定已发现服务的发现规则
    selectDChecksquery在dchecks 属性下，返回被发现规则使用的发现检查

    支持count.
    selectDHostsquery在dhosts属性下，返回发现规则创建的发现主机

    支持count.
    limitSelectsinteger限制子选项返回的记录数

    适用于以下子选项:
    selectDChecks - 结果按dcheckid排序;
    selectDHosts - 结果按dhostsid排序
    sortfieldstring/array结果按给定属性排序.

    可能的值: druleid和name.
    countOutputboolean以下参数为get方法通常参数，在有详细说明
    editableboolean
    excludeSearchboolean
    filterobject
    limitinteger
    outputquery
    preservekeysboolean
    searchobject
    searchByAnyboolean
    searchWildcardsEnabledboolean
    sortorderstring/array
    startSearchboolean

    返回值

    (integer/array) Returns either:

    • an array of objects;

    (整数/数组) 返回:

    • 对象数据;

    • 如果countOutput被使用，返回获取对象的计数.

    Examples

    例子

    Retrieve all discovery rules

    获取所有发现规则

    Retrieve all configured discovery rules and the discovery checks they use. 获取所有已配置的发现规则及使用的发现检查。

    Request: 请求:

    1. {
    2.     "jsonrpc": "2.0",
    3.     "result": [
    4.         {
    6.             "proxy_hostid": "0",
    7.             "name": "Local network",
    8.             "iprange": "192.168.3.1-255",
    9.             "delay": "5s",
    10.             "nextcheck": "1348754327",
    11.             "status": "0",
    12.             "dchecks": [
    13.                 {
    14.                     "druleid": "2",
    15.                     "type": "3",
    16.                     "key_": "",
    17.                     "snmp_community": "",
    18.                     "ports": "21",
    19.                     "snmpv3_securityname": "",
    20.                     "snmpv3_securitylevel": "0",
    21.                     "snmpv3_authpassphrase": "",
    22.                     "snmpv3_privpassphrase": "",
    23.                     "uniq": "0",
    24.                     "snmpv3_authprotocol": "0",
    25.                     "snmpv3_privprotocol": "0"
    26.                 },
    27.                 {
    28.                     "dcheckid": "8",
    29.                     "druleid": "2",
    30.                     "type": "4",
    31.                     "key_": "",
    32.                     "snmp_community": "",
    33.                     "ports": "80",
    34.                     "snmpv3_securityname": "",
    35.                     "snmpv3_securitylevel": "0",
    36.                     "snmpv3_authpassphrase": "",
    37.                     "snmpv3_privpassphrase": "",
    39.                     "snmpv3_authprotocol": "0",
    40.                     "snmpv3_privprotocol": "0"
    41.                 }
    42.             ]
    43.         },
    44.         {
    45.             "proxy_hostid": "0",
    46.             "name": "Zabbix agent discovery",
    47.             "iprange": "192.168.1.1-255",
    48.             "delay": "1h",
    49.             "nextcheck": "0",
    50.             "status": "0",
    51.             "dchecks": [
    52.                 {
    53.                     "dcheckid": "10",
    54.                     "druleid": "6",
    55.                     "type": "9",
    56.                     "key_": "system.uname",
    57.                     "snmp_community": "",
    58.                     "ports": "10050",
    59.                     "snmpv3_securityname": "",
    60.                     "snmpv3_securitylevel": "0",
    61.                     "snmpv3_authpassphrase": "",
    62.                     "snmpv3_privpassphrase": "",
    63.                     "uniq": "0",
    64.                     "snmpv3_authprotocol": "0",
    65.                     "snmpv3_privprotocol": "0"
    66.                 }
    67.             ]
    68.         }
    69.     ],
    70.     "id": 1

    参考

    Source

    来源

    CDRule::get() in frontends/php/include/classes/api/services/CDRule.php.