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

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

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

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

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

|Свойство|Тип|Описание|
|----------------|------|----------------|
|itemid|строка|*(только чтение)* ID элемента данных.|
|**delay**<br>(требуется)|целое число|Интервал обновления элемента данных в секундах.|
|**hostid**<br>(требуется)|строка|ID узла сети, которому принадлежит элемент данных.|
|**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 трап.|
|**value\_type**<br>(требуется)|целое число|Тип информации элемента данных.<br><br>Возможные значения:<br>0 - числовое с плавающей точкой;<br>1 - символ;<br>2 - журнал (лог);<br>3 - числовое целое положительное;<br>4 - текст.|
|authtype|целое число|Метод аутентификации SSH. Используется только элементами данных SSH агента.<br><br>Возможные значения:<br>0 - *(по умолчанию)* пароль;<br>1 - публичный ключ.|
|data\_type|целое число|Тип данных элемента данных.<br><br>Возможные значения:<br>0 - *(по умолчанию)* десятичный;<br>1 - восьмиричный;<br>2 - шестнадцатеричный;<br>3 - логическый.|
|delay\_flex|строка|Переменные интервалы в виде сериализованной строки.<br><br>Каждый сериализованный переменный интервал содержит интервал обновления и [период времени](/ru/manual/appendix/time_period), разделенные прямой косой чертой. Несколько интервалов разделяются при помощи двоеточия.|
|delta|целое число|Значение, которое будет сохраняться.<br><br>Возможные значения:<br>0 - *(по умолчанию)* Как есть;<br>1 - Дельта, скорость в секунду;<br>2 - Дельта, простое изменение.|
|description|строка|Описание элемента данных.|
|error|строка|*(только чтение)* Текст ошибки, если имеются проблемы с обновлением элемента данных.|
|flags|целое число|*(только чтение)* Происхождение элемента данных.<br><br>Возможные значения:<br>0 - обычный элемент данных;<br>4 - обнаруженный элемент данных.|
|formula|целое число/дробное число|Пользовательский множитель.<br><br>По умолчанию: 1.|
|history|целое число|Количество дней хранения данных истории элемента данных.<br><br>По умолчанию: 90.|
|inventory\_link|целое число|ID поля инвентарных данных узла сети, которое заполняется элементом данных.<br><br>Обратитесь к [странице данных инвентаризации узла сети](/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|Время, когда наблюдаемый файл журнала был в последний раз обновлен. Используется только элементами данных журналов.|
|multiplier|целое число|Следует ли использовать пользовательский множитель.|
|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 родительского элемента данных из шаблона.|
|trapper\_hosts|строка|Разрешенные хосты. Используется только траппер элементами данных.|
|trends|целое число|Количество дней хранения данных динамики изменений элемента данных.<br><br>По умолчанию: 365.|
|units|строка|Единицы измерения значений.|
|username|строка|Имя пользователя для аутентификации. Используется элементами данных простой проверкой, SSH, Telnet, монитором баз данных и JMX.<br><br>Требуется для элементов данных SSH и Telnet.|
|valuemapid|строка|ID связанного преобразования значений.|