Objeto de interface de host

Os seguintes objetos estão diretamente relacionados à API hostinterface.

Interface do host

O objeto de interface do host tem as seguintes propriedades.

Propriedade Tipo Descrição
interfaceid ID ID da interface.

Comportamento da propriedade:
- somente leitura
- obrigatória para operações de atualização
available integer Disponibilidade da interface do host.

Valores possíveis:
0 - (padrão) desconhecida;
1 - disponível;
2 - indisponível.

Comportamento da propriedade:
- somente leitura
hostid ID ID do host ao qual a interface pertence.

Comportamento da propriedade:
- constante
- obrigatória para operações de criação
type integer Tipo de interface.

Valores possíveis:
1 - Agent;
2 - SNMP;
3 - IPMI;
4 - JMX.

Comportamento da propriedade:
- obrigatória para operações de criação
ip string Endereço IP usado pela interface.

Pode estar vazio se a conexão for feita via DNS.

Comportamento da propriedade:
- obrigatória para operações de criação
dns string Nome DNS usado pela interface.

Pode estar vazio se a conexão for feita via IP.

Comportamento da propriedade:
- obrigatória para operações de criação
port string Número da porta usado pela interface.
Pode conter macros de usuário.

Comportamento da propriedade:
- obrigatória para operações de criação
useip integer Indica se a conexão deve ser feita via IP.

Valores possíveis:
0 - conectar usando o nome DNS do host;
1 - conectar usando o endereço IP do host.

Comportamento da propriedade:
- obrigatória para operações de criação
main integer Indica se a interface é usada como padrão no host. Somente uma interface de cada tipo pode ser definida como padrão em um host.

Valores possíveis:
0 - não é padrão;
1 - padrão.

Comportamento da propriedade:
- obrigatória para operações de criação
details object Objeto details adicional para a interface.

Comportamento da propriedade:
- obrigatório se type estiver definido como "SNMP"
disable_until timestamp Próximo horário de coleta de uma interface de host indisponível.

Comportamento da propriedade:
- somente leitura
error string Texto do erro se a interface do host estiver indisponível.

Comportamento da propriedade:
- somente leitura
errors_from timestamp Horário em que a interface do host ficou indisponível.

Comportamento da propriedade:
- somente leitura

Detalhes

O objeto de detalhes tem as seguintes propriedades.

Property Type Description
version integer Versão da interface SNMP.

Valores possíveis:
1 - SNMPv1;
2 - SNMPv2c;
3 - SNMPv3.

Comportamento da propriedade:
- obrigatória
bulk integer Define se devem ser usadas solicitações SNMP em massa.

Valores possíveis:
0 - não usar solicitações em massa;
1 - (padrão) - usar solicitações em massa.
community string Comunidade SNMP. Usada somente por interfaces SNMPv1 e SNMPv2.

Comportamento da propriedade:
- obrigatória se version estiver definida como "SNMPv1" ou "SNMPv2c"
max_repetitions string Valor máximo de repetições para solicitações SNMP nativas em massa (GetBulkRequest-PDUs).
Usado somente para o item walk[] em SNMPv2 e SNMPv3.
Macros de usuário são compatíveis.

Valores possíveis: 1–2147483647 (INT32_MAX).
Padrão: 10.
retries string Número máximo de novas tentativas quando uma solicitação expira.
Usado para os itens walk[] e get[]. Para walk[], as novas tentativas são compartilhadas em toda a operação de walk.
Macros de usuário são compatíveis.

Valores possíveis: 0–100 (0 - desabilita novas tentativas).
Padrão: 5.
securityname string Nome de segurança SNMPv3. Usado somente por interfaces SNMPv3.
securitylevel integer Nível de segurança SNMPv3. Usado somente por interfaces SNMPv3.

Valores possíveis:
0 - (padrão) - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.
authpassphrase string Frase secreta de autenticação SNMPv3. Usada somente por interfaces SNMPv3.
privpassphrase string Frase secreta de privacidade SNMPv3. Usada somente por interfaces SNMPv3.
authprotocol integer Protocolo de autenticação SNMPv3. Usado somente por interfaces SNMPv3.

Valores possíveis:
0 - (padrão) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512.
privprotocol integer Protocolo de privacidade SNMPv3. Usado somente por interfaces SNMPv3.

Valores possíveis:
0 - (padrão) - DES;
1 - AES128;
2 - AES192;
3 - AES256;
4 - AES192C;
5 - AES256C.
contextname string Nome do contexto SNMPv3. Usado somente por interfaces SNMPv3.