Documentation
主机原型对象
以下对象与 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 | 通用唯一标识符，用于将导入的主机原型与已有的主机原型相链接。如果未给出，则自动生成。 属性行为: - 如果主机原型属于模板，则受支持 |
组链接
组链接对象将主机原型与主机组链接起来。 它具有以下属性。
组原型
组原型对象定义了将为被发现主机创建的组。 它具有以下属性。
主机原型标签
主机原型标签对象具有以下属性。
自定义接口
如果 主机原型对象 的 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 | string | SNMP 社区。 属性行为: - 如果 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"则是支持的 |