Sidebar

> 主机接口对象

以下对象与 主机接口 API 直接相关。

主机接口

主机接口对象具有以下属性。

请注意,IP和DNS都是必需的。如果您不想使用DNS,请将其设置为空字符串.

属性 类型 描述
available 整型 (只读) 主机接口的可用性。

可能的值有:
0 - (默认) 未知;
1 - 可用;
2 - 不可用。
details 数组 接口的附加对象。 如果接口 'type'是SNMP,则必选
disable_until 时间戳 (只读) 不可用主机接口的下一次轮询时间。
dns
(必选)
字符串 接口使用的DNS名称

如果通过IP直接连接,则可以为空。
error 字符串 (只读) 主机接口不可用的错误文本。
errors_from 时间戳 (只读) 主机接口不可用时间。
hostid
(必选)
字符串 接口所属的主机ID。
interfaceid 字符串 (只读) 接口的ID。
ip
(必选)
字符串 接口使用的IP地址。

如果使用DNS域名连接,可以设置为空。
main
(必选)
整型 该接口是否在主机上用作默认的接口,在主机上只能将某种类型的一个接口设置为默认值。

可能的值有:
0 - 不是默认;
1 - 默认。
port
(必选)
字符串 接口使用的端口号,可以包含用户宏。
type
(必选)
整型 接口类型。

可能的值有:
1 - agent;
2 - SNMP;
3 - IPMI;
4 - JMX。
useip
(必选)
整型 是否通过IP进行连接。

可能的值有:
0 - 使用主机DNS进行连接;
1 - 使用主机接口的主机IP进行连接。

详细信息标签

详细信息对象具有以下属性。

属性 类型 描述
version
(必选)
整型 SNMP接口版本。

可能的值有:
1 - SNMPv1;
2 - SNMPv2c;
3 - SNMPv3
bulk 整型 是否使用批量的SNMP请求.

可能的值有:
0 - 不使用批量请求;
1 - (默认) - 使用批量请求。
community 字符串 SNMP 团体字 (必选)。 仅在SNMPv1和SNMPv2接口中使用。
securityname 字符串 SNMPv3 安全名称。仅在SNMPv3接口中使用。
securitylevel 字符串 SNMPv3安全级别。 仅在SNMPv3接口中使用。

可能的值有:
0 - (默认) - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.
authpassphrase 字符串 SNMPv3身份验证密码。仅在SNMPv3接口中使用。
privpassphrase string SNMPv3隐私密码。仅在SNMPv3接口中使用。
authprotocol integer SNMPv3身份认证协议。仅在SNMPv3接口中使用。

可能的值有:
0 - (默认) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512.
privprotocol 整型 SNMPv3隐私协议。仅在SNMPv3接口中使用。

可能的值有:
0 - (默认) - DES;
1 - AES128;
2 - AES192;
3 - AES256;
4 - AES192C;
5 - AES256C.
contextname string SNMPv3上下文名称。仅在SNMPv3接口中使用。