主机接口对象

以下对象与 hostinterface API 直接相关。

主机接口

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

注意 ip 和 dns 属性都是创建操作所必须的。 如果不想使用 DNS，请将其设置为空字符串。

属性类型说明
interfaceidID接口的 ID。

属性行为:
- 只读
- 更新操作所必须的
availableinteger主机接口的可用性。

可能的值：
0 - (默认) 未知;
1 - 可用;
2 - 不可用.

属性行为:
- 只读
hostidID接口所属主机的 ID。

属性行为:
- 常数
- 创建操作所必须的
typeinteger接口类型。

可能的值：
1 - Agent;
2 - SNMP;
3 - IPMI;
4 - JMX.

属性行为:
- 创建操作所必须的
ipstring接口使用的 IP 地址。

如果通过 DNS 连接，可以为空。

属性行为:
- 创建操作所必须的
dnsstring接口使用的 DNS 名称。

如果通过 IP 连接，可以为空。

属性行为:
- 创建操作所必须的
portstring接口使用的端口号。
可包含用户宏。

属性行为:
- 创建操作所必须的
useipinteger是否应通过 IP 进行连接.

可能的值：
0 - 使用主机 DNS 名称连接；
1 - 使用主机 IP 地址连接。

属性行为:
- 创建操作所必须的
maininteger接口是否被主机用作默认设置。一台主机上只能有一个某种类型的接口被设置为默认设置。

可能的值：
0 - 不默认；
1 - 默认。

属性行为:
- 创建操作所必须的
detailsarray接口的附加 详细信息 对象。

属性行为:
- 如果 type 被设置成 “SNMP” 则是必须的
disable_untiltimestamp不可用主机接口的下一次轮询时间。

属性行为:
- 只读
errorstring主机接口不可用时的错误文本。

属性行为:
- 只读
errors_fromtimestamp主机接口不可用的时间。

属性行为:
- 只读

详细信息

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

属性类型说明
versionintegerSNMP 接口版本。

可能的值：
1 - SNMPv1;
2 - SNMPv2c;
3 - SNMPv3.

属性行为:
- 必须
bulkinteger是否使用批量 SNMP 请求。

可能的值：
0 - 不要使用批量请求；
1 - (默认) - 使用批量请求。
communitystringSNMP 社区。仅用于 SNMPv1 和 SNMPv2 接口。

属性行为:
- 如果 version 被设置成 “SNMPv1” 或 “SNMPv2c” 则是必须的
max_repetitionsinteger本地 SNMP 批量请求 的最大重复值 (GetBulkRequest-PDUs).
仅用于 SNMPv2 和 v3 中的 discovery[] 和 walk[] 监控项。

默认： 10.
securitynamestringSNMPv3 安全名称。仅用于 SNMPv3 接口。
securitylevelintegerSNMPv3 安全级别。仅用于 SNMPv3 接口。

可能的值：
0 - (默认) - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.
authpassphrasestringSNMPv3 验证口令。仅用于 SNMPv3 接口。
privpassphrasestringSNMPv3 隐私口令。仅用于 SNMPv3 接口。
authprotocolintegerSNMPv3 验证协议。仅用于 SNMPv3 接口。

可能的值：
0 - (默认) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512.
privprotocolintegerSNMPv3 隐私协议。仅用于 SNMPv3 接口。

可能的值：
0 - (默认) - DES;
1 - AES128;
2 - AES192;
3 - AES256;
4 - AES192C;
5 - AES256C.
contextnamestringSNMPv3 上下文名称。仅用于 SNMPv3 接口。