> 主机对象

> 主机对象

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

主机

主机对象具有以下属性。

Property	Type	Description
hostid	string	(只读) 主机的ID。
host (必须)	string	主机的正式名称。
description	text	主机的描述信息。
flags	integer	(只读) 主机的来源。取值范围: 0—普通主机; 4—自动发现的主机。
inventory_mode	integer	主机清单模式。取值范围为: -1 - (默认) 禁用的; 0 - 手动的; 1 - 自动的。
ipmi_authtype	integer	IPMI 验证算法。可能的值: -1 - (默认) default; 0 - none; 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	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 - 已认证.
tls_issuer	string	证书发行者。
tls_subject	string	证书问题。
tls_psk_identity	string	(只写) PSK 认证。如果启用了 `tls_connect` 或 `tls_accept` ，则需要。不要将敏感信息放入PSK标识中，该信息通过网络不加密传输，以告知接收端使用哪个PSK。
tls_psk	string	(只写) 预共享密钥，至少32位十六进制数字。如果启用了 `tls_connect` 或 `tls_accept` ，则需要。

主机清单

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

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

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

Host 标记

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

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