主机对象

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

主机

主机对象具有以下属性。

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

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

属性行为:
- 创建操作时必需
description 文本 主机的描述。
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 - 维护生效。

[属性行为](/manual/api/reference_comment

主机资产清单

主机资产清单包含以下属性。

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

ID 属性 类型 描述 最大长度
4 alias string Alias. 128个字符
11 asset_tag string Asset tag. 64个字符
28 chassis string Chassis. 64个字符
23 contact string Contact person. 依赖于使用的数据库:
- SQL数据库使用65535个字符
- Oracle数据库使用2048个字符
32 contract_number string Contract number. 64个字符
47 date_hw_decomm string HW decommissioning date. 64个字符
46 date_hw_expiry string HW maintenance expiry date. 64个字符
45 date_hw_install string HW installation date. 64个字符
44 date_hw_purchase string HW purchase date. 64个字符
34 deployment_status string Deployment status. 64个字符
14 hardware string Hardware. 255个字符
15 hardware_full string Detailed hardware. 依赖于使用的数据库:
- SQL数据库使用65535个字符
- Oracle数据库使用2048个字符
39 host_netmask string Host subnet mask. 39个字符
38 host_networks string Host networks. 依赖于使用的数据库:
- SQL数据库使用65535个字符
- Oracle数据库使用2048个字符
40 host_router string Host router. 39个字符
30 hw_arch string HW architecture. 32个字符
33 installer_name string Installer name. 64个字符
24 location string Location. 依赖于使用的数据库:
- SQL数据库使用65535个字符
- Oracle数据库使用2048个字符
25 location_lat string Location latitude. 16个字符
26 location_lon string Location longitude. 16个字符
12 macaddress_a string MAC address A. 64个字符
13 macaddress_b string MAC address B. 64个字符
29 model string Model. 64 characters
3 name string Name. 128 characters
27 notes string Notes. 依赖于使用的数据库:
- SQL数据库使用65535个字符
- Oracle数据库使用2048个字符
41 oob_ip string OOB IP address. 39个字符
42 oob_netmask string OOB host subnet mask. 39个字符
43 oob_router string OOB router. 39个字符
5 os string OS name. 128个字符
6 os_full string Detailed OS name. 255个字符
7 os_short string Short OS name. 128个字符
61 poc_1_cell string Primary POC mobile number. 64个字符
58 poc_1_email string Primary email. 128个字符
57 poc_1_name string Primary POC name. 128个字符
63 poc_1_notes string Primary POC notes. 依赖于使用的数据库:
- SQL数据库使用65535个字符
- Oracle数据库使用2048个字符
59 poc_1_phone_a string Primary POC phone A. 64个字符
60 poc_1_phone_b string Primary POC phone B. 64个字符
62 poc_1_screen string Primary POC screen name. 64个字符
68 poc_2_cell string Secondary POC mobile number. 64个字符
65 poc_2_email string Secondary POC email. 128个字符
64 poc_2_name string Secondary POC name. 128个字符
70 poc_2_notes string Secondary POC notes. 依赖于使用的数据库:
- SQL数据库使用65535个字符
- Oracle数据库使用2048个字符
66 poc_2_phone_a string Secondary POC phone A. 64个字符
67 poc_2_phone_b string Secondary POC phone B. 64个字符
69 poc_2_screen string Secondary POC screen name. 64个字符
8 serialno_a string Serial number A. 64个字符
9 serialno_b string Serial number B. 64个字符
48 site_address_a string Site address A. 128个字符
49 site_address_b string Site address B. 128个字符
50 site_address_c string Site address C. 128个字符
51 site_city string Site city. 128个字符
53 site_country string Site country. 64个字符
56 site_notes string Site notes. 依赖于使用的数据库:
- SQL数据库使用65535个字符
- Oracle数据库使用2048个字符
55 site_rack string Site rack location. 128个字符
52 site_state string Site state. 64个字符
54 site_zip string Site ZIP/postal code. 64个字符
16 software string Software. 255个字符
18 software_app_a string Software application A. 64个字符
19 software_app_b string Software application B. 64个字符
20 software_app_c string Software application C. 64个字符
21 software_app_d string Software application D. 64个字符
22 software_app_e string Software application E. 64个字符
17 software_full string Software details. 依赖于使用的数据库:
- SQL数据库使用65535个字符
- Oracle数据库使用2048个字符
10 tag string Tag. 64个字符
1 type string Type. 64个字符
2 type_full string Type details. 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 Vendor. 64个字符

主机标签

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

属性 类型 描述
tag 字符串 主机标签名称。

属性行为:
- 必填
value 字符串 主机标签值。
automatic 整数 主机标签类型。

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

属性行为:
- 只读