监控项

> Item object
- 监控项

> Item object

以下对象与“item” API直接相关。

Web 监控项无法通过 Zabbix API 直接创建，更新或删除。

监控项对象具有以下属性。

属性	类型	说明
itemid	string	(只读) 监控项ID
delay(required)	string	更新监控项的间隔。接受具有后缀的秒或时间单位，并且具有或不具有由灵活间隔和调度间隔组成的一个或多个自定义间隔作为串行化字符串。也接受用户宏。灵活的间隔可以写成两个由正斜杠分隔的宏。间隔用分号分隔。
hostid(required)	string	该项所属的主机 ID。
interfaceid(required)	string	ID of the item's host interface. Used only for host items.项主机接口的ID。仅用于主机项。 Optional for Zabbix agent (active), Zabbix internal, Zabbix trapper, Zabbix aggregate, database monitor and calculated items.适用于Zabbix代理（活动），Zabbix内部，Zabbix陷阱，Zabbix聚合，数据库监控和计算项。
key_(required)	string	Item key.
name(required)	string	Name of the item. item的名称
type(required)	integer	Type of the item. item的类别Possible values:可能的值：0 - Zabbix agent; 1 - SNMPv1 agent; 2 - Zabbix trapper; 3 - simple check; 4 - SNMPv2 agent; 5 - Zabbix internal; 6 - SNMPv3 agent; 7 - Zabbix agent (active); 8 - Zabbix aggregate; 9 - web item; 10 - external check; 11 - database monitor; 12 - IPMI agent; 13 - SSH agent; 14 - TELNET agent; 15 - calculated; 16 - JMX agent; 17 - SNMP trap.
value_type(required)	integer	Type of information of the item. item的信息类型。Possible values:可能的值： 0 - numeric float; 1 - character; 2 - log; 3 - numeric unsigned; 4 - text.
authtype	integer	SSH authentication method. Used only by SSH agent items. SSH认证方式。仅用于SSH代理项Possible values: 可能的值：0 - (default) password; 1 - public key.
datatype	integer	Data type of the item. item的数据类型Possible values: 可能的值：0 - (default默认) decimal; 1 - octal; 2 - hexadecimal; 3 - boolean.
delta	integer	Value that will be stored. 将被存储的值Possible values:可能的值： 0 - (default) as is; 1 - Delta, speed per second; 2 - Delta, simple change.
description	string	Description of the item.item说明
error	string	(readonly) Error text if there are problems updating the item.如果更新项目时出现问题，则显示错误文本。
flags	integer	(readonly) Origin of the item. item的来源 Possible values: 可能的值0 - a plain item; 4 - a discovered item.
formula	integer/float	Custom multiplier. Default: 1.
history	string	A time unit of how long the history data should be stored. Also accepts user macro. 历史数据应该存储多长时间的单位。也接受用户宏。Default: 90d.
inventory_link	integer	ID of the host inventory field that is populated by the item. 由item填充的主机库存字段的ID。Refer to the host inventory page for a list of supported host inventory fields and their IDs.请参阅主机清单页面以获取支持的主机清单字段及其ID的列表。 Default: 0.
ipmi_sensor	string	IPMI sensor. Used only by IPMI items. IPMI传感器仅由IPMI项使用。
lastclock	timestamp	(readonly) Time when the item was last updated. item上次更新时间。This property will only return a value for the period configured in ZBX_HISTORY_PERIOD. 此属性将仅返回ZBX_HISTORY_PERIOD中配置的时间段的值
lastns	integer	(readonly) Nanoseconds when the item was last updated. item上次更新时的纳秒This property will only return a value for the period configured in ZBX_HISTORY_PERIOD. 此属性将仅返回ZBX_HISTORY_PERIOD中配置的时间段的值。
lastvalue	string	(readonly) Last value of the item. item的最后一个值。This property will only return a value for the period configured in ZBX_HISTORY_PERIOD. 此属性将仅返回ZBX_HISTORY_PERIOD中配置的时间段的值
logtimefmt	string	Format of the time in log entries. Used only by log items.日志条目中的时间格式。仅用于日志项。
mtime	timestamp	Time when the monitored log file was last updated. Used only by log items.受监控日志文件上次更新的时间。仅用于日志项。
multiplier	integer	Whether to use a custom multiplier.是否使用自定义乘数。
params	string	Additional parameters depending on the type of the item: 附加参数取决于item的类型：- executed script for SSH and Telnet items;SSH和Telnet items执行脚本; - SQL query for database monitor items; SQL查询数据库监视项- formula for calculated items.计算项公式
password	string	Password for authentication. Used by simple check, SSH, Telnet, database monitor and JMX items.认证密码。用于简单检查，SSH，Telnet，数据库监控和JMX项
port	string	Port monitored by the item. Used only by SNMP items.由项监视的端口。仅由SNMP项使用。
prevvalue	string	(readonly) Previous value of the item. item的上一个值。This property will only return a value for the period configured in ZBX_HISTORY_PERIOD.此属性将仅返回ZBX_HISTORY_PERIOD中配置的时间段的值
privatekey	string	Name of the private key file.私钥文件的名称
publickey	string	Name of the public key file.公钥文件的名称
snmp_community	string	SNMP community. Used only by SNMPv1 and SNMPv2 items. SNMP社区。仅由SNMPv1和SNMPv2项使用。
snmp_oid	string	SNMP OID.
snmpv3_authpassphrase	string	SNMPv3 auth passphrase. Used only by SNMPv3 items. 仅用于SNMPv3项。
snmpv3_authprotocol	integer	SNMPv3 authentication protocol. Used only by SNMPv3 items. SNMPv3认证协议仅用于SNMPv3项。Possible values:可能的值 0 - (default) MD5; 1 - SHA.
snmpv3_contextname	string	SNMPv3 context name. Used only by SNMPv3 items. SNMPv3上下文名称。仅用于SNMPv3项
snmpv3_privpassphrase	string	SNMPv3 priv passphrase. Used only by SNMPv3 items. SNMPv3 priv密码。仅用于SNMPv3项
snmpv3_privprotocol	integer	SNMPv3 privacy protocol. Used only by SNMPv3 items. SNMPv3隐私协议。仅用于SNMPv3项Possible values:可能的值： 0 - (default) DES; 1 - AES.
snmpv3_securitylevel	integer	SNMPv3 security level. Used only by SNMPv3 items.SNMPv3安全级别。仅用于SNMPv3项 Possible values:可能的值： 0 - noAuthNoPriv; 1 - authNoPriv; 2 - authPriv.
snmpv3_securityname	string	SNMPv3 security name. Used only by SNMPv3 items. SNMPv3安全名称。仅用于SNMPv3项
state	integer	(readonly) State of the item. item状态。Possible values: 可能的值：0 - (default) normal; 1 - not supported.
status	integer	Status of the item. item状态Possible values: 可能的值：0 - (default)_ enabled item; 1 - disabled item.
templateid	string	(readonly) ID of the parent template item. 父模板项的ID。
trapper_hosts	string	Allowed hosts. Used only by trapper items.允许的主机。仅由trapper items使用。
trends	string	A time unit of how long the trends data should be stored. Also accepts user macro.趋势数据应存储多长时间的单位。也接受用户宏。 Default: 365d.
units	string	Value units.
username	string	Username for authentication. Used by simple check, SSH, Telnet, database monitor and JMX items. 验证用户名。用于简单检查，SSH，Telnet，数据库监控和JMX项Required by SSH and Telnet items.需要SSH和Telnet项目。
valuemapid	string	ID of the associated value map.相关值图的ID。