[comment]: # translation:outdated
[comment]: # ({c5a9e121-c5a9e121})
# > LLD 规则 object
以下objects与`discoveryrule` API直接相关.
[comment]: # ({/c5a9e121-c5a9e121})
[comment]: # ({fce546e3-c17fa830})
### LLD规则
低级发现规则object具有以下属性。
| 属性 | [数据类型](/manual/api/reference_commentary#数据类型) | 描述 |
|--|--|------|
| itemid | string | *(只读)* LLD规则的ID。 |
| **delay**
(required) | string | LLD规则的更新间隔。接受秒数或带后缀的时间单位，可包含一个或多个[custom intervals](/manual/config/items/item/custom_intervals)，这些间隔可以是灵活间隔或调度间隔的序列化字符串。也接受用户宏。灵活间隔可以写成由正斜杠分隔的两个宏。间隔之间用分号分隔。
对于Zabbix trapper、依赖监控项和使用`mqtt.get`键的Zabbix agent(主动)类型为可选。 |
| **hostid**
(required) | string | LLD规则所属的主机的ID。 |
| **interfaceid**
(required) | string | LLD规则的主机接口ID。仅用于主机 LLD规则。
对于Zabbix agent(主动)、Zabbix内部、Zabbix trapper、依赖、数据库监控和脚本LLD规则不需要。HTTPagent LLD规则为可选。 |
| **key\_**
(required) | string | LLD规则键值。 |
| **name**
(required) | string | LLD规则的名称。 |
| **type**
(required) | integer | LLD规则的类型。
可能的值:
0 - Zabbix agent;
2 - Zabbix trapper;
3 - 简单检查;
5 - Zabbix内部;
7 - Zabbix agent(主动);
10 - 外部检查;
11 - 数据库监控;
12 - IPMIagent;
13 - SSHagent;
14 - TELNETagent;
16 - JMXagent;
18 - 依赖监控项;
19 - HTTPagent;
20 - SNMPagent;
21 - 脚本。 |
| **url**
(required) | string | HTTPagent LLD规则所需的URLstring。支持用户宏、{HOST.IP}、{HOST.CONN}、{HOST.DNS}、{HOST.HOST}、{HOST.NAME}、{ITEM.ID}、{ITEM.KEY}。 |
| allow\_traps | integer | HTTPagent LLD规则字段。允许像trapper监控项类型一样填充值。
0 - *(默认)* 不允许接收传入数据。
1 - 允许接收传入数据。 |
| authtype | integer | 仅用于SSHagent或HTTPagent LLD规则。
SSHagent认证方法可能的值:
0 - *(默认)* 密码;
1 - 公钥。
HTTPagent认证方法可能的值:
0 - *(默认)* 无
1 - 基本
2 - NTLM |
| description | string | LLD规则的描述。 |
| error | string | *(只读)* 更新LLD规则值时出现问题的错误文本。 |
| follow\_redirects | integer | HTTPagent LLD规则字段。轮询数据时跟随响应重定向。
0 - 不跟随重定向。
1 - *(默认)* 跟随重定向。 |
| headers | object | HTTPagent LLD规则字段。object包含HTTP(S)请求头，其中头名称用作键，头值用作值。
示例:
{ "User-Agent": "Zabbix" } |
| http\_proxy | string | HTTPagent LLD规则字段。HTTP(S)proxy连接string。 |
| ipmi\_sensor | string | IPMI传感器。仅用于IPMI LLD规则。 |
| jmx\_endpoint | string | JMXagent自定义连接string。
默认值:
service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi |
| lifetime | string | 不再发现的监控项将被删除的时间周期。接受秒数、带后缀的时间单位和用户宏。
默认: `30d`。 |
| master\_itemid | integer | 主监控项 ID。
允许递归最多3层依赖监控项，且依赖监控项的最大数量为999。
发现规则不能作为另一个发现规则的主监控项。
依赖监控项必需。 |
| output\_format | integer | HTTPagent LLD规则字段。是否将响应转换为JSON。
0 - *(默认)* 存储原始数据。
1 - 转换为JSON。 |
| params | string | 根据LLD规则类型的附加参数:
- SSH和Telnet LLD规则的执行脚本;
- 数据库监控LLD规则的SQLquery;
- 计算LLD规则的公式。 |
| parameters | array | 脚本类型LLD规则的附加参数。array包含objects，具有'名称'和'value'属性，其中名称必须唯一。 |
| password | string | 认证密码。用于简单检查、SSH、Telnet、数据库监控、JMX和HTTPagent LLD规则。 |
| post\_type | integer | HTTPagent LLD规则字段。存储在posts属性中的post数据体类型。
0 - *(默认)* 原始数据。
2 - JSON数据。
3 - XML数据。 |
| posts | string | HTTPagent LLD规则字段。HTTP(S)请求体数据。与post_type一起使用。 |
| privatekey | string | 私钥file的名称。 |
| publickey | string | 公钥file的名称。 |
| query\_fields | array | HTTPagent LLD规则字段。query参数。array包含'key':'value'对的objects，其中值可以是空string。 |
| request\_method | integer | HTTPagent LLD规则字段。请求方法类型。
0 - *(默认)* GET
1 - POST
2 - PUT
3 - HEAD |
| retrieve\_mode | integer | HTTPagent LLD规则字段。应存储响应的哪部分。
0 - *(默认)* 正文。
1 - 头。
2 - 正文和头都将存储。
对于request_method HEAD，只允许值为1。 |
| snmp\_oid | string | SNMP OID。 |
| ssl\_cert\_file | string | HTTPagent LLD规则字段。公共SSL密钥file路径。 |
| ssl\_key\_file | string | HTTPagent LLD规则字段。私有SSL密钥file路径。 |
| ssl\_key\_password | string | HTTPagent LLD规则字段。SSL密钥file的密码。 |
| state | integer | *(只读)* LLD规则的状态。
可能的值:
0 - *(默认)* 正常;
1 - 不支持。 |
| status | integer | LLD规则的状态。
可能的值:
0 - *(默认)* 启用LLD规则;
1 - 禁用LLD规则。 |
| status\_codes | string | HTTPagent LLD规则字段。所需HTTP状态码的范围，用逗号分隔。也支持用户宏作为逗号分隔列表的一部分。
示例: 200,200-{$M},{$M},200-400 |
| templateid | string | (只读)父模板LLD规则的ID。 |
| timeout | string | 监控项数据轮询请求超时。用于HTTPagent和脚本LLD规则。支持用户宏。
默认: 3s
最大值: 60s |
| trapper\_hosts | string | 允许的主机。用于trapper LLD规则或HTTPagent LLD规则。 |
| username | string | 认证用户名。用于简单检查、SSH、Telnet、数据库监控、JMX和HTTPagent LLD规则。
SSH和Telnet LLD规则必需。 |
| uuid | string | 通用唯一标识符，用于将导入的LLD规则链接到已存在的规则。仅用于模板上的LLD规则。如果未提供则自动生成。 |
| verify\_host | integer | HTTPagent LLD规则字段。是否验证主机名称与主机证书中的名称匹配。
0 - *(默认)* 不验证。
1 - 验证。 |
| verify\_peer | integer | HTTPagent LLD规则字段。是否验证主机证书的真实性。
0 - *(默认)* 不验证。
1 - 验证。 |
注意，对于某些方法(update, delete)，必需/可选参数的组合是不同的。
[comment]: # ({/fce546e3-c17fa830})
[comment]: # ({e640f5aa-b0412737})
### LLD 规则过滤器
LLD规则过滤器object定义了一组可用于筛选发现objects的条件。它具有以下属性：
| 属性 | [数据类型](/manual/api/reference_commentary#数据类型) | 描述 |
|--|--|------|
| **conditions**
(required) | array | 用于筛选结果的过滤条件集合。 |
| **evaltype**
(required) | integer | 过滤条件评估方法。
可能值：
0 - 与/或；
1 - 与；
2 - 或；
3 - 自定义表达式。 |
| eval\_formula | string | *(只读)* 用于评估过滤条件的生成表达式。该表达式包含通过`formulaid`引用特定过滤条件的ID。对于具有自定义表达式的过滤器，`eval_formula`的值等于`formula`的值。 |
| formula | string | 用户定义的表达式，用于评估具有自定义表达式的过滤器的条件。该表达式必须包含通过`formulaid`引用特定过滤条件的ID。表达式中使用的ID必须与过滤条件中定义的ID完全匹配：不能有任何条件未被使用或遗漏。
自定义表达式过滤器必需。 |
[comment]: # ({/e640f5aa-b0412737})
[comment]: # ({dec92f63-be83ef5c})
#### LLD 规则过滤条件
LLD规则过滤条件object定义了在LLD宏值上执行的独立检查。它具有以下属性：
| 属性 | [数据类型](/manual/api/reference_commentary#数据类型) | 描述 |
|--|--|------|
| **macro**
(required) | string | 待检查的LLD宏。 |
| **value**
(required) | string | 用于比较的值。 |
| formulaid | string | 用于在自定义表达式中引用该条件的任意唯一ID。只能包含大写字母。修改过滤条件时必须由用户定义该ID，但在后续请求时会重新生成。 |
| operator | integer | 条件运算符。
可选值：
8 - *(默认)* 匹配正则表达式；
9 - 不匹配正则表达式；
12 - 存在；
13 - 不存在。 |
::: notetip
要更好地理解如何将过滤器与各类表达式结合使用，请参阅
[discoveryrule.get](get#retrieving_filter_conditions)和
[discoveryrule.create](create#using_a_custom_expression_filter)方法页面的示例。
:::
[comment]: # ({/dec92f63-be83ef5c})
[comment]: # ({8afcce40-4a2b52b9})
### LLD 宏路径
LLD宏路径具有以下属性：
| 属性 | [数据类型](/manual/api/reference_commentary#数据类型) | 描述 |
|--|--|------|
| **lld\_macro**
(required) | string | LLD宏. |
| **path**
(required) | string | 用于选择将分配给相应宏的值的选择器. |
[comment]: # ({/8afcce40-4a2b52b9})
[comment]: # ({7a79dde4-14dc55c1})
### LLD 规则预处理
LLD规则预处理object具有以下属性。
| 属性 | [数据类型](/manual/api/reference_commentary#数据类型) | 描述 |
|--|--|------|
| **type**
(required) | integer | 预处理选项类型。
可能值：
5 - 正则表达式匹配；
11 - XML XPath；
12 - JSONPath；
15 - 不匹配正则表达式；
16 - 检查JSON错误；
17 - 检查XML错误；
20 - 心跳式丢弃未变更值；
21 - JavaScript；
23 - Prometheus转JSON；
24 - CSV转JSON；
25 - 替换；
27 - XML转JSON。 |
| **params**
(required) | string | 预处理选项使用的附加参数。多个参数用LF(\\n)字符分隔。 |
| **error\_handler**
(required) | integer | 预处理步骤失败时采取的操作类型。
可能值：
0 - 错误消息由Zabbix server设置；
1 - 丢弃值；
2 - 设置自定义值；
3 - 设置自定义错误消息。 |
| **error\_handler\_params**
(required) | string | 错误处理参数。与`error_handler`配合使用。
如果`error_handler`为0或1则必须为空。
如果`error_handler`为2则可以为空。
如果`error_handler`为3则不能为空。 |
每种预处理类型支持以下参数和错误处理程序。
| 预处理类型 | 名称 | 参数1 | 参数2 | 参数3 | 支持的错误处理程序 |
|------------------|----|-----------|-----------|-----------|------------------------|
| 5 | Regular expression | pattern^1^ | output^2^ | < | 0, 1, 2, 3 |
| 11 | XML XPath | path^3^ | < | < | 0, 1, 2, 3 |
| 12 | JSONPath | path^3^ | < | < | 0, 1, 2, 3 |
| 15 | Does not match regular expression | pattern^1^ | < | < | 0, 1, 2, 3 |
| 16 | Check for error in JSON | path^3^ | < | < | 0, 1, 2, 3 |
| 17 | Check for error in XML | path^3^ | < | < | 0, 1, 2, 3 |
| 20 | Discard unchanged with heartbeat | seconds^4,\ 5^ | < | < | < |
| 21 | JavaScript | script^2^ | < | < | < |
| 23 | Prometheus to JSON | pattern^5,\ 6^ | < | < | 0, 1, 2, 3 |
| 24 | CSV to JSON | character^2^ | character^2^ | 0,1 | 0, 1, 2, 3 |
| 25 | Replace | search string^2^ | replacement^2^ | < | < |
| 27 | XML to JSON | < | < | < | 0, 1, 2, 3 |
^1^ 正则表达式\
^2^ string\
^3^ JSONPath或XML XPath\
^4^ 正数integer（支持时间后缀，如30s、1m、2h、1d）\
^5^ 用户宏\
^6^ 遵循语法`{