Documentation
> 主机原型对象
以下对象与主机原型 API直接相关。
主机原型
主机原型对象有以下属性:
| 属性 | 对象 | 描述 |
|---|---|---|
| hostid | 字符串 | (只读)主机原型ID。 |
| host (必选) |
字符串 | 主机原型技术名称 |
| name | 字符串 | 主机原型可见名称。 默认: host 属性值。 |
| status | 整型 | 主机原型状态。 可能值有: 0 - (默认) 被监控的主机; 1 - 没被监控的主机。 |
| inventory_mode | 整型 | 主机资产填写模式。 可能值是: -1 - (默认) 关闭; 0 - 手动; 1 - 自动。 |
| templateid | 字符串 | (只读) 主机原型父模板ID。 |
| discover | 整型 | 主机原型发现状态。 可能的值: 0 - (默认) 新主机将被发现; 1 - 新主机不会被发现并且存在的主机将被标记为丢失。 |
| custom_interfaces | 整型 | 通过主机原型创建的主机接口 可能的值: 0 - (默认) 从父主机继承接口; 1 -使用主机原型定制接口。 |
| uuid | 字符串 | 通用的唯一标识符，用于向现有主机导入主机原型，仅用于模板上的主机原型，如果没有指定将自动生成。 对于更新操作，此字段是只读。 |
注意，对于某些方法（更新、删除），必需/可选参数组合是不同的。
组链接
组链接对象将主机原型与主机组链接，并具有以下属性:
| 属性 | 类型 | 描述 |
|---|---|---|
| group_prototypeid | 字符串 | (只读) 组链接ID. |
| groupid (必选) |
字符串 | 主机组ID。 |
| hostid | 字符串 | (只读) 主机原型ID。 |
| templateid | 字符串 | (只读) 父模板组链接ID。 |
组原型
组原型对象定义将为已发现的主机创建的组，并具有以下属性:
| 属性 | 类型 | 描述 |
|---|---|---|
| group_prototypeid | 字符串 | (只读) 组原型的ID。 |
| name (必选) |
字符串 | 组原型的名称。 |
| hostid | 字符串 | (只读)主机原型的ID。 |
| templateid | 字符串 | (只读) 父模板组原型的ID。 |
主机原型标签
主机原型标签对象有以下属性：
| 属性 | 类型 | 描述 |
|---|---|---|
| tag (必选) |
字符串 | 主机原型标签名称。 |
| value | 字符串 | 主机原型标签值。 |
自定义接口
自定义接口对象与以下属性：
| 属性 | 类型 | 描述 |
|---|---|---|
| dns | 字符串 | 接口使用的DNS名称。 如果直接通过DNS连接，则必选，可以包含宏 |
| ip | 字符串 | 接口使用的IP 如果直接通过IP连接，则必选，可以包含宏 |
| main (必选) |
整型 | 该接口是否在主机上用作默认接口，在主机上只能将某种类型的一个接口设置为默认值。 可能的值: 0 - 不是默认; 1 - 默认。 |
| port (必选) |
字符串 | 接口使用的端口号。可以包含用户宏和LLD宏。 |
| type (必选) |
整型 | 接口类型。 可能的值: 1 - agent; 2 - SNMP; 3 - IPMI; 4 - JMX。 |
| useip (必选) |
整型 | 是否通过IP进行连接。 可能的值有: 0 - 使用主机DNS名称进行连接; 1 - 使用此主机接口的IP地址进行连接 |
| details | 数组 | 接口的附加对象。如果接口'类型'是SNMP则 必须。 |
自定义接口详细信息
详细信息对象有以下属性：
| 属性 | 类型 | 描述 |
|---|---|---|
| version (必选) |
整型 | SNMP接口版本。 可能的值有: 1 - SNMPv1; 2 - SNMPv2c; 3 - SNMPv3 |
| bulk | 整型 | 是否使用批量的SNMP请求 可能的值有: 0 - 不使用批量请求; 1 - (默认) - 使用批量请求。 |
| community | 字符串 | SNMP 团体字。仅用于SNMPv1和SNMPv2接口。 |
| securityname | 字符串 | SNMPv3安全名称。仅用于SNMPv3的接口 |
| securitylevel | 整型 | SNMPv3安全级别。仅用于SNMPv3的接口 可能的值有: 0 - (默认) - noAuthNoPriv; 1 - authNoPriv; 2 - authPriv。 |
| authpassphrase | 字符串 | SNMPv3身份认证密码。仅用于SNMPv3的接口。 |
| privpassphrase | 字符串 | SNMPv3私有密码，仅用于SNMPv3的接口。 |
| authprotocol | 整型 | SNMPv3认证协议。仅用于SNMPv3的接口。 可能的值有: 0 - (默认) - MD5; 1 - SHA1; 2 - SHA224; 3 - SHA256; 4 - SHA384; 5 - SHA512。 |
| privprotocol | 整型 | SNMPv3隐私协议。仅用于SNMPv3的接口。 可能的值有: 0 - (默认) - DES; 1 - AES128; 2 - AES192; 3 - AES256; 4 - AES192C; 5 - AES256C。 |
| contextname | 字符串 | SNMPv3上下文名称。仅用于SNMPv3的接口。 |