> Objeto de interface do host

Os objetos a seguir estão diretamente relacionados à API hostinterface.

Interface do host

O objeto de interface do host tem as seguintes propriedades.

::: não importante Observe que IP e DNS são necessários. Se você fizer não quiser usar o DNS, defina-o como uma string vazia. :::

Propriedade Tipo Descrição
disponível inteiro (somente leitura) Disponibilidade da interface do host.

Os valores possíveis são:
0 - (padrão) desconhecido;
1 - disponível;
2 - indisponível .
details array Objeto adicional para interface. Obrigatório se o 'tipo' da interface for SNMP.
disable_until timestamp (readonly) O próximo horário de polling de uma interface de host indisponível.
dns
(obrigatório)		 string nome DNS usado pela interface.

Pode estar vazio se a conexão for feita via IP.
error string (readonly) Texto de erro se a interface do host não estiver disponível.
errors_from timestamp (readonly) Hora em que a interface do host ficou indisponível.
hostid
(obrigatório)		 string ID do host ao qual a interface pertence.
interfaceid string (readonly) ID da interface.
ip
(obrigatório)		 string endereço IP usado pela interface.

Pode estar vazio se a conexão for feita via DNS.
main
(obrigatório)		 integer Se a interface é usada como padrão no host. Apenas uma interface de algum tipo pode ser definida como padrão em um host.

Os valores possíveis são:
0 - não padrão;
1 - padrão.
port
(obrigatório)		 string Número da porta usada pela interface. Pode conter macros de usuário.
tipo
(obrigatório)		 inteiro Tipo de interface.

Os valores possíveis são:
1 - agente;
2 - SNMP;
3 - IPMI;< br>4 - JMX.
useip
(obrigatório)		 inteiro Se a conexão deve ser feita via IP.

Os valores possíveis são:
0 - conectar usando o nome DNS do host;
1 - conecte-se usando o endereço IP do host para esta interface do host.

Detalhes de Tag

O objeto de detalhes tem as seguintes propriedades.

Propriedade Tipo Descrição
versão
(obrigatório)		 inteiro versão da interface SNMP.

Os valores possíveis são:
1 - SNMPv1;
2 - SNMPv2c;
3 - SNMPv3
bulk inteiro Se usar solicitações SNMP em massa.

Os valores possíveis são:
0 - não usar solicitações em massa;
1 - (padrão) - usar solicitações em massa.
community string Comunidade SNMP (obrigatório). Usado apenas por interfaces SNMPv1 e SNMPv2.
securityname string nome de segurança SNMPv3. Usado apenas por interfaces SNMPv3.
nível de segurança inteiro nível de segurança SNMPv3. Usado apenas por interfaces SNMPv3.

Os valores possíveis são:
0 - (padrão) - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.
authpassphrase string Senha de autenticação SNMPv3. Usado apenas por interfaces SNMPv3.
privpassphrase string Senha de privacidade SNMPv3. Usado apenas por interfaces SNMPv3.
authprotocol inteiro protocolo de autenticação SNMPv3. Usado apenas por interfaces SNMPv3.

Os valores possíveis são:
0 - (padrão) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;<br >4 - SHA384;
5 - SHA512.
privprotocol integer SNMPv3 protocolo de privacidade. Usado apenas por interfaces SNMPv3.

Os valores possíveis são:
0 - (padrão) - DES;
1 - AES128;
2 - AES192;
3 - AES256;<br >4 - AES192C;
5 - AES256C.
contextname string SNMPv3 nome do contexto. Usado apenas por interfaces SNMPv3.