> 主机对象

> 主机对象

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

主机

主机对象具有以下属性。

Property	Type	Description
hostid	字符	(只读) 主机的ID。
host (必须)	字符	主机的正式名称。
description	文本	主机的描述信息。
flags	整数	(只读) 主机的来源。取值范围: 0—普通主机; 4—自动发现的主机。
inventory_mode	整数	主机资产模式。取值范围为: -1 - (默认) 禁用的; 0 - 手动的; 1 - 自动的。
ipmi_authtype	整数	IPMI 验证算法。可能的值: -1 - (默认) default; 0 - none; 1 - MD2; 2 - MD5 4 - straight; 5 - OEM; 6 - RMCP+.
ipmi_password	字符	IPMI 密码。
ipmi_privilege	整数	IPMI 权限等级。可能的值: 1 - callback; 2 - (默认) user; 3 - operator; 4 - admin; 5 - OEM.
ipmi_username	字符	IPMI 用户名。
maintenance_from	时间戳	(只读) 有效维护启动时间。
maintenance_status	整数	(只读) 有效的维护状态。取值包括: 0 - (默认)不维护; 1 -有效维护。
maintenance_type	整数	(只读) 有效的维护类型。可能的值是: 0 - (默认) 数据收集维护; 1 - 数据不收集维护。
maintenanceid	字符	(只读) 主机上当前生效的维护ID。
name	字符	可见的主机名。默认: `host` 属性值。
proxy_hostid	字符	用于监控主机的Proxy ID。
status	整数	主机的状态和功能。可能的值是: 0 - (默认) 开启监控的主机; 1 - 没有开启监控的主机。
tls_connect	整数	链接到主机。可能的值是: 1 - (默认) 没有加密; 2 - PSK; 4 - 已加密。
tls_accept	整数	连接主机。可能的位图值如下:: 1 - (默认) 未加密; 2 - PSK; 4 - 已认证.
tls_issuer	字符	证书问题。
tls_subject	字符	证书发行者。
tls_psk_identity	字符	(只写) PSK 认证。如果启用了 `tls_connect` 或 `tls_accept` ，则需要。不要将敏感信息放入PSK标识中，该信息通过网络明文传输，以告知接收端使用哪个PSK。
tls_psk	字符	(只写) 预共享密钥，至少32位十六进制数字。如果启用了 `tls_connect` 或 `tls_accept` ，则需要。

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

主机资产

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

每个属性都有自己的唯一ID号，该ID号用于将主机资产字段与监控项关联起来。

ID	属性	类型	描述	最大长度
4	alias	string	别名。	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	主要 POC 手机号码。	64 个字符
58	poc_1_email	string	主要电子邮件。	128 个字符
57	poc_1_name	string	主要 POC 名称。	128 个字符
63	poc_1_notes	string	主要 POC 注释。	取决于所使用的数据库： - SQL 数据库为 65535 个字符 - Oracle 数据库为 2048 个字符
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 个字符 - Oracle 数据库为 2048 个字符
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 个字符 - 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	Tag.	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 个字符

Host 标记

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

属性	类	描述
tag (required)	string	主机标记名称。
value	string	主机标记的值。