主机原型对象

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

主机原型

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

Property Type Description
hostid ID 主机原型的 ID。

属性行为：
- 只读
- 更新操作时 必需
host string 主机原型的技术名称。

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

默认值：host 属性值。

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

可能的值：
0 - （默认） 已监控主机；
1 - 未监控主机。
flags integer 主机原型的来源。

可能的值：
2 - 主机原型；
6 - 已发现的主机原型

属性行为：
- 只读
inventory_mode integer 主机资产记录填充模式。

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

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

可能的值：
0 - （默认） 将发现新主机；
1 - 不会发现新主机，现有主机将被标记为丢失。
custom_interfaces integer 由主机原型创建的主机的自定义接口来源。

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

属性行为：
- 对继承对象为 只读
uuid string 通用唯一标识符，用于将导入的主机原型链接到已存在的主机原型。如果未提供，则自动生成。

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

组链接

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

Property Type Description
groupid ID 主机组的 ID。

属性行为:
- 必需

组原型

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

属性 类型 说明
group_prototypeid ID 组原型的 ID。

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

属性行为：
- 创建操作时为必填

主机原型标签

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

属性 Type 说明
tag string 主机原型标签名称。

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

属性行为：
- 只读。
object integer 标签继承自的对象类型。

可能的值：
0 - 模板。

属性行为：
- 只读。
objectid ID 标签继承自的对象的 ID。

属性行为：
- 只读。

自定义接口

如果 主机原型对象 的 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 object 用于自定义接口详细信息的附加对象。

属性行为：
- 如果 type 设置为“SNMP”，则为 必填

自定义接口详情

details 对象具有以下属性。

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

可能的值：
1 - SNMPv1；
2 - SNMPv2c；
3 - SNMPv3。

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

可能的值：
0 - 不使用批量请求；
1 - (默认) - 使用批量请求。
community string SNMP community。

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

默认值：10。
securityname string SNMPv3 安全名称。

属性行为：
- 当 version 设置为 "SNMPv3" 时 支持
securitylevel integer SNMPv3 安全级别。

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

属性行为：
- 当 version 设置为 "SNMPv3" 时 支持
authpassphrase string SNMPv3 身份验证口令。

属性行为：
- 当 version 设置为 "SNMPv3" 且 securitylevel 设置为 "authNoPriv" 或 "authPriv" 时 支持
privpassphrase string 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 string SNMPv3 上下文名称。

属性行为：
- 当 version 设置为 "SNMPv3" 时 支持