主机原型对象

以下对象与 hostprototype API 直接相关。

主机原型

主机原型对象具有以下属性。

属性类型说明
hostidID主机原型的 ID。

属性行为:
- 只读
- 对升级操作是必须*的
hoststring主机原型的技术名称。

属性行为:
- 对创建操作是必须的
- 对继承的对象是只读
namestring主机原型的可见名称。

默认：host 属性值。

属性行为:
- 对继承的对象是只读
statusinteger主机原型的状态。

可能的值：
0 - (默认) 受监控的主机；
1 - 不受监控的主机。
inventory_modeinteger主机清单总体模式

可能的值：
-1 - (默认) 禁用；
0 - 手动；
1 - 自动。
templateidID父模板主机原型的 ID。

属性行为:
- 只读
discoverinteger主机原型发现状态。

可能的值：
0 - (默认) 将发现新的主机；
1 - 新主机将不会被发现，现有主机将被标记为失联。
custom_interfacesinteger主机原型创建的主机的 自定义接口 的来源。

可能的值：
0 - (默认) 继承父主机的接口；
1 - 使用主机原型自定义接口。

属性行为:
- 对继承的对象是只读
uuidstring通用唯一标识符，用于将导入的主机原型与已有的主机原型相链接。如果未给出，则自动生成。

属性行为:
- 如果主机原型属于模板，则受支持

组链接

组链接对象将主机原型与主机组链接起来。 它具有以下属性。

属性类型说明
groupidID主机组 ID。

属性行为：
- 必须

组原型

组原型对象定义了将为被发现主机创建的组。 它具有以下属性。

属性类型说明
namestring小组原型名称。

属性行为：
- 必须

主机原型标签

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

属性类型说明
tagstringHost prototype tag name.

属性行为：
- 必须
valuestring主机原型标签值。

自定义接口

如果 主机原型对象 的 custom_interfaces 设置为 “使用主机原型自定义接口” 则支持自定义接口。 自定义界面对象具有以下属性。

属性类型说明
typeinteger接口类型。

可能的值：
1 - Agent;
2 - SNMP;
3 - IPMI;
4 - JMX.

属性行为：
- 必须
useipinteger是否应通过 IP 进行连接。

可能的值：
0 - 使用主机 DNS 名称连接；
1 - 使用主机 IP 地址连接。

属性行为：
- 必须
ipstring接口使用的 IP 地址。
可包含宏。

属性行为：
- 如果 useip 设置为 “使用主机 IP 地址连接”则是必须的
dnsstring接口使用的 DNS 名称。
可包含宏。

属性行为：
- 如果 useip 设置为 “使用主机 DNS 名称连接”则是必须的
portstring接口使用的端口号。
可包含用户宏和 LLD 宏。

属性行为:
- 必须
maininteger接口是否在主机上作为默认设置使用。
一台主机上只能设置一个某种类型的接口为默认设置。

可能的值：
0 - 不默认；
1 - 默认。

属性行为:
- 必须
detailsarray接口的附加对象。

属性行为:
- 如果 type 设置为 “SNMP”，则是必须的

自定义接口详情

详细信息对象具有以下属性。

属性类型说明
versionintegerSNMP 接口版本。

可能的值：
1 - SNMPv1;
2 - SNMPv2c;
3 - SNMPv3.

属性行为:
- 必须
bulkinteger是否使用批量 SNMP 请求。

可能的值：
0 - 不要使用批量请求；
1 - (默认) - 使用批量请求。
communitystringSNMP 社区。

属性行为:
- 如果 version 设置为 “SNMPv1 “或 “SNMPv2c “则是必须的
max_repetitionsinteger本地 SNMP 批量请求 的最大重复值 (GetBulkRequest-PDUs).
仅用于 SNMPv2 和 v3 中的 discovery[] 和 walk[] 监控项。

默认：10.
securitynamestringSNMPv3 安全名称。

属性行为:
- 如果version设置为 “SNMPv3”则是支持的
securitylevelintegerSNMPv3 安全级别。

可能的值：
0 - (默认) - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.

属性行为:
- 如果version设置为 “SNMPv3”则是支持的
authpassphrasestringSNMPv3 验证口令。

属性行为:
- 如果version设置为 “SNMPv3”，并且 securitylevel 设置为 “authNoPriv” 或 “authPriv”，则是支持的
privpassphrasestringSNMPv3 隐私口令。

属性行为:
- 如果version设置为 “SNMPv3”，并且 securitylevel 设置为 “authPriv”，则是支持的
authprotocolintegerSNMPv3 验证协议。

可能的值：
0 - (默认) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512.

属性行为:
- 如果version设置为 “SNMPv3”，并且 securitylevel 设置为 “authNoPriv” 或 “authPriv”，则是支持的
privprotocolintegerSNMPv3 隐私协议。仅用于 SNMPv3 接口。

可能的值：
0 - (默认) - DES;
1 - AES128;
2 - AES192;
3 - AES256;
4 - AES192C;
5 - AES256C.

属性行为：
- 如果version设置为 “SNMPv3”，并且 securitylevel 设置为 “authPriv”，则是支持*的
contextnamestringSNMPv3 上下文名称。

属性行为:
- 如果version设置为 “SNMPv3”则是支持的