Documentation
主机 原型 object
以下 objects 直接与 hostprototype API 相关。
主机原型
主机 原型 object 具有以下属性。
| 属性 | 数据类型 | 描述 |
|---|---|---|
| hostid | ID | 主机原型的ID。 属性行为: - 只读 - 进行update操作时必填 |
| host | string | 主机原型的技术名称。 属性行为： - 对于create操作为必填项 - 对于继承的objects为只读 |
| name | string | 主机原型的可见名称。 默认值： host属性值。属性行为： - 对于继承的objects为只读 |
| status | integer | 主机 原型的状态。 可能的值： 0 - (默认) 已监控 主机； 1 - 未监控 主机。 |
| inventory_mode | integer | 主机 清单填充模式。 可能的值： - 1 - (默认) 禁用； 0 - 手动； 1 - 自动。 |
| templateid | ID | 父模板主机原型的ID。 属性行为: - 只读 |
| discover | integer | 主机 原型发现状态。 可能的值： 0 - (默认) 将发现新的 主机； 1 - 不会发现新的 主机，并且现有的 主机 将被标记为丢失。 |
| custom_interfaces | integer | 来自主机原型创建的主机的自定义接口源。 可能的值： 0 - (默认) 从父级主机继承接口； 1 - 使用主机原型的自定义接口。 属性行为： - 对于继承的objects为只读 |
| uuid | string | 通用唯一标识符，用于将导入的主机原型链接到已存在的原型。若未指定则自动生成。 属性行为: - 若主机原型属于模板则为支持 |
组链接
群组链接 object 将 一个主机 原型与 一个主机 群组进行链接。
它具有以下属性。
组原型
组原型 object 定义了将为发现的 主机 创建的组。 它具有以下属性。
主机原型标签
主机 原型标签 object 具有以下属性。
自定义接口
如果 主机 原型 object 的 custom_interfaces 设置为 "使用 主机 原型自定义接口"，则支持自定义接口。 自定义接口 object 具有以下属性。
| 属性 | 数据类型 | 描述 |
|---|---|---|
| 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 | 自定义接口详细信息 的附加 object。 属性行为： - 如果 type 设置为 "SNMP"，则为 必填 |
自定义接口详情
详细信息 object 具有以下属性。
| 属性 | 数据类型 | 描述 |
|---|---|---|
| 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"，则 支持 |