Esta é uma tradução da página de documentação original em inglês. Ajude-nos a torná-la melhor.

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