Documentation

Table of Contents

主机
主机资产清单
主机标签

以下objects与主机API直接相关。

主机

主机 object 具有以下属性。

属性	数据类型	描述
hostid	string	(只读) 主机的 ID。
host (required)	string	主机的技术名称。
description	text	主机的描述。
flags	integer	(只读) 主机的来源。可能的值： 0 - 普通主机; 4 - 发现的主机。
inventory_mode	integer	主机资产清单填充模式。可能的值： -1 - (默认) 禁用; 0 - 手动; 1 - 自动。
ipmi_authtype	integer	IPMI 认证算法。可能的值： -1 - (默认) 默认; 0 - 无; 1 - MD2; 2 - MD5 4 - 直连; 5 - OEM; 6 - RMCP+。
ipmi_password	string	IPMI 密码。
ipmi_privilege	integer	IPMI 权限级别。可能的值： 1 - 回调; 2 - (默认) 用户; 3 - 操作员; 4 - 管理员; 5 - OEM。
ipmi_username	string	IPMI 用户名。
maintenance_from	timestamp	(只读) 有效维护的开始时间。
maintenance_status	integer	(只读) 有效维护状态。可能的值： 0 - (默认) 无维护; 1 - 维护中。
maintenance_type	integer	(只读) 有效维护类型。可能的值： 0 - (默认) 带数据收集的维护; 1 - 不带数据收集的维护。
maintenanceid	string	(只读) 当前在主机上生效的维护 ID。
name	string	主机的可见名称。默认值：`host` 属性值。
proxy_hostid	string	用于监控主机的 proxy 的 ID。
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）。如果 `tls_connect` 或 `tls_accept` 启用了 PSK，则必须提供。不要在 PSK 标识中包含敏感信息，因为它会以明文形式通过网络发送，以告知接收方使用哪个 PSK。
tls_psk	string	(只写) 预共享密钥 (PSK)；必须至少为 32 个十六进制数字。如果 `tls_connect` 或 `tls_accept` 启用了 PSK，则必须提供。

请注意，对于某些方法（更新、删除），必需/可选参数的组合是不同的。

主机资产清单

主机资产清单object具有以下属性。

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

ID	属性	数据类型	描述	最大长度
4	alias	string	alias。	128字符
11	asset_tag	string	资产标签。	64字符
28	chassis	string	机箱。	64字符
23	contact	string	联系人。	取决于使用的数据库： - SQL数据库支持65535字符 - Oracle数据库支持2048字符
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字符 - Oracle数据库支持2048字符
39	host_netmask	string	主机子网掩码。	39字符
38	host_networks	string	主机网络。	取决于使用的数据库： - SQL数据库支持65535字符 - Oracle数据库支持2048字符
40	host_router	string	主机路由器。	39字符
30	hw_arch	string	硬件架构。	32字符
33	installer_name	string	安装人员姓名。	64字符
24	location	string	位置。	取决于使用的数据库： - SQL数据库支持65535字符 - Oracle数据库支持2048字符
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字符 - Oracle数据库支持2048字符
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	主要联系人手机号。	64字符
58	poc_1_email	string	主要邮箱。	128字符
57	poc_1_name	string	主要联系人姓名。	128字符
63	poc_1_notes	string	主要联系人备注。	取决于使用的数据库： - SQL数据库支持65535字符 - Oracle数据库支持2048字符
59	poc_1_phone_a	string	主要联系人电话A。	64字符
60	poc_1_phone_b	string	主要联系人电话B。	64字符
62	poc_1_screen	string	主要联系人屏幕名称。	64字符
68	poc_2_cell	string	次要联系人手机号。	64字符
65	poc_2_email	string	次要联系人邮箱。	128字符
64	poc_2_name	string	次要联系人姓名。	128字符
70	poc_2_notes	string	次要联系人备注。	取决于使用的数据库： - SQL数据库支持65535字符 - Oracle数据库支持2048字符
66	poc_2_phone_a	string	次要联系人电话A。	64字符
67	poc_2_phone_b	string	次要联系人电话B。	64字符
69	poc_2_screen	string	次要联系人屏幕名称。	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字符 - Oracle数据库支持2048字符
55	site_rack	string	站点机架位置。	128字符
52	site_state	string	站点州/省。	64字符
54	site_zip	string	站点邮编。	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字符 - Oracle数据库支持2048字符
10	tag	string	标签。	64字符
1	type	string	类型。	64字符
2	type_full	string	类型详情。	64字符
35	url_a	string	URL A。	255字符
36	url_b	string	URL B。	255字符
37	url_c	string	URL C。	255字符
31	vendor	string	供应商。	64字符

主机标签

主机标签object具有以下属性。

属性	数据类型	描述
tag (required)	string	主机标签名称。
value	string	主机标签值。