> 主机原型对象

以下对象与主机原型 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的接口。