主机接口对象

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

主机接口

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

可能的值:
0 - 不默认;
1 - 默认。

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

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

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

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

属性行为:
- 只读

详细信息

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

属性 类型 描述
version integer SNMP接口版本。

可能的值:
1 - SNMPv1;
2 - SNMPv2c;
3 - SNMPv3。

属性行为:
- 必需
bulk integer 是否使用批量SNMP请求。

可能的值:
0 - 不使用批量请求;
1 - (默认) - 使用批量请求。
community string SNMP社区。仅由SNMPv1和SNMPv2接口使用。

属性行为:
- 必需 如果version设置为"SNMPv1"或"SNMPv2c"
max_repetitions integer 原生SNMP批量请求的最大重复值(GetBulkRequest-PDUs)。
仅在SNMPv2和v3的discovery[]walk[]监控项中使用。

默认: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接口使用。