Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

> 主机原型对象

以下对象与主机原型 API直接相关。

主机原型

主机原型对象有以下属性:

属性 对象 描述
hostid 字符串 (只读)主机原型ID。
host
(必选)
字符串 主机原型技术名称
name 字符串 主机原型可见名称。

默认: host 属性值。
status 整型 主机原型状态。

可能值有:
0 - (默认) 被监控的主机;
1 - 没被监控的主机。
inventory_mode 整型 主机资产填写模式。

可能值是:
-1 - (默认) 关闭;
0 - 手动;
1 - 自动。
templateid 字符串 (只读) 主机原型父模板ID。
discover 整型 主机原型发现状态。

可能的值:
0 - (默认) 新主机将被发现;
1 - 新主机不会被发现并存在的主机被标记为丢失。
custom_interfaces 整型 通过主机原型创建的主机接口

可能的值:
0 - (默认) 从父主机继承接口;
1 -使用主机原型定制接口。
uuid 字符串 通用的唯一标识符,用于向现有主机导入主机原型,仅用于模板上的主机原型,如果没有指定,自动生成。

对于更新操作,此字段是只读

组链接

组链接对象将主机原型与主机组链接,并具有以下属性:

属性 类型 描述
group_prototypeid 字符串 (只读) 组链接ID.
groupid
(必选)
字符串 主机组ID。
hostid 字符串 (只读) 主机原型ID。
templateid 字符串 (只读) 父模板组链接ID。

组原型

组原型对象定义将为已发现的主机创建的组,并具有以下属性:

属性 类型 描述
group_prototypeid 字符串 (只读) 组原型的ID。
name
(必选)
字符串 组原型的名称。
hostid 字符串 (只读)主机原型的ID。
templateid 字符串 (只读) 父模板组原型的ID。

主机原型标签

主机原型标签对象有以下属性:

属性 类型 描述
tag
(必选)
字符串 主机原型标签名称。
value 字符串 主机原型标签值。

自定义接口

自定义接口对象与以下属性:

属性 类型 描述
dns 字符串 接口使用的DNS名称。

如果直接通过DNS连接,则必选,可以包含宏
ip 字符串 接口使用的IP

如果直接通过IP连接,则必选,可以包含宏
main
(必选)
整型 该接口是否在主机上用作默认接口,在主机上只能将某种类型的一个接口设置为默认值。

可能的值:
0 - 不是默认;
1 - 默认。
port
(必选)
字符串 接口使用的端口号。可以包含用户宏和LLD宏。
type
(必选)
整型 接口类型。

可能的值:
1 - agent;
2 - SNMP;
3 - IPMI;
4 - JMX。
useip
(必选)
整型 是否通过IP进行连接。

可能的值有:
0 - 使用主机DNS名称进行连接;
1 - 使用此主机接口的IP地址进行连接
details 数组 接口的附加对象。如果接口'类型'是SNMP则 必须

自定义接口详细信息

详细信息对象有以下属性:

属性 类型 描述
version
(必选)
整型 SNMP接口版本。

可能的值有:
1 - SNMPv1;
2 - SNMPv2c;
3 - SNMPv3
bulk 整型 是否使用批量的SNMP请求

可能的值有:
0 - 不使用批量请求;
1 - (默认) - 使用批量请求。
community 字符串 SNMP 团体字。仅用于SNMPv1和SNMPv2接口。
securityname 字符串 SNMPv3安全名称。仅用于SNMPv3的接口
securitylevel 整型 SNMPv3安全级别。仅用于SNMPv3的接口

可能的值有:
0 - (默认) - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv。
authpassphrase 字符串 SNMPv3身份认证密码。仅用于SNMPv3的接口。
privpassphrase 字符串 SNMPv3私有密码,仅用于SNMPv3的接口。
authprotocol 整型 SNMPv3认证协议。仅用于SNMPv3的接口。

可能的值有:
0 - (默认) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512。
privprotocol 整型 SNMPv3隐私协议。仅用于SNMPv3的接口。

可能的值有:
0 - (默认) - DES;
1 - AES128;
2 - AES192;
3 - AES256;
4 - AES192C;
5 - AES256C。
contextname 字符串 SNMPv3上下文名称。仅用于SNMPv3的接口。