[comment]: # aside: 1

[comment]: # ({3bf923db-c5a9e121})
# Объект правила LLD

Следующие объекты напрямую связаны с API `discoveryrule`.

[comment]: # ({/3bf923db-c5a9e121})

[comment]: # ({33580c07-c17fa830})
### Правило LLD

Объект правила обнаружения низкого уровня имеет следующие свойства.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|itemid|ID|ID правила LLD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations|
|delay|string|Интервал обновления правила LLD.<br><br>Принимает секунды или единицу времени с суффиксом (например, 30s, 1m, 2h, 1d) и, при необходимости, один или несколько [custom intervals](/manual/config/items/item/custom_intervals), разделенных точкой с запятой. Пользовательские интервалы могут представлять собой сочетание гибких и расписанных интервалов.<br><br>Принимает пользовательские макросы. Если используется макрос, значение должно быть одним макросом. Несколько макросов или макросы, смешанные с текстом, не поддерживаются. Гибкие интервалы можно записывать как два макроса, разделенные косой чертой (например, `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).<br><br>Пример:<br>`1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}`<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "Zabbix agent" (0), "Simple check" (3), "Zabbix internal" (5), "External check" (10), "Database monitor" (11), "IPMI agent" (12), "SSH agent" (13), "TELNET agent" (14), "JMX agent" (16), "HTTP agent" (19), "SNMP agent" (20), "Script" (21), "Browser" (22), or if `type` is set to "Zabbix agent (active)" (7) and `key_` does not contain "mqtt.get"|
|hostid|ID|ID узла сети, которому принадлежит правило LLD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *required* for create operations|
|flags|integer|[Origin](/manual/api/reference_commentary#entity-origin-flags) правила обнаружения.<br><br>Возможные значения:<br>1 - правило обнаружения низкого уровня;<br>5 - правило обнаружения низкого уровня, преобразованное из прототипа.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|interfaceid|ID|ID интерфейса узла сети для правила LLD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if LLD rule belongs to host and `type` is set to "Zabbix agent", "IPMI agent", "JMX agent", or "SNMP agent"<br>- *supported* if LLD rule belongs to host and `type` is set to "Simple check", "External check", "SSH agent", "TELNET agent", or "HTTP agent"|
|key\_|string|Ключ правила LLD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations<br>- *read-only* for inherited objects|
|name|string|Имя правила LLD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations<br>- *read-only* for inherited objects|
|type|integer|Тип правила LLD.<br><br>Возможные значения:<br>0 - Zabbix agent;<br>2 - Zabbix trapper;<br>3 - Simple check;<br>5 - Zabbix internal;<br>7 - Zabbix agent (active);<br>10 - External check;<br>11 - Database monitor;<br>12 - IPMI agent;<br>13 - SSH agent;<br>14 - TELNET agent;<br>16 - JMX agent;<br>18 - Dependent item;<br>19 - HTTP agent;<br>20 - SNMP agent;<br>21 - Script;<br>22 - Browser;<br>23 - Nested. Этот тип разрешен только если родитель правила является шаблоном (предполагается, что он связан с прототипом узла сети при обнаружении) или обнаруженным узлом сети (у которого правило LLD находится в корне).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations<br>- *read-only* for inherited objects|
|url|string|Строка URL.<br>Поддерживает пользовательские макросы, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {ITEM.ID}, {ITEM.KEY}.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects|
|allow\_traps|integer|Разрешить заполнение значения аналогично элементу данных trapper.<br><br>Возможные значения:<br>0 - *(default)* Не разрешать принимать входящие данные;<br>1 - Разрешить принимать входящие данные.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"|
|authtype|integer|Метод аутентификации.<br><br>Возможные значения, если `type` установлен в "SSH agent":<br>0 - *(default)* пароль;<br>1 - публичный ключ.<br><br>Возможные значения, если `type` установлен в "HTTP agent":<br>0 - *(default)* нет;<br>1 - basic;<br>2 - NTLM;<br>3 - Kerberos;<br>4 - Digest.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "SSH agent" or "HTTP agent"<br>- *read-only* for inherited objects (if `type` is set to "HTTP agent")|
|description|string|Описание правила LLD.|
|error|string|Текст ошибки, если возникли проблемы при обновлении значения правила LLD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|follow\_redirects|integer|Следовать перенаправлениям ответа при опросе данных.<br><br>Возможные значения:<br>0 - Не следовать перенаправлениям;<br>1 - *(default)* Следовать перенаправлениям.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects|
|headers|array|Массив [headers](#http-header), которые будут отправляться при выполнении HTTP-запроса.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects|
|http\_proxy|string|Строка подключения к HTTP(S) proxy.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects|
|ipmi\_sensor|string|Датчик IPMI.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "IPMI agent" and `key_` is not set to "ipmi.get"<br>- *supported* if `type` is set to "IPMI agent"<br>- *read-only* for inherited objects|
|jmx\_endpoint|string|Пользовательская строка подключения JMX agent.<br><br>По умолчанию: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "JMX agent"|
|lifetime|string|Период времени, по истечении которого элементы данных, которые больше не обнаруживаются, будут удалены. Принимает секунды, единицу времени с суффиксом или пользовательский макрос.<br><br>По умолчанию: `7d`.|
|lifetime\_type|integer|Сценарий удаления потерянных ресурсов LLD.<br><br>Возможные значения:<br>0 - *(default)* Удалять после достижения порога lifetime;<br>1 - Не удалять;<br>2 - Удалять немедленно.|
|enabled\_lifetime|string|Период времени, по истечении которого элементы данных, которые больше не обнаруживаются, будут отключены. Принимает секунды, единицу времени с суффиксом или пользовательский макрос.<br><br>По умолчанию: `0`.|
|enabled\_lifetime\_type|integer|Сценарий отключения потерянных ресурсов LLD.<br><br>Возможные значения:<br>0 - Отключать после достижения порога lifetime;<br>1 - Не отключать;<br>2 - *(default)* Отключать немедленно.|
|master\_itemid|ID|ID master-элемента данных.<br>Правило обнаружения не может быть master-элементом данных для другого правила обнаружения.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "Dependent item"<br>- *read-only* for inherited objects|
|output\_format|integer|Следует ли преобразовывать ответ в JSON.<br><br>Возможные значения:<br>0 - *(default)* Сохранять как есть;<br>1 - Преобразовать в JSON.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects|
|params|string|Дополнительные параметры в зависимости от типа правила LLD:<br>- выполняемый скрипт для правил LLD SSH и Telnet;<br>- SQL-запрос для правил LLD database monitor;<br>- формула для вычисляемых правил LLD;<br>- скрипт для правил LLD script и browser.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "Database monitor", "SSH agent", "TELNET agent", "Script" or "Browser"<br>- *read-only* for inherited objects (if `type` is set to "Script" or "Browser")|
|parameters|object/array|Дополнительные параметры, если `type` установлен в "Script" или "Browser".<br>Массив объектов со свойствами `name` и `value`, где `name` должен быть уникальным.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "Script" or "Browser"<br>- *read-only* for inherited objects|
|password|string|Пароль для аутентификации.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "JMX agent" and `username` is set<br>- *supported* if `type` is set to "Simple check", "Database monitor", "SSH agent", "TELNET agent", or "HTTP agent"<br>- *read-only* for inherited objects (if `type` is set to "HTTP agent")|
|post\_type|integer|Тип тела POST-данных, хранящихся в свойстве `posts`.<br><br>Возможные значения:<br>0 - *(default)* Сырые данные;<br>2 - данные JSON;<br>3 - данные XML.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects|
|posts|string|Данные тела HTTP(S)-запроса.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "HTTP agent" and `post_type` is set to "JSON data" or "XML data"<br>- *supported* if `type` is set to "HTTP agent" and `post_type` is set to "Raw data"<br>- *read-only* for inherited objects|
|privatekey|string|Имя файла закрытого ключа.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SSH agent" and `authtype` is set to "public key"|
|publickey|string|Имя файла открытого ключа.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SSH agent" and `authtype` is set to "public key"|
|query\_fields|array|Массив [query fields](#http-query-field), которые будут отправляться при выполнении HTTP-запроса.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects|
|request\_method|integer|Тип метода запроса.<br><br>Возможные значения:<br>0 - *(default)* GET;<br>1 - POST;<br>2 - PUT;<br>3 - HEAD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects|
|retrieve\_mode|integer|Какая часть ответа должна быть сохранена.<br><br>Возможные значения, если `request_method` установлен в "GET", "POST" или "PUT":<br>0 - *(default)* Тело;<br>1 - Заголовки;<br>2 - Будут сохранены и тело, и заголовки.<br><br>Возможные значения, если `request_method` установлен в "HEAD":<br>1 - Заголовки.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects|
|snmp\_oid|string|SNMP OID.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SNMP agent"<br>- *read-only* for inherited objects|
|ssl\_cert\_file|string|Путь к файлу открытого SSL-ключа.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects|
|ssl\_key\_file|string|Путь к файлу закрытого SSL-ключа.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects|
|ssl\_key\_password|string|Пароль для файла SSL-ключа.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects|
|state|integer|Состояние правила LLD.<br><br>Возможные значения:<br>0 - *(default)* normal;<br>1 - not supported.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|status|integer|Статус правила LLD.<br><br>Возможные значения:<br>0 - *(default)* включено;<br>1 - отключено.|
|status\_codes|string|Диапазоны требуемых HTTP-кодов состояния, разделенные запятыми. Также поддерживает пользовательские макросы как часть списка, разделенного запятыми.<br><br>Пример: 200,200-{$M},{$M},200-400<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects|
|templateid|ID|ID родительского правила LLD шаблона.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|timeout|string|Тайм-аут запроса опроса данных элемента данных.<br>Принимает секунды или единицу времени с суффиксом (например, 30s, 1m). Также принимает пользовательские макросы.<br><br>Диапазон допустимых значений: 1-600s.<br><br>По умолчанию: "" - использовать настройки proxy/global.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "Zabbix agent" (0), "Simple check" (3) and `key_` does not start with "`vmware.`" and "`icmpping`", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "HTTP agent" (19), "SNMP agent" (20) and `snmp_oid` starts with "`walk[`" or "`get[`", "Script" (21), "Browser" (22)<br>- *read-only* for inherited objects|
|trapper\_hosts|string|Разрешенные узлы сети.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "Zabbix trapper", or if `type` is set to "HTTP agent" and `allow_traps` is set to "Allow to accept incoming data"|
|username|string|Имя пользователя для аутентификации.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SSH agent", "TELNET agent", or if `type` is set to "JMX agent" and `password` is set<br>- *supported* if `type` is set to "Simple check", "Database monitor", or "HTTP agent"<br>- *read-only* for inherited objects (if `type` is set to "HTTP agent")|
|uuid|string|Универсальный уникальный идентификатор, используемый для связывания импортированных правил LLD с уже существующими. Если не указан, генерируется автоматически.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if the LLD rule belongs to a template|
|verify\_host|integer|Следует ли проверять, что имя узла сети для соединения совпадает с именем в сертификате узла сети.<br><br>Возможные значения:<br>0 - *(default)* Не проверять;<br>1 - Проверять.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects|
|verify\_peer|integer|Следует ли проверять, что сертификат узла сети является подлинным.<br><br>Возможные значения:<br>0 - *(default)* Не проверять;<br>1 - Проверять.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects|

[comment]: # ({/33580c07-c17fa830})

[comment]: # ({ab5307fa-b531b70b})
#### HTTP-заголовок

Объект заголовка имеет следующие свойства:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--------|---------------------------------------------------|-----------|
|name|string|Имя HTTP-заголовка.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Значение заголовка.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *required*|

[comment]: # ({/ab5307fa-b531b70b})

[comment]: # ({5b4177f3-ab8034d8})
#### Поле HTTP-запроса

Объект поля запроса определяет имя и значение, которые используются для указания параметра URL.
Он имеет следующие свойства:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--------|---------------------------------------------------|-----------|
|name|string|Имя параметра.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Значение параметра.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|

[comment]: # ({/5b4177f3-ab8034d8})

[comment]: # ({7bfc5ecb-b0412737})
### Фильтр правила LLD

Объект фильтра правила LLD определяет набор условий, которые можно использовать
для фильтрации обнаруженных объектов. Он имеет следующие свойства:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|conditions|object/array|Набор [условий фильтра](#lld-rule-filter-condition), используемых для фильтрации результатов. Условия будут отсортированы в порядке их размещения в формуле.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|evaltype|integer|[Метод оценки](/manual/discovery/low_level_discovery#filter) условий фильтра.<br><br>Возможные значения:<br>0 - And/Or;<br>1 - And;<br>2 - Or;<br>3 - Custom expression.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|eval\_formula|string|Сгенерированное выражение, которое будет использоваться для оценки условий фильтра. Выражение содержит ID, которые ссылаются на конкретные условия фильтра по их `formulaid`. Значение `eval_formula` равно значению `formula` для фильтров с пользовательским выражением.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|formula|string|Определенное пользователем выражение, которое будет использоваться для оценки условий фильтров с пользовательским выражением. Выражение должно содержать ID, которые ссылаются на конкретные условия фильтра по их `formulaid`. ID, используемые в выражении, должны точно совпадать с ID, определенными в условиях фильтра: ни одно условие не может остаться неиспользованным или быть пропущенным.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *required* if `evaltype` is set to "custom expression"|

[comment]: # ({/7bfc5ecb-b0412737})

[comment]: # ({92f63faf-be83ef5c})
#### Условие фильтра правила LLD

Объект условия фильтра правила LLD определяет отдельную проверку, выполняемую
над значением макроса LLD. Он имеет следующие свойства:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|macro|string|Макрос LLD, над которым выполняется проверка.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Значение для сравнения.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operator` is set to "matches regular expression" or "does not match regular expression"|
|formulaid|string|Произвольный уникальный ID, который используется для ссылки на условие из пользовательского выражения. Может содержать только заглавные буквы. ID должен быть задан пользователем при изменении условий фильтра, но будет сгенерирован заново при последующем запросе.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `evaltype` of [LLD rule filter object](#lld-rule-filter) is set to "custom expression"|
|operator|integer|Оператор условия.<br><br>Possible values:<br>8 - *(default)* matches regular expression;<br>9 - does not match regular expression;<br>12 - exists;<br>13 - does not exist.|

::: notetip
Чтобы лучше понять, как использовать фильтры с различными типами выражений, см. примеры на страницах методов [discoveryrule.get](get#retrieving-filter-conditions) и [discoveryrule.create](create#using-a-custom-expression-filter).
:::

[comment]: # ({/92f63faf-be83ef5c})

[comment]: # ({99ea4653-4a2b52b9})
### Путь макроса LLD

Путь макроса LLD имеет следующие свойства:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|lld\_macro|string|Макрос LLD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|path|string|Селектор для значения, которое будет назначено соответствующему макросу.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|

[comment]: # ({/99ea4653-4a2b52b9})

[comment]: # ({0769e0f5-14dc55c1})
### Предварительная обработка правила LLD

Объект предварительной обработки правила LLD имеет следующие свойства.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|type|integer|Тип опции предварительной обработки.<br><br>Возможные значения:<br>5 - Регулярное выражение;<br>11 - XML XPath;<br>12 - JSONPath;<br>14 - Совпадает с регулярным выражением;<br>15 - Не совпадает с регулярным выражением;<br>16 - Проверка на ошибку в JSON;<br>17 - Проверка на ошибку в XML;<br>20 - Отбрасывать неизменившееся с heartbeat;<br>21 - JavaScript;<br>23 - Prometheus to JSON;<br>24 - CSV to JSON;<br>25 - Замена;<br>27 - XML to JSON;<br>28 - Значение SNMP walk;<br>29 - SNMP walk to JSON;<br>30 - Значение SNMP get.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|params|string|Дополнительные параметры, используемые опцией предварительной обработки. Несколько параметров разделяются символом новой строки (\\n).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* если `type` установлено в "Регулярное выражение" (5), "XML XPath" (11), "JSONPath" (12), "Совпадает с регулярным выражением" (14), "Не совпадает с регулярным выражением" (15), "Проверка на ошибку в JSON" (16), "Проверка на ошибку в XML" (17), "Отбрасывать неизменившееся с heartbeat" (20), "JavaScript" (21), "Prometheus to JSON" (23), "CSV to JSON" (24), "Замена" (25), "Значение SNMP walk" (28), "SNMP walk to JSON" (29) или "Значение SNMP get" (30)|
|error\_handler|integer|Тип действия, используемый в случае сбоя шага предварительной обработки.<br><br>Возможные значения:<br>0 - Сообщение об ошибке задается сервером Zabbix;<br>1 - Отбросить значение;<br>2 - Установить пользовательское значение;<br>3 - Установить пользовательское сообщение об ошибке.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* если `type` установлено в "Регулярное выражение" (5), "XML XPath" (11), "JSONPath" (12), "Совпадает с регулярным выражением" (14), "Не совпадает с регулярным выражением" (15), "Проверка на ошибку в JSON" (16), "Проверка на ошибку в XML" (17), "Prometheus to JSON" (23), "CSV to JSON" (24), "XML to JSON" (27), "Значение SNMP walk" (28), "SNMP walk to JSON" (29) или "Значение SNMP get" (30)|
|error\_handler\_params|string|Параметры обработчика ошибок.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* если `error_handler` установлено в "Установить пользовательское значение" или "Установить пользовательское сообщение об ошибке"|

Для каждого типа предварительной обработки поддерживаются следующие параметры и обработчики ошибок.

|Preprocessing type|Name|Parameter 1|Parameter 2|Parameter 3|Supported error handlers|
|------------------|----|-----------|-----------|-----------|------------------------|
|5|Регулярное выражение|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|
|14|Совпадает с регулярным выражением|pattern^1^|<|<|0, 1, 2, 3|
|15|Не совпадает с регулярным выражением|pattern^1^|<|<|0, 1, 2, 3|
|16|Проверка на ошибку в JSON|path^3^|<|<|0, 1, 2, 3|
|17|Проверка на ошибку в XML|path^3^|<|<|0, 1, 2, 3|
|20|Отбрасывать неизменившееся с 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|Замена|search string^2^|replacement^2^|<|<|
|27|XML to JSON|<|<|<|0, 1, 2, 3|
|28|Значение SNMP walk|OID^2^|Format:<br>0 - Без изменений<br>1 - UTF-8 из Hex-STRING<br>2 - MAC из Hex-STRING<br>3 - Integer из BITS|<|0, 1, 2, 3|
|29|SNMP walk to JSON^7^|Field name^2^|OID prefix^2^|Format:<br>0 - Без изменений<br>1 - UTF-8 из Hex-STRING<br>2 - MAC из Hex-STRING<br>3 - Integer из BITS|0, 1, 2, 3|
|30|Значение SNMP get|Format:<br>1 - UTF-8 из Hex-STRING<br>2 - MAC из Hex-STRING<br>3 - Integer из BITS|<|<|0, 1, 2, 3|

^1^ регулярное выражение<br>
^2^ строка<br>
^3^ JSONPath или XML XPath<br>
^4^ положительное целое число (с поддержкой суффиксов времени, например 30s, 1m, 2h,
1d)<br>
^5^ пользовательский макрос<br>
^6^ шаблон Prometheus со следующим синтаксисом:
`<metric name>{<label name>="<label value>", ...} == <value>`. Каждый
компонент шаблона Prometheus (имя метрики, имя метки, значение метки и значение метрики)
может быть пользовательским макросом.<br>
^7^ Поддерживает несколько записей "Field name,OID prefix,Format records", разделенных символом новой строки.

[comment]: # ({/0769e0f5-14dc55c1})

[comment]: # ({f2f34ac6-2f32e5f0})
### Переопределения правил LLD

Объект переопределений правил LLD определяет набор правил (фильтры, условия и операции), которые используются для переопределения свойств различных объектов-прототипов. Он имеет следующие свойства:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|--|
|name|string|Уникальное имя переопределения.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|step|integer|Уникальный порядковый номер переопределения.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|stop|integer|Остановить обработку следующих переопределений, если есть совпадение.<br><br>Possible values:<br>0 - *(default)* не останавливать обработку переопределений;<br>1 - остановить обработку переопределений, если фильтр совпадает.|
|filter|object|Фильтр переопределения.|
|operations|object/array|Операции переопределения.|

[comment]: # ({/f2f34ac6-2f32e5f0})

[comment]: # ({67737988-573b52c4})
#### Фильтр переопределения правила LLD

Объект фильтра переопределения правила LLD определяет набор условий, которые, если
они совпадают с обнаруженным объектом, приводят к применению переопределения. Он имеет
следующие свойства:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|conditions|object/array|Набор [условий фильтра переопределения](#lld-rule-override-filter-condition), используемых для сопоставления обнаруженных объектов. Условия будут отсортированы в порядке их размещения в формуле.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|evaltype|integer|[Метод оценки](/manual/discovery/low_level_discovery#override) условий фильтра переопределения.<br><br>Возможные значения:<br>0 - And/Or;<br>1 - And;<br>2 - Or;<br>3 - Custom expression.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|eval\_formula|string|Сгенерированное выражение, которое будет использоваться для оценки условий фильтра переопределения. Выражение содержит идентификаторы, которые ссылаются на конкретные условия фильтра переопределения по их `formulaid`. Значение `eval_formula` равно значению `formula` для фильтров с пользовательским выражением.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|formula|string|Определяемое пользователем выражение, используемое для оценки условий фильтров переопределения с пользовательским выражением. Выражение должно содержать идентификаторы, которые ссылаются на конкретные условия фильтра переопределения по их `formulaid`. Идентификаторы, используемые в выражении, должны в точности совпадать с идентификаторами, определенными в условиях фильтра переопределения: ни одно условие не может остаться неиспользованным или опущенным.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *required* if `evaltype` is set to "custom expression"|

[comment]: # ({/67737988-573b52c4})

[comment]: # ({a2dc636e-e47f6c6a})
##### Условие фильтра переопределения правила LLD

Объект условия фильтра переопределения правила LLD определяет отдельную проверку, выполняемую для значения макроса LLD. Он имеет следующие свойства:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|--|
|macro|string|Макрос LLD, для которого выполняется проверка.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Значение для сравнения.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operator` is set to "matches regular expression" or "does not match regular expression"|
|formulaid|string|Произвольный уникальный ID, который используется для ссылки на условие из пользовательского выражения. Может содержать только заглавные буквы. ID должен быть задан пользователем при изменении условий фильтра, но будет сгенерирован заново при последующем запросе.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `evaltype` of [LLD rule override filter object](#lld-rule-override-filter) is set to "custom expression"|
|operator|integer|Оператор условия.<br><br>Possible values:<br>8 - *(default)* matches regular expression;<br>9 - does not match regular expression;<br>12 - exists;<br>13 - does not exist.|

[comment]: # ({/a2dc636e-e47f6c6a})

[comment]: # ({02af08bb-e7b08f3c})
#### Операция переопределения правила LLD

Операция переопределения правила LLD представляет собой комбинацию условий и действий,
выполняемых над объектом-прототипом. Она имеет следующие свойства:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|operationobject|integer|Тип обнаруженного объекта, для которого выполняется действие.<br><br>Возможные значения:<br>0 - прототип элемента данных;<br>1 - прототип триггера;<br>2 - прототип графика;<br>3 - прототип узла сети;<br>4 - прототип обнаружения.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|operator|integer|Оператор [условия переопределения](/manual/discovery/low_level_discovery#override).<br><br>Возможные значения:<br>0 - *(по умолчанию)* равно;<br>1 - не равно;<br>2 - содержит;<br>3 - не содержит;<br>8 - соответствует;<br>9 - не соответствует.|
|value|string|Шаблон для сопоставления с именем элемента данных, триггера, графика или прототипа узла сети в зависимости от выбранного объекта.|
|opstatus|object|Объект переопределения статуса операции для объектов типа элемент данных, триггер и прототип узла сети.|
|opdiscover|object|Объект переопределения статуса обнаружения операции (для всех типов объектов).|
|opperiod|object|Объект переопределения периода операции (интервала обновления) для объекта типа прототип элемента данных.|
|ophistory|object|Объект переопределения истории операции для объекта типа прототип элемента данных.|
|optrends|object|Объект переопределения трендов операции для объекта типа прототип элемента данных.|
|opseverity|object|Объект переопределения серьезности операции для объекта типа прототип триггера.|
|optag|object/array|Объект переопределения тега операции для объектов типа прототип триггера и прототип узла сети.|
|optemplate|object/array|Объект переопределения шаблона операции для объекта типа прототип узла сети.|
|opinventory|object|Объект переопределения инвентаря операции для объекта типа прототип узла сети.|

[comment]: # ({/02af08bb-e7b08f3c})

[comment]: # ({3d3c516a-52d3b579})
##### Статус операции переопределения правила LLD

Статус операции переопределения правила LLD, который задается для обнаруженного объекта. Он
имеет следующие свойства:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|status|integer|Переопределить статус для выбранного объекта.<br><br>Возможные значения:<br>0 - Создать включенным;<br>1 - Создать отключенным.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *required*|

[comment]: # ({/3d3c516a-52d3b579})

[comment]: # ({9cdd5143-ff620350})
##### Операция переопределения правила LLD: обнаружение

Операция переопределения правила LLD: статус обнаружения, который задается для обнаруженного объекта. Она имеет следующие свойства:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|discover|integer|Переопределяет статус обнаружения для выбранного объекта.<br><br>Возможные значения:<br>0 - Да, продолжать обнаружение объектов;<br>1 - Нет, новые объекты не будут обнаруживаться, а существующие будут помечены как потерянные.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *required*|

[comment]: # ({/9cdd5143-ff620350})

[comment]: # ({b3bef187-6e469c1b})
##### Период операции переопределения правила LLD

Период операции переопределения правила LLD — это значение интервала обновления, которое задается для обнаруженного элемента данных.
Он имеет следующие свойства:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|delay|string|Переопределяет интервал обновления прототипа элемента данных.<br><br>Принимает секунды или единицу времени с суффиксом (например, 30s, 1m, 2h, 1d) и, при необходимости, один или несколько [пользовательских интервалов](/manual/config/items/item/custom_intervals), разделенных точкой с запятой. Пользовательские интервалы могут представлять собой сочетание гибких интервалов и интервалов по расписанию.<br><br>Принимает пользовательские макросы или макросы LLD. Если используется, значение должно быть одним макросом. Несколько макросов или макросы, смешанные с текстом, не поддерживаются. Гибкие интервалы можно записывать как два макроса, разделенные косой чертой (например, `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).<br><br>Пример:<br>`1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}`<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *required*|

[comment]: # ({/b3bef187-6e469c1b})

[comment]: # ({28d8eca2-ff97489f})
##### История операций переопределения правила LLD

Значение истории операций переопределения правила LLD, которое задается для обнаруженного элемента данных. Оно имеет следующие свойства:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|history|string|Переопределяет историю прототипа элемента данных, задавая единицу времени, в течение которой должны храниться данные истории. Также принимает пользовательский макрос и LLD-макрос.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|

[comment]: # ({/28d8eca2-ff97489f})

[comment]: # ({a1ea1935-10b52601})
##### Тенденции операции переопределения правила LLD

Значение тенденций операции переопределения правила LLD, которое задается для обнаруженного элемента данных.
Оно имеет следующие свойства:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|trends|string|Переопределяет тенденции прототипа элемента данных, то есть задает единицу времени, в течение которой должны храниться данные тенденций. Также принимает пользовательский макрос и макрос LLD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|

[comment]: # ({/a1ea1935-10b52601})

[comment]: # ({e551a258-991f3bdc})
##### Уровень серьезности операции переопределения правила LLD

Значение уровня серьезности операции переопределения правила LLD, которое задается для обнаруженного
триггера. Оно имеет следующие свойства:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|severity|integer|Переопределяет уровень серьезности прототипа триггера.<br><br>Возможные значения:<br>0 - *(по умолчанию)* не классифицировано;<br>1 - информация;<br>2 - предупреждение;<br>3 - средняя;<br>4 - высокая;<br>5 - катастрофа.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *required*|

[comment]: # ({/e551a258-991f3bdc})

[comment]: # ({71613716-0693b8f3})
##### Тег операции переопределения правила LLD

Объект тега операции переопределения правила LLD содержит имя тега и значение, которые задаются для обнаруженного объекта. Он имеет следующие свойства:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|tag|string|Новое имя тега.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Новое значение тега.|

[comment]: # ({/71613716-0693b8f3})

[comment]: # ({0e075e84-5eebc05a})
##### Шаблон операции переопределения правила LLD

Объект шаблона операции переопределения правила LLD, который связан с обнаруженным
узлом сети. Он имеет следующие свойства:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|templateid|ID|Переопределить шаблон связанных шаблонов прототипа узла сети.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|

[comment]: # ({/0e075e84-5eebc05a})

[comment]: # ({e26c68ed-9c5cc3d1})
##### Инвентарь операции переопределения правила LLD

Значение режима инвентаря операции переопределения правила LLD, которое задается для обнаруженного узла сети. Оно имеет следующие свойства:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|inventory\_mode|integer|Переопределяет режим инвентаря прототипа узла сети.<br><br>Возможные значения:<br>-1 - отключено;<br>0 - *(по умолчанию)* вручную;<br>1 - автоматически.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *required*|

[comment]: # ({/e26c68ed-9c5cc3d1})
