Documentation
> 主机对象
以下对象直接与主机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 | 主机标记的值。 |