[comment]: # translation:outdated
[comment]: # ({6bb9f60f-6bb9f60f})
# > Объект элемента данных
Следующие объекты напрямую связаны с API элемента данных (`item`).
[comment]: # ({/6bb9f60f-6bb9f60f})
[comment]: # ({new-385ac8b5})
### Элементы данных
::: noteclassic
Веб элементы нельзя напрямую создавать, обновлять или
удалять через Zabbix API.
:::
Объект элемента данных имеет следующие свойства.
|Свойство|Тип|Описание|
|----------------|------|----------------|
|itemid|строка|*(только чтение)* ID элемента данных.|
|**delay** (требуется)|строка|Интервал обновления элемента данных. Принимает секунды или единицы времени с суффиксом и с или без одного или нескольких [пользовательских интервалов](/ru/manual/config/items/item/custom_intervals), которые состоят как из гибких интервалов, так и интервалов по расписанию в виде сериализованных строк. Также принимает пользовательские макросы. Гибкие интервалы можно записать в виде двух макросов, разделенных прямой косой чертой. Интервалы разделаются точкой с запятой.
Опционально для элементов данных Zabbix траппер и Зависимых.|
|**hostid** (требуется)|строка|ID узла сети, которому принадлежит элемент данных.
При операциях обновления это поле *только для чтения*.|
|**interfaceid** (требуется)|строка|ID интерфейса узла сети элемента данных. Используется только элементами данных на узлах сети.
Опционален для элементов данных Zabbix агента (активного), Zabbix внутреннего, Zabbix траппер, Зависимого элемента данных, Zabbix агрегированного, монитора баз данных и вычисляемого.|
|**key\_** (требуется)|строка|Ключ элемента данных.|
|**name** (требуется)|строка|Имя элемента данных.|
|**type** (требуется)|целое число|Тип элемента данных.
Возможные значения: 0 - числовое с плавающей точкой; 1 - символ; 2 - журнал (лог); 3 - числовое целое положительное; 4 - текст.|
|allow\_traps|целое число|Поле HTTP агента элемента данных. Позволяет заполнять значение также как и в элементе данных с типом траппер.
0 - *(по умолчанию)* Не разрешать принимать входящие данные. 1 - Разрешать принимать входящие данные.|
|authtype|целое число|Используется только SSH агент и HTTP агент элементами данных.
Возможные значения метода аутентификации SSH агента: 0 - *(по умолчанию)* пароль; 1 - публичный ключ.
Возможные значения метода аутентификации HTTP агента: 0 - *(по умолчанию)* нет 1 - простая 2 - NTLM|
|description|строка|Описание элемента данных.|
|error|строка|*(только чтение)* Текст ошибки, если имеются проблемы с обновлением элемента данных.|
|flags|целое число|*(только чтение)* Происхождение элемента данных.
Возможные значения: 0 - обычный элемент данных; 4 - обнаруженный элемент данных.|
|follow\_redirects|целое число|Поле HTTP агента элемента данных. Следование перенаправлениям при опросе данных.
0 - Не следовать перенаправлениям. 1 - *(по умолчанию)* Следовать перенаправлениям.|
|headers|объект|Поле HTTP агента элемента данных. Объект с HTTP(S) заголовками запроса, где имя заголовка используется ключом, а значение заголовка используется значением.
Пример: { "User-Agent": "Zabbix" }|
|history|целое число|Количество времени хранения данных истории элемента данных. Также принимает пользовательские макросы.
По умолчанию: 90d.|
|http\_proxy|строка|Поле HTTP агента элемента данных. Строка подключения HTTP(S) прокси.|
|inventory\_link|целое число|ID поля инвентарных данных узла сети, которое заполняется элементом данных.
Обратитесь к [странице данных инвентаризации узла сети](/manual/api/reference/host/object#данные_инвентаризации_узлов_сети) для получения списка поддерживаемых полей инвентарных данных узла сети и их ID.
По умолчанию: 0.|
|ipmi\_sensor|строка|Сенсор IPMI. Используется только элементами данных IPMI.|
|jmx\_endpoint|строка|Строка пользовательского соединения с JMX агентом.
Значение по умолчанию: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi|
|lastclock|timestamp|*(только чтение)* Время, когда элемент данных был в последний раз обновлен.
Это свойство вернёт значение только за период указанный в [ZBX\_HISTORY\_PERIOD](/ru/manual/web_interface/definitions).|
|lastns|целое число|*(только чтение)* Наносекунды, когда элемент данных был в последний раз обновлен.
Это свойство вернёт значение только за период указанный в [ZBX\_HISTORY\_PERIOD](/ru/manual/web_interface/definitions).|
|lastvalue|строка|*(только чтение)* Последнее значение элемента данных.
Это свойство вернёт значение только за период указанный в [ZBX\_HISTORY\_PERIOD](/ru/manual/web_interface/definitions).|
|logtimefmt|строка|Формат времени в записях журнала. Используется только в элементах данных журналов.|
|master\_itemid|целое число|ID основного элемента данных. Разрешена рекурсия до 3 зависимых элементов данных и максимальное количество зависимых элементов данных допустимо до 999.
Требуется для Зависимых элементов данных.|
|mtime|timestamp|Время, когда наблюдаемый файл журнала был в последний раз обновлен. Используется только элементами данных журналов.|
|output\_format|целое число|Поле HTTP агента элемента данных. Нужно ли конвертировать ответ в JSON.
0 - *(по умолчанию)* Записывать сырым. 1 - Конвертировать в JSON.|
|params|строка|Дополнительные параметры, которые зависят от типа элемента данных: - выполняемый скрипт в случае элементов данных SSH и Telnet; - SQL запрос в случае элементов данных монитора базы данных; - формула в случае вычисляемых элементов данных.|
|password|строка|Пароль для аутентификации. Используется элементами данных простой проверки, SSH, Telnet, монитором баз данных, JMX и HTTP агентом. Когда используется JMX типом, имя пользователя тоже должно быть задано вместе с паролем или оба свойства необходимо оставить пустыми.|
|port|строка|Наблюдаемый элементом данных порт. Используется только элементами данных SNMP.|
|post\_type|целое число|Поле HTTP агента элемента данных. Тип тела post данных записываемых в post свойстве.
0 - *(по умолчанию)* Сырые данные. 2 - JSON данные. 3 - XML данные.|
|posts|строка|Поле HTTP агента элемента данных. Данные тела запроса HTTP(S). Используется совместно с post\_type.|
|prevvalue|строка|*(только чтение)* Предыдущее значение элемента данных.
то свойство вернёт значение только за период указанный в [ZBX\_HISTORY\_PERIOD](/ru/manual/web_interface/definitions).|
|privatekey|строка|Имя файла приватного ключа.|
|publickey|строка|Имя файла публичного ключа.|
|query\_fields|массив|Поле HTTP агента элемента данных. Параметры запроса. Массив объектов с парами 'ключ':'значение', где значение может быть пустой строкой.|
|request\_method|целое число|Поле HTTP агента элемента данных. Тип метода запроса.
0 - *(по умолчанию)* GET 1 - *(по умолчанию)* POST 2 - PUT 3 - HEAD|
|retrieve\_mode|целое число|Поле HTTP агента элемента данных. Какую часть ответа нужно сохранять.
0 - *(по умолчанию)* Тело. 1 - Заголовки. 2 - Сохранять как тело, так и заголовки.
Для request\_method HEAD разрешенное значение только 1.|
|snmp\_community|строка|SNMP community. Используется только элементами данных SNMPv1 и SNMPv2.|
|snmp\_oid|строка|SNMP OID.|
|snmpv3\_authpassphrase|строка|Фраза-пароль аутентификации SNMPv3. Используется только элементами данных SNMPv3.|
|snmpv3\_authprotocol|целое число|Протокол аутентификации SNMPv3. Используется только элементами данных SNMPv3.
Возможные значения: 0 - *(по умолчанию)* MD5; 1 - SHA.|
|snmpv3\_contextname|строка|Имя контекста SNMPv3. Используется только элементами данных SNMPv3.|
|snmpv3\_privpassphrase|строка|Фраза-пароль безопасности SNMPv3. Используется только элементами данных SNMPv3.|
|snmpv3\_privprotocol|целое число|Протокол безопасности SNMPv3. Используется только элементами данных SNMPv3.
Возможные значения: 0 - *(по умолчанию)* DES; 1 - AES.|
|snmpv3\_securitylevel|целое число|Уровень безопасности SNMPv3. Используется только элементами данных SNMPv3.
Возможные значения: 0 - noAuthNoPriv; 1 - authNoPriv; 2 - authPriv.|
|snmpv3\_securityname|строка|Имя безопасности SNMPv3. Используется только элементами данных SNMPv3.|
|ssl\_cert\_file|строка|Поле HTTP агента элемента данных. Путь к файлу публичного SSL ключа.|
|ssl\_key\_file|строка|Поле HTTP агента элемента данных. Путь к файлу приватного SSL ключа.|
|ssl\_key\_password|строка|Поле HTTP агента элемента данных. Пароль к файлу SSL ключа.|
|state|целое число|*(только чтение)* Статус элемента данных.
Возможные значения: 0 - *(по умолчанию)* активированный элемент данных; 1 - деактивированный элемент данных.|
|status\_codes|строка|Поле HTTP агента элемента данных. Диапазоны требуемых HTTP кодов состояний, разделенные запятыми. Также как часть списка разделенного запятыми поддерживаются пользовательские макросы.
Пример: 200,200-{$M},{$M},200-400|
|templateid|строка|(только чтение) ID родительского элемента данных из шаблона.|
|timeout|строка|Поле HTTP агента элемента данных. Время ожидания запроса данных элемента данных. Поддерживаются пользовательские макросы.
по умолчанию: 3s максимальное значение: 60s|
|trapper\_hosts|строка|Разрешенные хосты. Используется траппер и HTTP агент элементами данных.|
|trends|целое число|Количество времени хранения данных динамики изменений элемента данных. Также принимает пользовательские макросы.
По умолчанию: 365d.|
|units|строка|Единицы измерения значений.|
|username|строка|Имя пользователя для аутентификации. Используется элементами данных простой проверкой, SSH, Telnet, монитором баз данных, JMX и HTTP агентом.
Требуется для SSH и Telnet элементов данных. Когда используется JMX типом, имя пользователя тоже должно быть задано вместе с паролем или оба свойства необходимо оставить пустыми.|
|valuemapid|строка|ID связанного преобразования значений.|
|verify\_host|целое число|Поле HTTP агента элемента данных. Проверка имени узла в URL в полях Common Name или Subject Alternate Name сертификата хоста.
0 - *(по умолчанию)* Не проверять. 1 - Проверять.|
|verify\_peer|целое число|Поле HTTP агента элемента данных. Проверка подлинности сертификата хоста.
0 - *(по умолчанию)* Не проверять. 1 - Проверять.|
[comment]: # ({/new-385ac8b5})
[comment]: # ({02969e71-c1b98afa})
### Тег элемента данных
Объект тега элемента данных имеет следующие свойства.
|Свойство|[Тип](/manual/api/reference_commentary#data_types)|Описание|
|--|--|------|
|**tag** (обязательное)|строка|Имя тега элемента данных.|
|value|строка|Значение тега элемента данных.|
[comment]: # ({/02969e71-c1b98afa})
[comment]: # ({new-2169bb78})
### Item preprocessing
The item preprocessing object has the following properties.
|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--------|---------------------------------------------------|-----------|
|**type** (required)|integer|The preprocessing option type.
Possible values: 1 - Custom multiplier; 2 - Right trim; 3 - Left trim; 4 - Trim; 5 - Regular expression matching; 6 - Boolean to decimal; 7 - Octal to decimal; 8 - Hexadecimal to decimal; 9 - Simple change; 10 - Change per second; 11 - XML XPath; 12 - JSONPath; 13 - In range; 14 - Matches regular expression; 15 - Does not match regular expression; 16 - Check for error in JSON; 17 - Check for error in XML; 18 - Check for error using regular expression; 19 - Discard unchanged; 20 - Discard unchanged with heartbeat; 21 - JavaScript; 22 - Prometheus pattern; 23 - Prometheus to JSON; 24 - CSV to JSON; 25 - Replace; 26 - Check unsupported; 27 - XML to JSON.|
|**params** (required)|string|Additional parameters used by preprocessing option. Multiple parameters are separated by LF (\\n) character.|
|**error\_handler** (required)|integer|Action type used in case of preprocessing step failure.
Possible values: 0 - Error message is set by Zabbix server; 1 - Discard value; 2 - Set custom value; 3 - Set custom error message.|
|**error\_handler\_params** (required)|string|Error handler parameters. Used with `error_handler`.
Must be empty, if `error_handler` is 0 or 1. Can be empty if, `error_handler` is 2. Cannot be empty, if `error_handler` is 3.|
The following parameters and error handlers are supported for each
preprocessing type.
|Preprocessing type|Name|Parameter 1|Parameter 2|Parameter 3|Supported error handlers|
|------------------|----|-----------|-----------|-----------|------------------------|
|1|Custom multiplier|number^1,\ 6^|<|<|0, 1, 2, 3|
|2|Right trim|list of characters^2^|<|<|<|
|3|Left trim|list of characters^2^|<|<|<|
|4|Trim|list of characters^2^|<|<|<|
|5|Regular expression|pattern^3^|output^2^|<|0, 1, 2, 3|
|6|Boolean to decimal|<|<|<|0, 1, 2, 3|
|7|Octal to decimal|<|<|<|0, 1, 2, 3|
|8|Hexadecimal to decimal|<|<|<|0, 1, 2, 3|
|9|Simple change|<|<|<|0, 1, 2, 3|
|10|Change per second|<|<|<|0, 1, 2, 3|
|11|XML XPath|path^4^|<|<|0, 1, 2, 3|
|12|JSONPath|path^4^|<|<|0, 1, 2, 3|
|13|In range|min^1,\ 6^|max^1,\ 6^|<|0, 1, 2, 3|
|14|Matches regular expression|pattern^3^|<|<|0, 1, 2, 3|
|15|Does not match regular expression|pattern^3^|<|<|0, 1, 2, 3|
|16|Check for error in JSON|path^4^|<|<|0, 1, 2, 3|
|17|Check for error in XML|path^4^|<|<|0, 1, 2, 3|
|18|Check for error using regular expression|pattern^3^|output^2^|<|0, 1, 2, 3|
|19|Discard unchanged|<|<|<|<|
|20|Discard unchanged with heartbeat|seconds^5,\ 6^|<|<|<|
|21|JavaScript|script^2^|<|<|<|
|22|Prometheus pattern|pattern^6,\ 7^|output^6,\ 8^|<|0, 1, 2, 3|
|23|Prometheus to JSON|pattern^6,\ 7^|<|<|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^|<|<|
|26|Check unsupported|<|<|<|1, 2, 3|
|27|XML to JOSN|<|<|<|0, 1, 2, 3|
^1^ integer or floating-point number\
^2^ string\
^3^ regular expression\
^4^ JSONPath or XML XPath\
^5^ positive integer (with support of time suffixes, e.g. 30s, 1m, 2h,
1d)\
^6^ user macro\
^7^ Prometheus pattern following the syntax:
`{