主机接口 object

以下objects与hostinterfaceAPI直接相关.

主机接口 object 具有以下属性.

请注意 ip 和 dns 属性对于 create 操作都是必填项. 如果不使用DNS, 请将其设置为空 string.

属性	数据类型	描述
interfaceid	ID	接口ID. 属性行为: - 只读 - update 操作必填
available	integer	主机接口的可用性. 可能值: 0 - (默认) 未知; 1 - 可用; 2 - 不可用. 属性行为: - 只读
hostid	ID	接口所属的主机 ID. 属性行为: - 常量 - create 操作必填
type	integer	接口类型. 可能值: 1 - Agent; 2 - SNMP; 3 - IPMI; 4 - JMX. 属性行为: - create 操作必填
ip	string	接口使用的IP地址. 如果通过DNS连接可以为空. 属性行为: - create 操作必填
dns	string	接口使用的DNS名称. 如果通过IP连接可以为空. 属性行为: - create 操作必填
port	string	接口使用的端口号. 可包含用户宏. 属性行为: - create 操作必填
useip	integer	是否应通过IP连接. 可能值: 0 - 使用主机DNS名称连接; 1 - 使用主机IP地址连接. 属性行为: - create 操作必填
main	integer	接口是否作为主机的默认接口. 每种类型只能有一个接口在一个主机上设置为默认. 可能值: 0 - 非默认; 1 - 默认. 属性行为: - create 操作必填
details	array	接口的额外详情 object. 属性行为: - 当 `type` 设置为"SNMP"时必填
disable_until	timestamp	不可用主机接口的下次轮询时间. 属性行为: - 只读
error	string	当主机接口不可用时的错误文本. 属性行为: - 只读
errors_from	timestamp	主机接口变为不可用的时间. 属性行为: - 只读

详情 object 具有以下属性。

属性	数据类型	描述
version	integer	SNMP接口version. 可能取值: 1 - SNMPv1; 2 - SNMPv2c; 3 - SNMPv3. 属性行为: - 必填
bulk	integer	是否使用批量SNMP请求. 可能取值: 0 - 不使用批量请求; 1 - (默认) - 使用批量请求.
community	string	SNMP community. 仅用于SNMPv1和SNMPv2接口. 属性行为: - 必填如果`version`设置为"SNMPv1"或"SNMPv2c"
max_repetitions	integer	原生SNMP批量请求(GetBulkRequest-PDUs)的最大重复值. 仅用于`discovery[]`和`walk[]`监控项在SNMPv2和v3中. 默认: 10.
securityname	string	SNMPv3安全名称. 仅用于SNMPv3接口.
securitylevel	integer	SNMPv3安全级别. 仅用于SNMPv3接口. 可能取值: 0 - (默认) - noAuthNoPriv; 1 - authNoPriv; 2 - authPriv.
authpassphrase	string	SNMPv3认证密码. 仅用于SNMPv3接口.
privpassphrase	string	SNMPv3隐私密码. 仅用于SNMPv3接口.
authprotocol	integer	SNMPv3认证协议. 仅用于SNMPv3接口. 可能取值: 0 - (默认) - MD5; 1 - SHA1; 2 - SHA224; 3 - SHA256; 4 - SHA384; 5 - SHA512.
privprotocol	integer	SNMPv3隐私协议. 仅用于SNMPv3接口. 可能取值: 0 - (默认) - DES; 1 - AES128; 2 - AES192; 3 - AES256; 4 - AES192C; 5 - AES256C.
contextname	string	SNMPv3上下文名称. 仅用于SNMPv3接口.

Documentation