> 主机接口对象

以下对象与hostinterfaceAPI直接相关.

主机接口

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

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

属性 类描述
interfaceid字符串 (读) 接口ID.
dns
(必选)
字符 接
使用的DNS名称.
如果通过IP连接,可以设置为空.
hostid
(必选)
字符 接归属的主机ID.
ip
(必选)
字符 接
使用的IP地址.
如果通过DNS域名连接,可以设置为空.
main
(必选)
整数 该
口是否在主机上用作默认接口. 主机上只能有一种类型的接口作为默认设置.
可能的值:
0 - 不是默认;
1 - 默认.
port
(必选)
字符 接使用的端口号,可以包含用户宏.
type
(必选)
整数 接
类型.
可能的值:
1 - agent;
2 - SNMP;
3 - IPMI;
4 - JMX.
useip
(必选)
整数 是
应通过IP进行连接.
可能的值:
0 - 使用主机DNS名称连接;
1 - 使用该主机接口的主机IP地址进行连接.
bulk整数 是使用批量SNMP请求.

可能的值:
0 - 不要使用批量请求;
1 - (默认) 使用批量请求.

Details tag

The details object has the following properties.

PropertyTypeDescription
version
(required)
integerSNMP interface version.

Possible values are:
1 - SNMPv1;
2 - SNMPv2c;
3 - SNMPv3
bulkintegerWhether to use bulk SNMP requests.

Possible values are:
0 - don’t use bulk requests;
1 - (default) - use bulk requests.
communitystringSNMP community (required). Used only by SNMPv1 and SNMPv2 interfaces.
securitynamestringSNMPv3 security name. Used only by SNMPv3 interfaces.
securitylevelintegerSNMPv3 security level. Used only by SNMPv3 interfaces.

Possible values are:
0 - (default) - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.
authpassphrasestringSNMPv3 authentication passphrase. Used only by SNMPv3 interfaces.
privpassphrasestringSNMPv3 privacy passphrase. Used only by SNMPv3 interfaces.
authprotocolintegerSNMPv3 authentication protocol. Used only by SNMPv3 interfaces.

Possible values are:
0 - (default) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512.
privprotocolintegerSNMPv3 privacy protocol. Used only by SNMPv3 interfaces.

Possible values are:
0 - (default) - DES;
1 - AES128;
2 - AES192;
3 - AES256;
4 - AES192C;
5 - AES256C.
contextnamestringSNMPv3 context name. Used only by SNMPv3 interfaces.