[comment]: # aside: 1

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

Los siguientes objetos están directamente relacionados con la API de equipos.

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

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

El objeto host tiene las siguientes propiedades.

|Propiedad|[Tipo](/manual/api/reference_commentary#data-types)|Descripción|
|--|--|------|
|hostid|ID|ID del host.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *solo lectura*<br>- *requerido* para operaciones de actualización|
|host|string|Nombre técnico del host.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *requerido* para operaciones de creación|
|description|text|Descripción del host.|
|flags|integer|[Origen](/manual/api/reference_commentary#entity-origin-flags) del host.<br><br>Valores posibles:<br>0 - un host normal;<br>4 - un host convertido desde una plantilla prototipo.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *solo lectura*|
|inventory\_mode|integer|Modo de población del inventario del host.<br><br>Valores posibles:<br>-1 - *(por defecto)* deshabilitado;<br>0 - manual;<br>1 - automático.|
|ipmi\_authtype|integer|Algoritmo de autenticación IPMI.<br><br>Valores posibles:<br>-1 - *(por defecto)* por defecto;<br>0 - ninguno;<br>1 - MD2;<br>2 - MD5<br>4 - straight;<br>5 - OEM;<br>6 - RMCP+.|
|ipmi\_password|string|Contraseña IPMI.|
|ipmi\_privilege|integer|Nivel de privilegio IPMI.<br><br>Valores posibles:<br>1 - callback;<br>2 - *(por defecto)* usuario;<br>3 - operador;<br>4 - admin;<br>5 - OEM.|
|ipmi\_username|string|Nombre de usuario IPMI.|
|maintenance\_from|timestamp|Hora de inicio del mantenimiento efectivo.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *solo lectura*|
|maintenance\_status|integer|Estado de mantenimiento efectivo.<br><br>Valores posibles:<br>0 - *(por defecto)* sin mantenimiento;<br>1 - mantenimiento en vigor.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *solo lectura*|
|maintenance\_type|integer|Tipo de mantenimiento efectivo.<br><br>Valores posibles:<br>0 - *(por defecto)* mantenimiento con recolección de datos;<br>1 - mantenimiento sin recolección de datos.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *solo lectura*|
|maintenanceid|ID|ID del mantenimiento que está actualmente en vigor en el host.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *solo lectura*|
|name|string|Nombre visible del host.<br><br>Por defecto: valor de la propiedad `host`.|
|monitored_by|integer|Fuente que se utiliza para monitorizar el host.<br><br>Valores posibles:<br>0 - *(por defecto)* Zabbix server;<br>1 - Proxy;<br>2 - Grupo de proxies.|
|proxyid|ID|ID del proxy que se utiliza para monitorizar el host.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *requerido* si `monitored_by` está establecido en "Proxy"|
|proxy_groupid|ID|ID del grupo de proxies que se utiliza para monitorizar el host.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *requerido* si `monitored_by` está establecido en "Grupo de proxies"|
|status|integer|Estado y función del host.<br><br>Valores posibles:<br>0 - *(por defecto)* habilitado;<br>1 - deshabilitado.|
|tls\_connect|integer|Conexiones al host.<br><br>Valores posibles:<br>1 - *(por defecto)* Sin cifrado;<br>2 - PSK;<br>4 - certificado.|
|tls\_accept|integer|Conexiones desde el host.<br><br>Valores posibles de bitmask:<br>1 - *(por defecto)* Sin cifrado;<br>2 - PSK;<br>4 - certificado.<br><br>Este es un campo de máscara de bits; cualquier suma de los valores posibles es aceptable (por ejemplo, 6 para PSK y certificado).|
|tls\_issuer|string|Emisor del certificado.|
|tls\_subject|string|Sujeto del certificado.|
|tls\_psk\_identity|string|Identidad PSK; debe estar emparejada con una sola PSK (en [autoregistro](/manual/api/reference/autoregistration/object), [hosts](/manual/api/reference/host/object) y [proxies](/manual/api/reference/proxy/object)).<br><br>No incluya información sensible en la identidad PSK, ya que se envía sin cifrar a través de la red para informar al receptor qué PSK usar.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *solo escritura*<br>- *requerido* si `tls_connect` está establecido en "PSK", o `tls_accept` contiene el bit "PSK"|
|tls\_psk|string|Clave precompartida (PSK); debe tener al menos 32 dígitos hexadecimales.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *solo escritura*<br>- *requerido* si `tls_connect` está establecido en "PSK", o `tls_accept` contiene el bit "PSK"|
|active_available|integer|Estado de disponibilidad de la interfaz activa del host.<br><br>Valores posibles:<br>0 - el estado de la interfaz es desconocido;<br>1 - la interfaz está disponible;<br>2 - la interfaz no está disponible.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *solo lectura*|
|assigned_proxyid|ID|ID del proxy asignado por Zabbix server, si el host es monitorizado por un grupo de proxies.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *solo lectura*|

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

[comment]: # ({c7de69b4-859da78d})
### Inventario del host

El objeto de inventario del host tiene las siguientes propiedades.

::: notetip
Cada propiedad tiene su propio número de ID único, que se
usa para asociar los campos del inventario del host con los items.
:::

|ID|Property|[Type](/manual/api/reference_commentary#data-types)|Description|Maximum length|
|-|--|-|-----|-----|
|4|alias|string|Alias.|128 characters|
|11|asset\_tag|string|Etiqueta de activo.|64 characters|
|28|chassis|string|Chasis.|64 characters|
|23|contact|string|Persona de contacto.|65535 characters for SQL databases|
|32|contract\_number|string|Número de contrato.|64 characters|
|47|date\_hw\_decomm|string|Fecha de desmantelamiento del HW.|64 characters|
|46|date\_hw\_expiry|string|Fecha de vencimiento del mantenimiento del HW.|64 characters|
|45|date\_hw\_install|string|Fecha de instalación del HW.|64 characters|
|44|date\_hw\_purchase|string|Fecha de compra del HW.|64 characters|
|34|deployment\_status|string|Estado de implementación.|64 characters|
|14|hardware|string|Hardware.|255 characters|
|15|hardware\_full|string|Hardware detallado.|65535 characters for SQL databases|
|39|host\_netmask|string|Máscara de subred del host.|39 characters|
|38|host\_networks|string|Redes del host.|65535 characters for SQL databases|
|40|host\_router|string|Router del host.|39 characters|
|30|hw\_arch|string|Arquitectura del HW.|32 characters|
|33|installer\_name|string|Nombre del instalador.|64 characters|
|24|location|string|Ubicación.|65535 characters for SQL databases|
|25|location\_lat|string|Latitud de la ubicación.|16 characters|
|26|location\_lon|string|Longitud de la ubicación.|16 characters|
|12|macaddress\_a|string|Dirección MAC A.|64 characters|
|13|macaddress\_b|string|Dirección MAC B.|64 characters|
|29|model|string|Modelo.|64 characters|
|3|name|string|Nombre.|128 characters|
|27|notes|string|Notas.|65535 characters for SQL databases|
|41|oob\_ip|string|Dirección IP OOB.|39 characters|
|42|oob\_netmask|string|Máscara de subred del host OOB.|39 characters|
|43|oob\_router|string|Router OOB.|39 characters|
|5|os|string|Nombre del SO.|128 characters|
|6|os\_full|string|Nombre detallado del SO.|255 characters|
|7|os\_short|string|Nombre corto del SO.|128 characters|
|61|poc\_1\_cell|string|Número de móvil del POC principal.|64 characters|
|58|poc\_1\_email|string|Correo electrónico principal.|128 characters|
|57|poc\_1\_name|string|Nombre del POC principal.|128 characters|
|63|poc\_1\_notes|string|Notas del POC principal.|65535 characters for SQL databases|
|59|poc\_1\_phone\_a|string|Teléfono A del POC principal.|64 characters|
|60|poc\_1\_phone\_b|string|Teléfono B del POC principal.|64 characters|
|62|poc\_1\_screen|string|Nombre de pantalla del POC principal.|64 characters|
|68|poc\_2\_cell|string|Número de móvil del POC secundario.|64 characters|
|65|poc\_2\_email|string|Correo electrónico secundario.|128 characters|
|64|poc\_2\_name|string|Nombre del POC secundario.|128 characters|
|70|poc\_2\_notes|string|Notas del POC secundario.|65535 characters for SQL databases|
|66|poc\_2\_phone\_a|string|Teléfono A del POC secundario.|64 characters|
|67|poc\_2\_phone\_b|string|Teléfono B del POC secundario.|64 characters|
|69|poc\_2\_screen|string|Nombre de pantalla del POC secundario.|64 characters|
|8|serialno\_a|string|Número de serie A.|64 characters|
|9|serialno\_b|string|Número de serie B.|64 characters|
|48|site\_address\_a|string|Dirección del sitio A.|128 characters|
|49|site\_address\_b|string|Dirección del sitio B.|128 characters|
|50|site\_address\_c|string|Dirección del sitio C.|128 characters|
|51|site\_city|string|Ciudad del sitio.|128 characters|
|53|site\_country|string|País del sitio.|64 characters|
|56|site\_notes|string|Notas del sitio.|65535 characters for SQL databases|
|55|site\_rack|string|Ubicación del rack del sitio.|128 characters|
|52|site\_state|string|Estado/provincia del sitio.|64 characters|
|54|site\_zip|string|Código postal/ZIP del sitio.|64 characters|
|16|software|string|Software.|255 characters|
|18|software\_app\_a|string|Aplicación de software A.|64 characters|
|19|software\_app\_b|string|Aplicación de software B.|64 characters|
|20|software\_app\_c|string|Aplicación de software C.|64 characters|
|21|software\_app\_d|string|Aplicación de software D.|64 characters|
|22|software\_app\_e|string|Aplicación de software E.|64 characters|
|17|software\_full|string|Detalles del software.|65535 characters for SQL databases|
|10|tag|string|Etiqueta.|64 characters|
|1|type|string|Tipo.|64 characters|
|2|type\_full|string|Detalles del tipo.|64 characters|
|35|url\_a|string|URL A.|2048 characters|
|36|url\_b|string|URL B.|2048 characters|
|37|url\_c|string|URL C.|2048 characters|
|31|vendor|string|Proveedor.|64 characters|

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

[comment]: # ({a70bcec5-0ae1807e})
### Etiqueta de host

El objeto de etiqueta de host tiene las siguientes propiedades.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|tag|string|Nombre de la etiqueta de host.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Valor de la etiqueta de host.|
|automatic|integer|Tipo de etiqueta de host.<br><br>Valores posibles:<br>0 - *(default)* manual (etiqueta creada por el usuario);<br>1 - automática (etiqueta creada por la detección de bajo nivel)<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|

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