以下对象与 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 | 字符串 | SNMP社区。 属性行为: - 必需 如果 version 设置为"SNMPv1"或"SNMPv2c" |
max_repetitions | integer | 用于原生SNMP批量请求的最大重复值(GetBulkRequest-PDUs)。 仅在SNMPv2和v3的 discovery[] 和walk[] 监控项中使用。默认:10。 |
securityname | 字符串 | SNMPv3安全名称。 属性行为: - 支持 如果 version 设置为"SNMPv3" |
securitylevel | integer | SNMPv3安全级别。 可能的值: 0 - (默认) - noAuthNoPriv; 1 - authNoPriv; 2 - authPriv。 属性行为: - 支持 如果 version 设置为"SNMPv3" |
authpassphrase | 字符串 | SNMPv3认证密码短语。 属性行为: - 支持 如果 version 设置为"SNMPv3"且securitylevel 设置为"authNoPriv"或"authPriv" |
privpassphrase | 字符串 | 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 | 字符串 | SNMPv3上下文名称。 属性行为: - 支持 如果 version 设置为"SNMPv3" |