Table of Contents
Objeto de interface de host
Os seguintes objetos estão diretamente relacionados à API hostinterface.
Interface do host
O objeto de interface do host possui as seguintes propriedades.
Observe que as propriedades ip e dns são obrigatórias para operações de criação. Se você não quiser usar DNS, defina como uma string vazia.
| Propriedade | Tipo | Descrição |
|---|---|---|
| interfaceid | ID | ID da interface. Comportamento da propriedade: - somente leitura - obrigatório para operações de atualização |
| available | integer | Disponibilidade da interface do host. Valores possíveis: 0 - (padrão) desconhecido; 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ório 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ório para operações de criação |
| ip | string | Endereço IP usado pela interface. Pode ser vazio se a conexão for feita via DNS. Comportamento da propriedade: - obrigatório para operações de criação |
| dns | string | Nome DNS usado pela interface. Pode ser vazio se a conexão for feita via IP. Comportamento da propriedade: - obrigatório para operações de criação |
| port | string | Número da porta usada pela interface. Pode conter macros de usuário. Comportamento da propriedade: - obrigatório para operações de criação |
| useip | integer | 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ório para operações de criação |
| main | integer | Se a interface é usada como padrão no host. Apenas uma interface de determinado 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ório para operações de criação |
| details | object | Objeto details adicional para a interface. Comportamento da propriedade: - obrigatório se type for definido como "SNMP" |
| disable_until | timestamp | O 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 details possui as seguintes propriedades.
| Propriedade | Tipo | Descrição |
|---|---|---|
| version | integer | Versão da interface SNMP. Valores possíveis: 1 - SNMPv1; 2 - SNMPv2c; 3 - SNMPv3. Comportamento da propriedade: - obrigatório |
| bulk | integer | Se deve usar requisições SNMP bulk. Valores possíveis: 0 - não usar requisições bulk; 1 - (padrão) - usar requisições bulk. |
| community | string | Comunidade SNMP. Usada apenas por interfaces SNMPv1 e SNMPv2. Comportamento da propriedade: - obrigatório se version estiver definido como "SNMPv1" ou "SNMPv2c" |
| max_repetitions | integer | Valor máximo de repetição para requisições SNMP bulk nativas (GetBulkRequest-PDUs). Usado apenas para items discovery[] e walk[] em SNMPv2 e v3.Padrão: 10. |
| securityname | string | Nome de segurança SNMPv3. Usado apenas por interfaces SNMPv3. |
| securitylevel | integer | Nível de segurança SNMPv3. Usado apenas por interfaces SNMPv3. Valores possíveis: 0 - (padrão) - noAuthNoPriv; 1 - authNoPriv; 2 - authPriv. |
| authpassphrase | string | Senha de autenticação SNMPv3. Usada apenas por interfaces SNMPv3. |
| privpassphrase | string | Senha de privacidade SNMPv3. Usada apenas por interfaces SNMPv3. |
| authprotocol | integer | Protocolo de autenticação SNMPv3. Usado apenas 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 apenas 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 apenas por interfaces SNMPv3. |