> 主机接口对象

以下对象与 主机接口 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接口中使用。
privpassphrasestringSNMPv3隐私密码。仅在SNMPv3接口中使用。
authprotocolintegerSNMPv3身份认证协议。仅在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.
contextnamestringSNMPv3上下文名称。仅在SNMPv3接口中使用。