> Host interface object

The following objects are directly related to the hostinterface API.

Host interface

The host interface object has the following properties.

Note that both IP and DNS are required. If you do not want to use DNS, set it to an empty string.

PropertyTypeDescription
interfaceidstring(readonly) ID of the interface.
dns
(required)		stringDNS name used by the interface.

Can be empty if the connection is made via IP.
hostid
(required)		stringID of the host the interface belongs to.
ip
(required)		stringIP address used by the interface.

Can be empty if the connection is made via DNS.
main
(required)		integerWhether the interface is used as default on the host. Only one interface of some type can be set as default on a host.

Possible values are:
0 - not default;
1 - default.
port
(required)		stringPort number used by the interface. Can contain user macros.
type
(required)		integerInterface type.

Possible values are:
1 - agent;
2 - SNMP;
3 - IPMI;
4 - JMX.
useip
(required)		integerWhether the connection should be made via IP.

Possible values are:
0 - connect using host DNS name;
1 - connect using host IP address for this host interface.
detailsarrayAdditional object for interface. Required if interface ‘type’ is SNMP.

Details tag

The details object has the following properties.

PropertyTypeDescription
versionintegerSNMP interface version.

Posibile values are:
1 - SNMPv1;
2 - (default) - SNMPv2c;
3 - SNMPv3
bulkintegerWhether to use bulk SNMP requests.

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

Posibile 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.

Posibile values are:
0 - (default) - MD5;
1 - SHA.
privprotocolintegerSNMPv3 privacy protocol. Used only by SNMPv3 interfaces.

Posibile values are:
0 - (default) - DES;
1 - AES.
contextnamestringSNMPv3 context name. Used only by SNMPv3 interfaces.