[comment]: # translation:outdated
[comment]: # ({7ed888d2-7ed888d2})
# > Objeto de interface do host
Os objetos a seguir estão diretamente relacionados à API `hostinterface`.
[comment]: # ({/7ed888d2-7ed888d2})
[comment]: # ({ce77a3b0-ce77a3b0})
### 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](/manual/api/reference_commentary#data_types)|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.|
[comment]: # ({/ce77a3b0-ce77a3b0})
[comment]: # ({3bb71fcc-3bb71fcc})
### Detalhes de Tag
O objeto de detalhes tem as seguintes propriedades.
|Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|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;
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;
4 - AES192C;
5 - AES256C.|
|contextname|string|SNMPv3 nome do contexto. Usado apenas por interfaces SNMPv3.|
[comment]: # ({/3bb71fcc-3bb71fcc})