> 主机原型 object
以下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 | 通用唯一标识符，用于将导入的主机原型与已存在的原型进行关联。仅适用于模板上的主机原型。若未提供则自动生成。 |
请注意，某些方法（update、delete）所需/可选参数的组合有所不同。
组链接
组链接object将一个主机原型与一个主机组关联，并具有以下属性。
| 属性 | 数据类型 | 描述 |
|---|---|---|
| groupid (required) |
string | 主机组的ID。 |
组原型
组原型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 | object | 接口的额外object。必填 如果接口'类型'类型为SNMP。 |
自定义接口详情
该 object 详情具有以下属性。
| 属性 | 数据类型 | 描述 |
|---|---|---|
| version (required) |
integer | SNMP 接口 version. 可能值为: 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接口. |