这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.

以下objects与hostprototypeAPI直接相关。

主机原型

主机原型object具有以下属性。

属性 数据类型 描述
hostid string (只读) 主机原型的ID。
host
(required)
string 主机原型的技术名称。
name string 主机原型的可见名称。

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

可能的值有:
0 - (默认) 受监控的主机;
1 - 未监控的主机。
inventory_mode integer 主机清单填充模式。

可能的值有:
-1 - (默认) 禁用;
0 - 手动;
1 - 自动。
templateid string (只读) 父模板主机原型的ID。
discover integer 主机原型发现状态。

可能的值:
0 - (默认) 将发现新的主机;
1 - 不会发现新的主机,且现有的主机将被标记为丢失。
custom_interfaces integer 由主机原型创建的主机的接口来源。

可能的值:
0 - (默认) 从父主机继承接口;
1 - 使用主机原型的自定义接口。
uuid string 通用唯一标识符,用于将导入的主机原型链接到已存在的原型。仅用于模板上的主机原型。如果未提供,则自动生成。

请注意,某些方法(更新、删除)所需/可选参数的组合有所不同。

组链接

组链接object用于将主机原型与主机组关联,具有以下属性。

属性 数据类型 描述
groupid
(required)
string 主机组的标识符。

组原型

组原型object定义了将为发现的主机创建的组,并具有以下属性。

属性 数据类型 描述
group_prototypeid string (只读) 组原型的ID。
name
(required)
string 组原型的名称。

主机原型标签

主机原型标签object具有以下属性。

属性 数据类型 描述
tag
(required)
string 主机原型标签名称。
value string 主机原型标签值。

自定义接口

自定义接口object具有以下属性。

属性 数据类型 描述
dns string 接口使用的DNS名称。

必填(如果通过DNS建立连接)。可包含宏。
ip string 接口使用的IP地址。

必填(如果通过IP建立连接)。可包含宏。
main
(required)
integer 该接口是否作为主机的默认接口。每个主机上同类型接口只能有一个设为默认。

可选值:
0 - 非默认;
1 - 默认。
port
(required)
string 接口使用的端口号。可包含用户宏和LLD宏。
type
(required)
integer 接口类型。

可选值:
1 - agent;
2 - SNMP;
3 - IPMI;
4 - JMX。
useip
(required)
integer 是否通过IP建立连接。

可选值:
0 - 使用主机的DNS名称连接;
1 - 使用该主机接口的IP地址连接。
details array 接口的附加object。必填(当接口类型为SNMP时)。

自定义接口详情

详情 object 具有以下属性。

属性 数据类型 描述
version
(required)
integer SNMP接口版本。

可能值为:
1 - SNMPv1;
2 - SNMPv2c;
3 - SNMPv3
bulk integer 是否使用批量SNMP请求。

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

可能值为:
0 - (默认) - 无认证无加密;
1 - 认证无加密;
2 - 认证加密。
authpassphrase string SNMPv3认证密码。仅用于SNMPv3接口。
privpassphrase string SNMPv3加密密码。仅用于SNMPv3接口。
authprotocol integer SNMPv3认证协议。仅用于SNMPv3接口。

可能值为:
0 - (默认) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512。
privprotocol integer SNMPv3加密协议。仅用于SNMPv3接口。

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