主机原型对象

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

主机原型

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

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

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

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

默认:host 属性值。

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

可能的值:
0 - (默认) 受监控的主机;
1 - 不受监控的主机。
inventory_mode integer 主机清单总体模式

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

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

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

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

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

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

组链接

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

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

属性行为
- 必须

组原型

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

属性 类型 描述
group_prototypeid ID 组原型的ID。

属性行为:
- 只读
name string 组原型的名称。

属性行为:
- 创建操作时必需

主机原型标签

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

属性 类型 说明
tag string Host prototype tag name.

属性行为
- 必须
value string 主机原型标签值。

自定义接口

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

属性 类型 描述
type integer 接口类型。

可能的值:
1 - agent;
2 - SNMP;
3 - IPMI;
4 - JMX。

属性行为
- 必需
useip integer 是否应通过 IP 进行连接。

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

属性行为
- 必需
ip string 接口使用的 IP 地址。
可以包含宏。

属性行为
- 必需 如果 useip 设置为“使用主机 IP 地址连接”
dns string 接口使用的 DNS 名称。
可以包含宏。

属性行为
- 必需 如果 useip 设置为“使用主机 DNS 名称连接”
port string 接口使用的端口号。
可以包含用户和 LLD 宏。

属性行为
- 必需
main integer 接口是否作为主机上的默认接口使用。
某些类型的接口只能在主机上设置为一个默认接口。

可能的值:
0 - 非默认;
1 - 默认。

属性行为
- 必需
details array 用于 自定义接口详情 的附加对象。

属性行为
- 必需 如果 type 设置为“SNMP”

自定义接口详细信息

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

属性 类型 描述
version integer SNMP接口版本。

可能的值:
1 - SNMPv1;
2 - SNMPv2c;
3 - SNMPv3。

属性行为
- 必需
bulk integer 是否使用批量SNMP请求。

可能的值:
0 - 不使用批量请求;
1 - (默认) - 使用批量请求。
community 字符串 SNMP社区。

属性行为
- 必需 如果version设置为"SNMPv1"或"SNMPv2c"
max_repetitions integer 用于原生SNMP批量请求的最大重复值(GetBulkRequest-PDUs)。
仅在SNMPv2和v3的discovery[]walk[]监控项中使用。

默认:10。
securityname 字符串 SNMPv3安全名称。

属性行为
- 支持 如果version设置为"SNMPv3"
securitylevel integer SNMPv3安全级别。

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

属性行为
- 支持 如果version设置为"SNMPv3"
authpassphrase 字符串 SNMPv3认证密码短语。

属性行为
- 支持 如果version设置为"SNMPv3"且securitylevel设置为"authNoPriv"或"authPriv"
privpassphrase 字符串 SNMPv3隐私密码短语。

属性行为
- 支持 如果version设置为"SNMPv3"且securitylevel设置为"authPriv"
authprotocol integer SNMPv3认证协议。

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

属性行为
- 支持 如果version设置为"SNMPv3"且securitylevel设置为"authNoPriv"或"authPriv"
privprotocol integer SNMPv3隐私协议。仅由SNMPv3接口使用。

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

属性行为
- 支持 如果version设置为"SNMPv3"且securitylevel设置为"authPriv"
contextname 字符串 SNMPv3上下文名称。

属性行为
- 支持 如果version设置为"SNMPv3"