Table of Contents
Objeto host
Os seguintes objetos estão diretamente relacionados à API de host.
Host
O objeto host possui as seguintes propriedades.
| Propriedade | Tipo | Descrição |
|---|---|---|
| hostid | ID | ID do host. Comportamento da propriedade: - somente leitura - obrigatório para operações de atualização |
| host | string | Nome técnico do host. Comportamento da propriedade: - obrigatório para operações de criação |
| description | text | Descrição do host. |
| flags | integer | Origem do host. Valores possíveis: 0 - um host comum; 4 - um host convertido a partir de um protótipo. 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. |
| ipmi_authtype | integer | Algoritmo de autenticação IPMI. Valores possíveis: -1 - (padrão) padrão; 0 - nenhum; 1 - MD2; 2 - MD5 4 - straight; 5 - OEM; 6 - RMCP+. |
| ipmi_password | string | Senha IPMI. |
| ipmi_privilege | integer | Nível de privilégio IPMI. Valores possíveis: 1 - callback; 2 - (padrão) usuário; 3 - operador; 4 - admin; 5 - OEM. |
| ipmi_username | string | Nome de usuário IPMI. |
| maintenance_from | timestamp | Hora de início da manutenção efetiva. Comportamento da propriedade: - somente leitura |
| maintenance_status | integer | Status de manutenção efetiva. Valores possíveis: 0 - (padrão) sem manutenção; 1 - manutenção em vigor. Comportamento da propriedade: - somente leitura |
| maintenance_type | integer | Tipo de manutenção efetiva. Valores possíveis: 0 - (padrão) manutenção com coleta de dados; 1 - manutenção sem coleta de dados. Comportamento da propriedade: - somente leitura |
| maintenanceid | ID | ID da manutenção que está atualmente em vigor no host. Comportamento da propriedade: - somente leitura |
| name | string | Nome visível do host. Padrão: valor da propriedade host. |
| monitored_by | integer | Origem utilizada para monitorar o host. Valores possíveis: 0 - (padrão) Zabbix server; 1 - Proxy; 2 - Grupo de proxy. |
| proxyid | ID | ID do proxy utilizado para monitorar o host. Comportamento da propriedade: - obrigatório se monitored_by estiver definido como "Proxy" |
| proxy_groupid | ID | ID do grupo de proxy utilizado para monitorar o host. Comportamento da propriedade: - obrigatório se monitored_by estiver definido como "Grupo de proxy" |
| status | integer | Status e função do host. Valores possíveis: 0 - (padrão) habilitado; 1 - desabilitado. |
| tls_connect | integer | Conexões para o host. Valores possíveis: 1 - (padrão) Sem criptografia; 2 - PSK; 4 - certificado. |
| tls_accept | integer | Conexões do host. Valores possíveis de bitmap: 1 - (padrão) Sem criptografia; 2 - PSK; 4 - certificado. Este é um campo de máscara de bits; qualquer soma dos valores possíveis de bitmap é aceitável (por exemplo, 6 para PSK e certificado). |
| tls_issuer | string | Emissor do certificado. |
| tls_subject | string | Assunto do certificado. |
| tls_psk_identity | string | Identidade PSK; deve ser emparelhada com apenas um PSK (entre autoregistro, hosts e proxies). Não inclua informações sensíveis na identidade PSK, pois ela é enviada sem criptografia pela rede para informar ao receptor qual PSK usar. Comportamento da propriedade: - somente gravação - obrigatório se tls_connect estiver definido como "PSK" ou tls_accept contiver o bit "PSK" |
| tls_psk | string | Chave pré-compartilhada (PSK); deve ter pelo menos 32 dígitos hexadecimais. Comportamento da propriedade: - somente gravação - obrigatório se tls_connect estiver definido como "PSK" ou tls_accept contiver o bit "PSK" |
| active_available | integer | Status de disponibilidade da interface ativa do host. Valores possíveis: 0 - status da interface é desconhecido; 1 - interface está disponível; 2 - interface não está disponível. Comportamento da propriedade: - somente leitura |
| assigned_proxyid | ID | ID do proxy atribuído pelo Zabbix server, se o host for monitorado por um grupo de proxy. Comportamento da propriedade: - somente leitura |
Inventário de host
O objeto de inventário de host possui as seguintes propriedades.
Cada propriedade possui seu próprio número de ID exclusivo, que é usado para associar campos de inventário de host a items.
| ID | Propriedade | Tipo | Descrição | Comprimento máximo |
|---|---|---|---|---|
| 4 | alias | string | Apelido. | 128 caracteres |
| 11 | asset_tag | string | Etiqueta de patrimônio. | 64 caracteres |
| 28 | chassis | string | Chassi. | 64 caracteres |
| 23 | contact | string | Pessoa de contato. | 65535 caracteres para bancos de dados SQL |
| 32 | contract_number | string | Número do contrato. | 64 caracteres |
| 47 | date_hw_decomm | string | Data de descomissionamento do hardware. | 64 caracteres |
| 46 | date_hw_expiry | string | Data de expiração da manutenção do hardware. | 64 caracteres |
| 45 | date_hw_install | string | Data de instalação do hardware. | 64 caracteres |
| 44 | date_hw_purchase | string | Data de compra do hardware. | 64 caracteres |
| 34 | deployment_status | string | Status de implantação. | 64 caracteres |
| 14 | hardware | string | Hardware. | 255 caracteres |
| 15 | hardware_full | string | Hardware detalhado. | 65535 caracteres para bancos de dados SQL |
| 39 | host_netmask | string | Máscara de sub-rede do host. | 39 caracteres |
| 38 | host_networks | string | Redes do host. | 65535 caracteres para bancos de dados SQL |
| 40 | host_router | string | Roteador do host. | 39 caracteres |
| 30 | hw_arch | string | Arquitetura do hardware. | 32 caracteres |
| 33 | installer_name | string | Nome do instalador. | 64 caracteres |
| 24 | location | string | Localização. | 65535 caracteres para bancos de dados SQL |
| 25 | location_lat | string | Latitude da localização. | 16 caracteres |
| 26 | location_lon | string | Longitude da localização. | 16 caracteres |
| 12 | macaddress_a | string | Endereço MAC A. | 64 caracteres |
| 13 | macaddress_b | string | Endereço MAC B. | 64 caracteres |
| 29 | model | string | Modelo. | 64 caracteres |
| 3 | name | string | Nome. | 128 caracteres |
| 27 | notes | string | Notas. | 65535 caracteres para bancos de dados SQL |
| 41 | oob_ip | string | Endereço IP OOB. | 39 caracteres |
| 42 | oob_netmask | string | Máscara de sub-rede do host OOB. | 39 caracteres |
| 43 | oob_router | string | Roteador OOB. | 39 caracteres |
| 5 | os | string | Nome do SO. | 128 caracteres |
| 6 | os_full | string | Nome detalhado do SO. | 255 caracteres |
| 7 | os_short | string | Nome curto do SO. | 128 caracteres |
| 61 | poc_1_cell | string | Número de celular do POC primário. | 64 caracteres |
| 58 | poc_1_email | string | E-mail primário. | 128 caracteres |
| 57 | poc_1_name | string | Nome do POC primário. | 128 caracteres |
| 63 | poc_1_notes | string | Notas do POC primário. | 65535 caracteres para bancos de dados SQL |
| 59 | poc_1_phone_a | string | Telefone A do POC primário. | 64 caracteres |
| 60 | poc_1_phone_b | string | Telefone B do POC primário. | 64 caracteres |
| 62 | poc_1_screen | string | Nome de tela do POC primário. | 64 caracteres |
| 68 | poc_2_cell | string | Número de celular do POC secundário. | 64 caracteres |
| 65 | poc_2_email | string | E-mail do POC secundário. | 128 caracteres |
| 64 | poc_2_name | string | Nome do POC secundário. | 128 caracteres |
| 70 | poc_2_notes | string | Notas do POC secundário. | 65535 caracteres para bancos de dados SQL |
| 66 | poc_2_phone_a | string | Telefone A do POC secundário. | 64 caracteres |
| 67 | poc_2_phone_b | string | Telefone B do POC secundário. | 64 caracteres |
| 69 | poc_2_screen | string | Nome de tela do POC secundário. | 64 caracteres |
| 8 | serialno_a | string | Número de série A. | 64 caracteres |
| 9 | serialno_b | string | Número de série B. | 64 caracteres |
| 48 | site_address_a | string | Endereço do site A. | 128 caracteres |
| 49 | site_address_b | string | Endereço do site B. | 128 caracteres |
| 50 | site_address_c | string | Endereço do site C. | 128 caracteres |
| 51 | site_city | string | Cidade do site. | 128 caracteres |
| 53 | site_country | string | País do site. | 64 caracteres |
| 56 | site_notes | string | Notas do site. | 65535 caracteres para bancos de dados SQL |
| 55 | site_rack | string | Localização do rack do site. | 128 caracteres |
| 52 | site_state | string | Estado do site. | 64 caracteres |
| 54 | site_zip | string | CEP/código postal do site. | 64 caracteres |
| 16 | software | string | Software. | 255 caracteres |
| 18 | software_app_a | string | Aplicativo de software A. | 64 caracteres |
| 19 | software_app_b | string | Aplicativo de software B. | 64 caracteres |
| 20 | software_app_c | string | Aplicativo de software C. | 64 caracteres |
| 21 | software_app_d | string | Aplicativo de software D. | 64 caracteres |
| 22 | software_app_e | string | Aplicativo de software E. | 64 caracteres |
| 17 | software_full | string | Detalhes do software. | 65535 caracteres para bancos de dados SQL |
| 10 | tag | string | Tag. | 64 caracteres |
| 1 | type | string | Tipo. | 64 caracteres |
| 2 | type_full | string | Detalhes do tipo. | 64 caracteres |
| 35 | url_a | string | URL A. | 2048 caracteres |
| 36 | url_b | string | URL B. | 2048 caracteres |
| 37 | url_c | string | URL C. | 2048 caracteres |
| 31 | vendor | string | Fabricante. | 64 caracteres |
Tag do host
O objeto de tag do host possui as seguintes propriedades.
| Propriedade | Tipo | Descrição |
|---|---|---|
| tag | string | Nome da tag do host. Comportamento da propriedade: - obrigatório |
| value | string | Valor da tag do host. |
| automatic | integer | Tipo de tag do host. Valores possíveis: 0 - (padrão) manual (tag criada pelo usuário); 1 - automática (tag criada por descoberta de baixo nível) Comportamento da propriedade: - somente leitura |