Os seguintes objetos estão diretamente relacionados à API hostprototype.
O objeto protótipo de host possui as seguintes propriedades.
| Propriedade | Tipo | Descrição |
|---|---|---|
| hostid | ID | ID do protótipo de host. Comportamento da propriedade: - somente leitura - obrigatório para operações de atualização |
| host | string | Nome técnico do protótipo de host. Comportamento da propriedade: - obrigatório para operações de criação - somente leitura para objetos herdados |
| name | string | Nome visível do protótipo de host. Padrão: valor da propriedade host.Comportamento da propriedade: - somente leitura para objetos herdados |
| status | integer | Status do protótipo de host. Valores possíveis: 0 - (padrão) host monitorado; 1 - host não monitorado. |
| flags | integer | Origem do protótipo de host. Valores possíveis: 2 - um protótipo de host; 6 - um protótipo de host descoberto Comportamento da propriedade: - somente leitura |
| inventory_mode | integer | Modo de preenchimento do inventário do host. Valores possíveis: -1 - (padrão) desabilitado; 0 - manual; 1 - automático. |
| templateid | ID | ID do protótipo de host do template pai. Comportamento da propriedade: - somente leitura |
| discover | integer | Status de descoberta do protótipo de host. Valores possíveis: 0 - (padrão) novos hosts serão descobertos; 1 - novos hosts não serão descobertos e hosts existentes serão marcados como perdidos. |
| custom_interfaces | integer | Fonte das interfaces personalizadas para hosts criados pelo protótipo de host. Valores possíveis: 0 - (padrão) herdar interfaces do host pai; 1 - usar interfaces personalizadas dos protótipos de host. Comportamento da propriedade: - somente leitura para objetos herdados |
| uuid | string | Identificador único universal, usado para vincular protótipos de host importados aos já existentes. Gerado automaticamente, se não fornecido. Comportamento da propriedade: - suportado se o protótipo de host pertencer a um template |
O objeto de link de grupo vincula um protótipo de host a um grupo de hosts. Ele possui as seguintes propriedades.
| Propriedade | Tipo | Descrição |
|---|---|---|
| groupid | ID | ID do grupo de hosts. Comportamento da propriedade: - obrigatório |
O objeto de protótipo de grupo define um grupo que será criado para um host descoberto. Ele possui as seguintes propriedades.
| Propriedade | Tipo | Descrição |
|---|---|---|
| group_prototypeid | ID | ID do protótipo de grupo. Comportamento da propriedade: - somente leitura |
| name | string | Nome do protótipo de grupo. Comportamento da propriedade: - obrigatório para operações de criação |
O objeto de tag de protótipo de host possui as seguintes propriedades.
| Propriedade | Tipo | Descrição |
|---|---|---|
| tag | string | Nome da tag do protótipo de host. Comportamento da propriedade: - obrigatório |
| value | string | Valor da tag do protótipo de host. |
Interfaces personalizadas são suportadas se custom_interfaces do objeto protótipo de host estiver definido como "usar interfaces personalizadas dos protótipos de host". O objeto de interface personalizada possui as seguintes propriedades.
| Propriedade | Tipo | Descrição |
|---|---|---|
| type | integer | Tipo de interface. Valores possíveis: 1 - Agent; 2 - SNMP; 3 - IPMI; 4 - JMX. Comportamento da propriedade: - obrigatório |
| 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 |
| ip | string | Endereço IP usado pela interface. Pode conter macros. Comportamento da propriedade: - obrigatório se useip estiver definido como "conectar usando o endereço IP do host" |
| dns | string | Nome DNS usado pela interface. Pode conter macros. Comportamento da propriedade: - obrigatório se useip estiver definido como "conectar usando o nome DNS do host" |
| port | string | Número da porta usada pela interface. Pode conter macros de usuário e LLD. Comportamento da propriedade: - obrigatório |
| main | 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. Valores possíveis: 0 - não é padrão; 1 - padrão. Comportamento da propriedade: - obrigatório |
| details | object | Objeto adicional para detalhes da interface personalizada. Comportamento da propriedade: - obrigatório se type estiver definido como "SNMP" |
O objeto de detalhes 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 solicitações SNMP bulk. Valores possíveis: 0 - não usar solicitações bulk; 1 - (padrão) - usar solicitações bulk. |
| community | string | Comunidade SNMP. Comportamento da propriedade: - obrigatório se version estiver definido como "SNMPv1" ou "SNMPv2c" |
| max_repetitions | integer | Valor máximo de repetição para solicitações SNMP bulk nativas (GetBulkRequest-PDUs). Usado apenas para itens discovery[] e walk[] em SNMPv2 e v3.Padrão: 10. |
| securityname | string | Nome de segurança SNMPv3. Comportamento da propriedade: - suportado se version estiver definido como "SNMPv3" |
| securitylevel | integer | Nível de segurança SNMPv3. Valores possíveis: 0 - (padrão) - noAuthNoPriv; 1 - authNoPriv; 2 - authPriv. Comportamento da propriedade: - suportado se version estiver definido como "SNMPv3" |
| authpassphrase | string | Senha de autenticação SNMPv3. Comportamento da propriedade: - suportado se version estiver definido como "SNMPv3" e securitylevel estiver definido como "authNoPriv" ou "authPriv" |
| privpassphrase | string | Senha de privacidade SNMPv3. Comportamento da propriedade: - suportado se version estiver definido como "SNMPv3" e securitylevel estiver definido como "authPriv" |
| authprotocol | integer | Protocolo de autenticação SNMPv3. Valores possíveis: 0 - (padrão) - MD5; 1 - SHA1; 2 - SHA224; 3 - SHA256; 4 - SHA384; 5 - SHA512. Comportamento da propriedade: - suportado se version estiver definido como "SNMPv3" e securitylevel estiver definido como "authNoPriv" ou "authPriv" |
| 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. Comportamento da propriedade: - suportado se version estiver definido como "SNMPv3" e securitylevel estiver definido como "authPriv" |
| contextname | string | Nome do contexto SNMPv3. Comportamento da propriedade: - suportado se version estiver definido como "SNMPv3" |