Você está visualizando a documentação da versão de desenvolvimento, que pode estar incompleta.
Esta página foi traduzida automaticamente. Se você notar um erro, selecione-o e pressione Ctrl+Enter para reportá-lo aos editores.

Objeto de protótipo de host

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

Protótipo de host

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

Protótipo de grupo

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

Tag de protótipo de host

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.

Interface personalizada

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"

Detalhes da interface personalizada

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"