主机对象

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

主机

主机对象具有以下属性。

属性 类型 描述
hostid ID 主机的 ID。

属性行为：
- 只读
- 更新操作时为 必填
host string 主机的技术名称。

属性行为：
- 创建操作时为 必填
description text 主机的描述。
flags integer 主机的来源。

可能的值：
0 - 普通主机；
4 - 由原型转换而来的主机。

属性行为：
- 只读
inventory_mode integer 主机资产记录填充模式。

可能的值：
-1 - (默认) 禁用；
0 - 手动；
1 - 自动。
ipmi_authtype integer IPMI 认证算法。

可能的值：
-1 - (默认) 默认；
0 - 无；
1 - MD2；
2 - MD5
4 - straight；
5 - OEM；
6 - RMCP+。
ipmi_password string IPMI 密码。
ipmi_privilege integer IPMI 权限级别。

可能的值：
1 - callback；
2 - (默认) user；
3 - operator；
4 - admin；
5 - OEM。
ipmi_username string IPMI 用户名。
maintenance_from timestamp 当前生效维护的开始时间。

属性行为：
- 只读
maintenance_status integer 当前生效的维护状态。

可能的值：
0 - (默认) 无维护；
1 - 维护生效中。

属性行为：
- 只读
maintenance_type integer 当前生效的维护类型。

可能的值：
0 - (默认) 维护期间采集数据；
1 - 维护期间不采集数据。

属性行为：
- 只读
maintenanceid ID 当前在主机上生效的维护的 ID。

属性行为：
- 只读
name string 主机的可见名称。

默认值：host 属性值。
monitored_by integer 用于监控主机的来源。

可能的值：
0 - (默认) Zabbix 服务器；
1 - Proxy；
2 - Proxy 组。
proxyid ID 用于监控主机的 proxy 的 ID。

属性行为：
- 当 monitored_by 设置为 "Proxy" 时为 必填
proxy_groupid ID 用于监控主机的 proxy 组的 ID。

属性行为：
- 当 monitored_by 设置为 "Proxy group" 时为 必填
status integer 主机的状态和功能。

可能的值：
0 - (默认) 已启用；
1 - 已禁用。
tls_connect integer 到主机的连接。

可能的值：
1 - (默认) 不加密；
2 - PSK；
4 - 证书。
tls_accept integer 来自主机的连接。

可能的位图值：
1 - (默认) 不加密；
2 - PSK；
4 - 证书。

这是一个位掩码字段；可以接受任意可能位图值之和（例如，6 表示 PSK 和证书）。
tls_issuer string 证书颁发者。
tls_subject string 证书主题。
tls_psk_identity string PSK 标识；必须且只能与一个 PSK 配对（在 autoregistration、hosts 和 proxies 范围内）。

请勿在 PSK 标识中包含敏感信息，因为它会通过未加密的网络发送，以告知接收方应使用哪个 PSK。

属性行为：
- 只写
- 当 tls_connect 设置为 "PSK"，或 tls_accept 包含 "PSK" 位时为 必填
tls_psk string 预共享密钥（PSK）；必须至少包含 32 个十六进制数字。

属性行为：
- 只写
- 当 tls_connect 设置为 "PSK"，或 tls_accept 包含 "PSK" 位时为 必填
active_available integer 主机主动接口可用性状态。

可能的值：
0 - 接口状态未知；
1 - 接口可用；
2 - 接口不可用。

属性行为：
- 只读
assigned_proxyid ID 如果主机由 proxy 组监控，则为 Zabbix 服务器分配的 proxy 的 ID。

属性行为：
- 只读

主机资产记录

主机资产记录对象具有以下属性。

每个属性都有其唯一的 ID 编号，该编号用于将主机资产记录字段与监控项关联。

ID 属性 Type 描述 最大长度
4 alias string 别名。 128 个字符
11 asset_tag string 资产标签。 64 个字符
28 chassis string 机箱。 64 个字符
23 contact string 联系人。 SQL 数据库中为 65535 个字符
32 contract_number string 合同编号。 64 个字符
47 date_hw_decomm string 硬件退役日期。 64 个字符
46 date_hw_expiry string 硬件维护到期日期。 64 个字符
45 date_hw_install string 硬件安装日期。 64 个字符
44 date_hw_purchase string 硬件采购日期。 64 个字符
34 deployment_status string 部署状态。 64 个字符
14 hardware string 硬件。 255 个字符
15 hardware_full string 详细硬件信息。 SQL 数据库中为 65535 个字符
39 host_netmask string 主机子网掩码。 39 个字符
38 host_networks string 主机网络。 SQL 数据库中为 65535 个字符
40 host_router string 主机路由器。 39 个字符
30 hw_arch string 硬件架构。 32 个字符
33 installer_name string 安装人员姓名。 64 个字符
24 location string 位置。 SQL 数据库中为 65535 个字符
25 location_lat string 位置纬度。 16 个字符
26 location_lon string 位置经度。 16 个字符
12 macaddress_a string MAC 地址 A。 64 个字符
13 macaddress_b string MAC 地址 B。 64 个字符
29 model string 型号。 64 个字符
3 name string 名称。 128 个字符
27 notes string 备注。 SQL 数据库中为 65535 个字符
41 oob_ip string OOB IP 地址。 39 个字符
42 oob_netmask string OOB 主机子网掩码。 39 个字符
43 oob_router string OOB 路由器。 39 个字符
5 os string 操作系统名称。 128 个字符
6 os_full string 详细操作系统名称。 255 个字符
7 os_short string 操作系统简称。 128 个字符
61 poc_1_cell string 主要 POC 手机号码。 64 个字符
58 poc_1_email string 主要电子邮件地址。 128 个字符
57 poc_1_name string 主要 POC 姓名。 128 个字符
63 poc_1_notes string 主要 POC 备注。 SQL 数据库中为 65535 个字符
59 poc_1_phone_a string 主要 POC 电话 A。 64 个字符
60 poc_1_phone_b string 主要 POC 电话 B。 64 个字符
62 poc_1_screen string 主要 POC 屏幕名称。 64 个字符
68 poc_2_cell string 次要 POC 手机号码。 64 个字符
65 poc_2_email string 次要 POC 电子邮件地址。 128 个字符
64 poc_2_name string 次要 POC 姓名。 128 个字符
70 poc_2_notes string 次要 POC 备注。 SQL 数据库中为 65535 个字符
66 poc_2_phone_a string 次要 POC 电话 A。 64 个字符
67 poc_2_phone_b string 次要 POC 电话 B。 64 个字符
69 poc_2_screen string 次要 POC 屏幕名称。 64 个字符
8 serialno_a string 序列号 A。 64 个字符
9 serialno_b string 序列号 B。 64 个字符
48 site_address_a string 站点地址 A。 128 个字符
49 site_address_b string 站点地址 B。 128 个字符
50 site_address_c string 站点地址 C。 128 个字符
51 site_city string 站点城市。 128 个字符
53 site_country string 站点国家。 64 个字符
56 site_notes string 站点备注。 SQL 数据库中为 65535 个字符
55 site_rack string 站点机架位置。 128 个字符
52 site_state string 站点州/省。 64 个字符
54 site_zip string 站点 ZIP/邮政编码。 64 个字符
16 software string 软件。 255 个字符
18 software_app_a string 软件应用程序 A。 64 个字符
19 software_app_b string 软件应用程序 B。 64 个字符
20 software_app_c string 软件应用程序 C。 64 个字符
21 software_app_d string 软件应用程序 D。 64 个字符
22 software_app_e string 软件应用程序 E。 64 个字符
17 software_full string 软件详细信息。 SQL 数据库中为 65535 个字符
10 tag string 标签。 64 个字符
1 type string 类型。 64 个字符
2 type_full string 类型详细信息。 64 个字符
35 url_a string URL A。 2048 个字符
36 url_b string URL B。 2048 个字符
37 url_c string URL C。 2048 个字符
31 vendor string 供应商。 64 个字符

主机标签

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

属性 Type 描述
tag string 主机标签名称。

属性行为：
- 必填
value string 主机标签值。

属性行为：
- 只读。
automatic integer 主机标签的类型。

可能的值：
0 - (默认) 手动（用户创建的标签）；
1 - 自动（由低级别发现创建的标签）

属性行为：
- 只读
object integer 标签继承自的对象类型。

可能的值：
0 - 模板。

属性行为：
- 只读。
objectid ID 标签继承自的对象的 ID。

属性行为：
- 只读。