主机 原型 object
以下objects与hostprototypeAPI直接相关。
主机原型
主机原型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 | array | 自定义接口详情的附加object。 属性行为: - 当 type设置为"SNMP"时必填 |
自定义接口详情
详情 object 具有以下属性.
| 属性 | 数据类型 | 描述 |
|---|---|---|
| version | integer | SNMP接口version. 可能值: 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 - (默认) - 无认证无加密; 1 - 认证无加密; 2 - 认证加密. 属性行为: - 当 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"时支持 |