# > Объект элемента данных

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

### Элементы данных

::: noteclassic
Веб элементы нельзя напрямую создавать, обновлять или
удалять через Zabbix API.
:::

Объект элемента данных имеет следующие свойства.

|Свойство|Тип|Описание|
|----------------|------|----------------|
|itemid|строка|*(только чтение)* ID элемента данных.|
|**delay**<br>(требуется)|строка|Интервал обновления элемента данных. Принимает секунды или единицы времени с суффиксом и с или без одного или нескольких [пользовательских интервалов](/ru/manual/config/items/item/custom_intervals), которые состоят как из гибких интервалов, так и интервалов по расписанию в виде сериализованных строк. Также принимает пользовательские макросы. Гибкие интервалы можно записать в виде двух макросов, разделенных прямой косой чертой. Интервалы разделаются точкой с запятой.<br><br>Опционально для элементов данных Zabbix траппер и Зависимых.|
|**hostid**<br>(требуется)|строка|ID узла сети или шаблона, которому принадлежит элемент данных.<br><br>При операциях обновления это поле *только для чтения*.|
|**interfaceid**<br>(требуется)|строка|ID интерфейса узла сети элемента данных. Используется только элементами данных на узлах сети.<br><br>Не требуется для элементов данных у шаблонов. Опционален для элементов данных Zabbix агента (активного), Zabbix внутреннего, Zabbix траппер, Зависимого элемента данных, Zabbix агрегированного, монитора баз данных и вычисляемого.|
|**key\_**<br>(требуется)|строка|Ключ элемента данных.|
|**name**<br>(требуется)|строка|Имя элемента данных.|
|**type**<br>(требуется)|целое число|Тип элемента данных.<br><br>Возможные значения:<br>0 - Zabbix агент;<br>1 - SNMPv1 агент;<br>2 - Zabbix траппер;<br>3 - простая проверка;<br>4 - SNMPv2 агент;<br>5 - Zabbix внутренний;<br>6 - SNMPv3 агент;<br>7 - Zabbix агент (активный);<br>8 - Zabbix агрегированный;<br>9 - веб элемент данных;<br>10 - внешняя проверка;<br>11 - монитор баз данных;<br>12 - IPMI агент;<br>13 - SSH агент;<br>14 - TELNET агент;<br>15 - вычисляемый;<br>16 - JMX агент;<br>17 - SNMP трап;<br>18 - Зависимый элемент данных|
|**value\_type**<br>(требуется)|целое число|Тип информации элемента данных.<br><br>Возможные значения:<br>0 - числовое с плавающей точкой;<br>1 - символ;<br>2 - журнал (лог);<br>3 - числовое целое положительное;<br>4 - текст.|
|authtype|целое число|Метод аутентификации SSH. Используется только элементами данных SSH агента.<br><br>Возможные значения:<br>0 - *(по умолчанию)* пароль;<br>1 - публичный ключ.|
|description|строка|Описание элемента данных.|
|error|строка|*(только чтение)* Текст ошибки, если имеются проблемы с обновлением элемента данных.|
|flags|целое число|*(только чтение)* Происхождение элемента данных.<br><br>Возможные значения:<br>0 - обычный элемент данных;<br>4 - обнаруженный элемент данных.|
|history|целое число|Количество времени хранения данных истории элемента данных. Также принимает пользовательские макросы.<br><br>По умолчанию: 90d.|
|inventory\_link|целое число|ID поля инвентарных данных узла сети, которое заполняется элементом данных.<br><br>Обратитесь к [странице данных инвентаризации узла сети](/ru/manual/api/reference/host/object#данные_инвентаризации_узлов_сети) для получения списка поддерживаемых полей инвентарных данных узла сети и их ID.<br><br>По умолчанию: 0.|
|ipmi\_sensor|строка|Сенсор IPMI. Используется только элементами данных IPMI.|
|lastclock|timestamp|*(только чтение)* Время, когда элемент данных был в последний раз обновлен.<br><br>Это свойство вернёт значение только за период указанный в [ZBX\_HISTORY\_PERIOD](/ru/manual/web_interface/definitions).|
|lastns|целое число|*(только чтение)* Наносекунды, когда элемент данных был в последний раз обновлен.<br><br>Это свойство вернёт значение только за период указанный в [ZBX\_HISTORY\_PERIOD](/ru/manual/web_interface/definitions).|
|lastvalue|строка|*(только чтение)* Последнее значение элемента данных.<br><br>Это свойство вернёт значение только за период указанный в [ZBX\_HISTORY\_PERIOD](/ru/manual/web_interface/definitions).|
|logtimefmt|строка|Формат времени в записях журнала. Используется только в элементах данных журналов.|
|mtime|timestamp|Время, когда наблюдаемый файл журнала был в последний раз обновлен. Используется только элементами данных журналов.|
|params|строка|Дополнительные параметры, которые зависят от типа элемента данных:<br>- выполняемый скрипт в случае элементов данных SSH и Telnet;<br>- SQL запрос в случае элементов данных монитора базы данных;<br>- формула в случае вычисляемых элементов данных.|
|password|строка|Пароль для аутентификации. Используется элементами данных простой проверки, SSH, Telnet, монитором баз данных и JMX.|
|port|строка|Наблюдаемый элементом данных порт. Используется только элементами данных SNMP.|
|prevvalue|строка|*(только чтение)* Предыдущее значение элемента данных.<br><br>то свойство вернёт значение только за период указанный в [ZBX\_HISTORY\_PERIOD](/ru/manual/web_interface/definitions).|
|privatekey|строка|Имя файла приватного ключа.|
|publickey|строка|Имя файла публичного ключа.|
|snmp\_community|строка|SNMP community. Используется только элементами данных SNMPv1 и SNMPv2.|
|snmp\_oid|строка|SNMP OID.|
|snmpv3\_authpassphrase|строка|Фраза-пароль аутентификации SNMPv3. Используется только элементами данных SNMPv3.|
|snmpv3\_authprotocol|целое число|Протокол аутентификации SNMPv3. Используется только элементами данных SNMPv3.<br><br>Возможные значения:<br>0 - *(по умолчанию)* MD5;<br>1 - SHA.|
|snmpv3\_contextname|строка|Имя контекста SNMPv3. Используется только элементами данных SNMPv3.|
|snmpv3\_privpassphrase|строка|Фраза-пароль безопасности SNMPv3. Используется только элементами данных SNMPv3.|
|snmpv3\_privprotocol|целое число|Протокол безопасности SNMPv3. Используется только элементами данных SNMPv3.<br><br>Возможные значения:<br>0 - *(по умолчанию)* DES;<br>1 - AES.|
|snmpv3\_securitylevel|целое число|Уровень безопасности SNMPv3. Используется только элементами данных SNMPv3.<br><br>Возможные значения:<br>0 - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.|
|snmpv3\_securityname|строка|Имя безопасности SNMPv3. Используется только элементами данных SNMPv3.|
|state|целое число|*(только чтение)* Статус элемента данных.<br><br>Возможные значения:<br>0 - *(по умолчанию)* нормальный;<br>1 - неподдерживается.|
|status|целое число|Состояние элемента данных.<br><br>Возможные значения:<br>0 - *(по умолчанию)* активированный элемент данных;<br>1 - деактивированный элемент данных.|
|templateid|строка|(только чтение) ID родительского элемента данных из шаблона.<br><br>*Подсказка*: Используйте свойство `hostid`, чтобы указать принадлежность элемента данных к шаблону.|
|trapper\_hosts|строка|Разрешенные хосты. Используется только траппер элементами данных.|
|trends|целое число|Количество времени хранения данных динамики изменений элемента данных. Также принимает пользовательские макросы.<br><br>По умолчанию: 365d.|
|units|строка|Единицы измерения значений.|
|username|строка|Имя пользователя для аутентификации. Используется элементами данных простой проверкой, SSH, Telnet, монитором баз данных и JMX.<br><br>Требуется для элементов данных SSH и Telnet.|
|valuemapid|строка|ID связанного преобразования значений.|
|jmx\_endpoint|строка|Строка пользовательского соединения с JMX агентом.<br><br>Значение по умолчанию:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi|
|master\_itemid|целое число|ID основного элемента данных.<br>Разрешена рекурсия до 3 зависимых элементов данных и максимальное количество зависимых элементов данных допустимо до 999.<br><br>Требуется для Зависимых элементов данных.|

### Предварительная обработка элементов данных

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

|Свойство|Тип|Описание|
|----------------|------|----------------|
|**type**<br>(требуется)|целое число|Тип опции предварительной обработки.<br><br>Возможные значения:<br>1 - Пользовательский множитель;<br>2 - Обрезка справа;<br>3 - Обрезка слева;<br>4 - Обрезка;<br>5 - Соответствие регулярному выражению;<br>6 - Двоичное в десятичное;<br>7 - Восьмеричное в десятичное;<br>8 - Шестнадцатеричное в десятичное;<br>9 - Простое изменение;<br>10 - Изменение в секунду.|
|**params**<br>(требуется)|строка|Дополнительные параметры используемые опцией предварительной обработки. Несколько параметров разделяются символом LF (\\n).|