[comment]: # aside: 1

[comment]: # ({70b8d6b4-b7ea8d04})
# Objeto host

Os seguintes objetos estão diretamente relacionados à API de host.

[comment]: # ({/70b8d6b4-b7ea8d04})

[comment]: # ({7d75bf76-2f6c5c76})
### Host

O objeto host possui as seguintes propriedades.

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|hostid|ID|ID do host.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*<br>- *obrigatório* para operações de atualização|
|host|string|Nome técnico do host.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* para operações de criação|
|description|text|Descrição do host.|
|flags|integer|[Origem](/manual/api/reference_commentary#entity-origin-flags) do host.<br><br>Valores possíveis:<br>0 - um host simples;<br>4 - um host convertido a partir de um protótipo.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*|
|inventory\_mode|integer|Modo de preenchimento do inventário do host.<br><br>Valores possíveis:<br>-1 - *(padrão)* desabilitado;<br>0 - manual;<br>1 - automático.|
|ipmi\_authtype|integer|Algoritmo de autenticação IPMI.<br><br>Valores possíveis:<br>-1 - *(padrão)* padrão;<br>0 - nenhum;<br>1 - MD2;<br>2 - MD5<br>4 - straight;<br>5 - OEM;<br>6 - RMCP+.|
|ipmi\_password|string|Senha IPMI.|
|ipmi\_privilege|integer|Nível de privilégio IPMI.<br><br>Valores possíveis:<br>1 - callback;<br>2 - *(padrão)* usuário;<br>3 - operador;<br>4 - admin;<br>5 - OEM.|
|ipmi\_username|string|Nome de usuário IPMI.|
|maintenance\_from|timestamp|Hora de início da manutenção efetiva.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*|
|maintenance\_status|integer|Status de manutenção efetiva.<br><br>Valores possíveis:<br>0 - *(padrão)* sem manutenção;<br>1 - manutenção em vigor.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*|
|maintenance\_type|integer|Tipo de manutenção efetiva.<br><br>Valores possíveis:<br>0 - *(padrão)* manutenção com coleta de dados;<br>1 - manutenção sem coleta de dados.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*|
|maintenanceid|ID|ID da manutenção que está atualmente em vigor no host.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*|
|name|string|Nome visível do host.<br><br>Padrão: valor da propriedade `host`.|
|monitored_by|integer|Origem usada para monitorar o host.<br><br>Valores possíveis:<br>0 - *(padrão)* Zabbix server;<br>1 - Proxy;<br>2 - Proxy group.|
|proxyid|ID|ID do proxy usado para monitorar o host.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* se `monitored_by` estiver definido como "Proxy"|
|proxy_groupid|ID|ID do grupo de proxy usado para monitorar o host.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* se `monitored_by` estiver definido como "Proxy group"|
|status|integer|Status e função do host.<br><br>Valores possíveis:<br>0 - *(padrão)* habilitado;<br>1 - desabilitado.|
|tls\_connect|integer|Conexões para o host.<br><br>Valores possíveis:<br>1 - *(padrão)* Sem criptografia;<br>2 - PSK;<br>4 - certificado.|
|tls\_accept|integer|Conexões do host.<br><br>Valores possíveis de bitmap:<br>1 - *(padrão)* Sem criptografia;<br>2 - PSK;<br>4 - certificado.<br><br>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 pareada com apenas um PSK (entre [autoregistration](/manual/api/reference/autoregistration/object), [hosts](/manual/api/reference/host/object) e [proxies](/manual/api/reference/proxy/object)).<br><br>Não inclua informações sensíveis na identidade PSK, pois ela é enviada sem criptografia pela rede para informar ao receptor qual PSK usar.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente gravação*<br>- *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.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente gravação*<br>- *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.<br><br>Valores possíveis:<br>0 - status da interface é desconhecido;<br>1 - interface está disponível;<br>2 - interface não está disponível.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*|
|assigned_proxyid|ID|ID do proxy atribuído pelo Zabbix server, se o host for monitorado por um grupo de proxy.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*|

[comment]: # ({/7d75bf76-2f6c5c76})

[comment]: # ({53fce8b7-859da78d})
### Inventário de host

O objeto de inventário de host possui as seguintes propriedades.

::: notetip
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](/manual/api/reference_commentary#data-types)|Descrição|Comprimento máximo|
|-|--|-|-----|-----|
|4|alias|string|Apelido.|128 caracteres|
|11|asset\_tag|string|Etiqueta de ativo.|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|Fornecedor.|64 caracteres|

[comment]: # ({/53fce8b7-859da78d})

[comment]: # ({c531ae6d-0ae1807e})
### Tag de host

O objeto de tag de host possui as seguintes propriedades.

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|tag|string|Nome da tag do host.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|
|value|string|Valor da tag do host.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*.|
|automatic|integer|Tipo de tag de host.<br><br>Valores possíveis:<br>0 - *(padrão)* manual (tag criada pelo usuário);<br>1 - automática (tag criada por descoberta de baixo nível)<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*|
|object|integer|Tipo de objeto do qual a tag foi herdada.<br><br>Valores possíveis:<br>0 - template. <br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*.|
|objectid|ID|ID do objeto do qual a tag foi herdada.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*.|

[comment]: # ({/c531ae6d-0ae1807e})