主机 原型 object

以下 objects 直接与 hostprototype API 相关。

主机原型

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

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

Property behavior:
- read-only
- required for update operations
host string 主机原型的技术名称。

Property behavior:
- required for create operations
- read-only for inherited objects
name string 主机原型的可见名称。

默认值：host 属性值。

Property behavior:
- read-only for inherited objects
status integer 主机原型的状态。

可能的值：
0 - (default) 受监控主机；
1 - 未受监控主机。
inventory_mode integer 主机清单填充模式。

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

Property behavior:
- read-only
discover integer 主机原型发现状态。

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

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

Property behavior:
- read-only for inherited objects
uuid string 通用唯一标识符，用于将导入的主机原型与已存在的主机原型关联。如果未提供，则自动生成。

Property behavior:
- supported if the host prototype belongs to a template

组链接

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

Property Type Description
groupid ID 主机组的 ID。

Property behavior:
- required

组原型

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

Property Type Description
group_prototypeid ID 组原型的 ID。

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

属性行为:
- 在创建操作中为 必填

主机原型标签

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

Property Type Description
tag string 主机原型标签名称。

属性行为:
- required
value string 主机原型标签值。

自定义接口

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

Property Type Description
type integer 接口类型。

可能的值：
1 - agent；
2 - SNMP；
3 - IPMI；
4 - JMX。

Property behavior：
- required
useip integer 是否应通过 IP 建立连接。

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

Property behavior：
- required
ip string 接口使用的 IP 地址。
可以包含宏。

Property behavior：
- 当 useip 设置为“使用主机 IP 地址连接”时为 required
dns string 接口使用的 DNS 名称。
可以包含宏。

Property behavior：
- 当 useip 设置为“使用主机 DNS 名称连接”时为 required
port string 接口使用的端口号。
可以包含用户宏和 LLD 宏。

Property behavior：
- required
main integer 该接口是否作为主机上的默认接口使用。
在一台主机上，同一类型的接口只能设置一个为默认接口。

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

Property behavior：
- required
details object 用于 自定义接口详细信息 的附加对象。

Property behavior：
- 当 type 设置为“SNMP”时为 required

自定义接口详情

details 对象具有以下属性。

Property Type Description
version integer SNMP 接口版本。

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

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

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

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

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

属性行为：
- 如果 version 设置为 "SNMPv3"，则为 supported
securitylevel integer SNMPv3 安全级别。

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

属性行为：
- 如果 version 设置为 "SNMPv3"，则为 supported
authpassphrase string SNMPv3 身份验证口令。

属性行为：
- 如果 version 设置为 "SNMPv3" 且 securitylevel 设置为 "authNoPriv" 或 "authPriv"，则为 supported
privpassphrase string SNMPv3 隐私口令。

属性行为：
- 如果 version 设置为 "SNMPv3" 且 securitylevel 设置为 "authPriv"，则为 supported
authprotocol integer SNMPv3 身份验证协议。

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

属性行为：
- 如果 version 设置为 "SNMPv3" 且 securitylevel 设置为 "authNoPriv" 或 "authPriv"，则为 supported
privprotocol integer SNMPv3 隐私协议。仅用于 SNMPv3 接口。

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

属性行为：
- 如果 version 设置为 "SNMPv3" 且 securitylevel 设置为 "authPriv"，则为 supported
contextname string SNMPv3 上下文名称。

属性行为：
- 如果 version 设置为 "SNMPv3"，则为 supported