主机接口对象

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

主机接口

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

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

属性 Type 描述
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 object 接口的附加详细信息对象。

属性行为：
- 如果 type 设置为 “SNMP” 则必需
disable_until timestamp 不可用主机接口的下一次轮询时间。

属性行为：
- 只读
error string 如果主机接口不可用，则为错误文本。

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

属性行为：
- 只读

详细信息

details 对象具有以下属性。

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

可能的值：
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）的最大重复值。
仅用于 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 接口使用。