[comment]: # aside: 1

[comment]: # ({70b8d6b4-b7ea8d04})
# 主机对象

以下对象于主机API直接相关。

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

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

主机对象具有以下属性。

|属性|[类型](/manual/api/reference_commentary#data-types)|描述|
|--|--|------|
|hostid|ID|主机的 ID。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior)：<br>- *只读*<br>- *更新操作时*为 *必填*|
|host|string|主机的技术名称。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior)：<br>- *创建操作时*为 *必填*|
|description|text|主机的描述。|
|flags|integer|主机的[来源](/manual/api/reference_commentary#entity-origin-flags)。<br><br>可能的值：<br>0 - 普通主机；<br>4 - 由原型转换而来的主机。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior)：<br>- *只读*|
|inventory\_mode|integer|主机资产记录填充模式。<br><br>可能的值：<br>-1 - *(默认)* 禁用；<br>0 - 手动；<br>1 - 自动。|
|ipmi\_authtype|integer|IPMI 认证算法。<br><br>可能的值：<br>-1 - *(默认)* 默认；<br>0 - 无；<br>1 - MD2；<br>2 - MD5<br>4 - straight；<br>5 - OEM；<br>6 - RMCP+。|
|ipmi\_password|string|IPMI 密码。|
|ipmi\_privilege|integer|IPMI 权限级别。<br><br>可能的值：<br>1 - callback；<br>2 - *(默认)* user；<br>3 - operator；<br>4 - admin；<br>5 - OEM。|
|ipmi\_username|string|IPMI 用户名。|
|maintenance\_from|timestamp|当前生效维护的开始时间。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior)：<br>- *只读*|
|maintenance\_status|integer|当前生效的维护状态。<br><br>可能的值：<br>0 - *(默认)* 无维护；<br>1 - 维护生效中。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior)：<br>- *只读*|
|maintenance\_type|integer|当前生效的维护类型。<br><br>可能的值：<br>0 - *(默认)* 维护期间采集数据；<br>1 - 维护期间不采集数据。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior)：<br>- *只读*|
|maintenanceid|ID|当前在主机上生效的维护的 ID。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior)：<br>- *只读*|
|name|string|主机的可见名称。<br><br>默认值：`host` 属性值。|
|monitored_by|integer|用于监控主机的来源。<br><br>可能的值：<br>0 - *(默认)* Zabbix 服务器；<br>1 - Proxy；<br>2 - Proxy 组。|
|proxyid|ID|用于监控主机的 proxy 的 ID。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior)：<br>- 当 `monitored_by` 设置为 "Proxy" 时为 *必填*|
|proxy_groupid|ID|用于监控主机的 proxy 组的 ID。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior)：<br>- 当 `monitored_by` 设置为 "Proxy group" 时为 *必填*|
|status|integer|主机的状态和功能。<br><br>可能的值：<br>0 - *(默认)* 已启用；<br>1 - 已禁用。|
|tls\_connect|integer|到主机的连接。<br><br>可能的值：<br>1 - *(默认)* 不加密；<br>2 - PSK；<br>4 - 证书。|
|tls\_accept|integer|来自主机的连接。<br><br>可能的位图值：<br>1 - *(默认)* 不加密；<br>2 - PSK；<br>4 - 证书。<br><br>这是一个位掩码字段；可以接受任意可能位图值之和（例如，6 表示 PSK 和证书）。|
|tls\_issuer|string|证书颁发者。|
|tls\_subject|string|证书主题。|
|tls\_psk\_identity|string|PSK 标识；必须且只能与一个 PSK 配对（在 [autoregistration](/manual/api/reference/autoregistration/object)、[hosts](/manual/api/reference/host/object) 和 [proxies](/manual/api/reference/proxy/object) 范围内）。<br><br>请勿在 PSK 标识中包含敏感信息，因为它会通过未加密的网络发送，以告知接收方应使用哪个 PSK。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior)：<br>- *只写*<br>- 当 `tls_connect` 设置为 "PSK"，或 `tls_accept` 包含 "PSK" 位时为 *必填*|
|tls\_psk|string|预共享密钥（PSK）；必须至少包含 32 个十六进制数字。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior)：<br>- *只写*<br>- 当 `tls_connect` 设置为 "PSK"，或 `tls_accept` 包含 "PSK" 位时为 *必填*|
|active_available|integer|主机主动接口可用性状态。<br><br>可能的值：<br>0 - 接口状态未知；<br>1 - 接口可用；<br>2 - 接口不可用。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior)：<br>- *只读*|
|assigned_proxyid|ID|如果主机由 proxy 组监控，则为 Zabbix 服务器分配的 proxy 的 ID。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior)：<br>- *只读*|

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

[comment]: # ({c7de69b4-859da78d})
### 主机库存

主机库存对象具有以下属性。

::: notetip
每个属性都有其唯一的 ID 编号，用于将主机库存字段与监控项关联起来。
:::

|ID|属性|[类型](/manual/api/reference_commentary#data-types)|描述|最大长度|
|-|--|-|-----|-----|
|4|alias|string|别名。|128 characters|
|11|asset\_tag|string|资产标签。|64 characters|
|28|chassis|string|机箱。|64 characters|
|23|contact|string|联系人。|65535 characters for SQL databases|
|32|contract\_number|string|合同编号。|64 characters|
|47|date\_hw\_decomm|string|硬件退役日期。|64 characters|
|46|date\_hw\_expiry|string|硬件维护到期日期。|64 characters|
|45|date\_hw\_install|string|硬件安装日期。|64 characters|
|44|date\_hw\_purchase|string|硬件购买日期。|64 characters|
|34|deployment\_status|string|部署状态。|64 characters|
|14|hardware|string|硬件。|255 characters|
|15|hardware\_full|string|详细硬件信息。|65535 characters for SQL databases|
|39|host\_netmask|string|主机子网掩码。|39 characters|
|38|host\_networks|string|主机网络。|65535 characters for SQL databases|
|40|host\_router|string|主机路由器。|39 characters|
|30|hw\_arch|string|硬件架构。|32 characters|
|33|installer\_name|string|安装人员姓名。|64 characters|
|24|location|string|位置。|65535 characters for SQL databases|
|25|location\_lat|string|位置纬度。|16 characters|
|26|location\_lon|string|位置经度。|16 characters|
|12|macaddress\_a|string|MAC 地址 A。|64 characters|
|13|macaddress\_b|string|MAC 地址 B。|64 characters|
|29|model|string|型号。|64 characters|
|3|name|string|名称。|128 characters|
|27|notes|string|备注。|65535 characters for SQL databases|
|41|oob\_ip|string|带外 IP 地址。|39 characters|
|42|oob\_netmask|string|带外主机子网掩码。|39 characters|
|43|oob\_router|string|带外路由器。|39 characters|
|5|os|string|操作系统名称。|128 characters|
|6|os\_full|string|详细操作系统名称。|255 characters|
|7|os\_short|string|简短操作系统名称。|128 characters|
|61|poc\_1\_cell|string|主要联系人手机号码。|64 characters|
|58|poc\_1\_email|string|主要联系人邮箱。|128 characters|
|57|poc\_1\_name|string|主要联系人姓名。|128 characters|
|63|poc\_1\_notes|string|主要联系人备注。|65535 characters for SQL databases|
|59|poc\_1\_phone\_a|string|主要联系人电话 A。|64 characters|
|60|poc\_1\_phone\_b|string|主要联系人电话 B。|64 characters|
|62|poc\_1\_screen|string|主要联系人屏幕名称。|64 characters|
|68|poc\_2\_cell|string|次要联系人手机号码。|64 characters|
|65|poc\_2\_email|string|次要联系人邮箱。|128 characters|
|64|poc\_2\_name|string|次要联系人姓名。|128 characters|
|70|poc\_2\_notes|string|次要联系人备注。|65535 characters for SQL databases|
|66|poc\_2\_phone\_a|string|次要联系人电话 A。|64 characters|
|67|poc\_2\_phone\_b|string|次要联系人电话 B。|64 characters|
|69|poc\_2\_screen|string|次要联系人屏幕名称。|64 characters|
|8|serialno\_a|string|序列号 A。|64 characters|
|9|serialno\_b|string|序列号 B。|64 characters|
|48|site\_address\_a|string|站点地址 A。|128 characters|
|49|site\_address\_b|string|站点地址 B。|128 characters|
|50|site\_address\_c|string|站点地址 C。|128 characters|
|51|site\_city|string|站点城市。|128 characters|
|53|site\_country|string|站点国家。|64 characters|
|56|site\_notes|string|站点备注。|65535 characters for SQL databases|
|55|site\_rack|string|站点机架位置。|128 characters|
|52|site\_state|string|站点州/省。|64 characters|
|54|site\_zip|string|站点 ZIP/邮政编码。|64 characters|
|16|software|string|软件。|255 characters|
|18|software\_app\_a|string|软件应用 A。|64 characters|
|19|software\_app\_b|string|软件应用 B。|64 characters|
|20|software\_app\_c|string|软件应用 C。|64 characters|
|21|software\_app\_d|string|软件应用 D。|64 characters|
|22|software\_app\_e|string|软件应用 E。|64 characters|
|17|software\_full|string|软件详情。|65535 characters for SQL databases|
|10|tag|string|标签。|64 characters|
|1|type|string|类型。|64 characters|
|2|type\_full|string|类型详情。|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|供应商。|64 characters|

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

[comment]: # ({a70bcec5-0ae1807e})
### 主机标签

主机标签对象具有以下属性。

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|tag|string|主机标签名称。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|主机标签值。|
|automatic|integer|主机标签类型。<br><br>可能的值：<br>0 - *(default)* 手动（由用户创建的标签）；<br>1 - 自动（由低级别发现创建的标签）<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|

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