Table of Contents
> 主机 object
以下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，则为必需。 |
请注意，对于某些方法(update, delete)，必需/可选参数的组合是不同的。
主机资产清单
主机 资产清单 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 | 带外IP地址. | 39字符 |
| 42 | oob_netmask | string | 带外 主机 子网掩码. | 39字符 |
| 43 | oob_router | string | 带外路由器. | 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 | 主机 标签值。 |