主机 原型 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将一个主机原型与一个主机组关联。 它具有以下属性。

属性 数据类型 描述
groupid ID 主机组的ID。

属性行为:
- 必填

组原型

组原型object定义了将为发现的主机创建的组. 它具有以下属性.

属性 数据类型 描述
group_prototypeid ID 组原型的ID.

属性行为:
- 只读
name string 组原型的名称.

属性行为:
- 在create操作中为必填项

主机原型标签

主机 原型标签 object 具有以下属性。

属性 数据类型 描述
tag string 主机 原型标签名称。

属性行为:
- 必填
value string 主机 原型标签值。

自定义接口

如果主机原型objectcustom_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"时支持