> 主机对象
下列是与主机相关的对象。
主机
主机对象具有以下属性。
| 属性 [ | 型](/zh/manual/api/reference_commentary#data_types) 描述 | |
|---|---|---|
| hostid | 字符串 *( | 读)* 主机的ID。 |
| host (必选) |
字符串 主机 | 正式名称。 |
| available | 整数 * | 只读）*Zabbix agent的可用性。 可能的值为： 0 - （默认）未知 1 - 可用； 2 - 不可用。 |
| description | 文本 主 | 说明。 |
| disable_until | 时间戳 *( | 读)* Zabbix agent不可用状态的下一次轮询时间。 |
| error | 字符串 *( | 读)* Zabbix agent不可用时的错误信息。 |
| errors_from | 时间戳 *( | 读)* Zabbix agent不可用时的时间。 |
| flags | 整数 * | 只读)* 主机的来源。 可能的值： 0 - 普通主机； 4 - 自动发现的主机。 |
| inventory_mode | 整数 主 | 资产清单填充模式。 可能的值： -1 - 禁用； 0 - (默认) 手动； 1 - 自动。 |
| ipmi_authtype | 整数 I | MI 认证算法。 可能的值： -1 - (默认) 默认； 0 - 无； 1 - MD2； 2 - MD5 4 - straight； 5 - OEM； 6 - RMCP+。 |
| ipmi_available | 整数 * | 只读)* IPMI agent的可用性。 可能的值： 0 - (默认) 未知； 1 - 可用； 2 - 不可用。 |
| ipmi_disable_until | 时间戳 *( | 读)* IPMI agent不可用状态的下一次轮询时间。 |
| ipmi_error | 字符串 *( | 读)* IPMI agent不可用时的错误信息。 |
| ipmi_errors_from | 时间戳 *( | 读)* IPMI agent不可用时的时间。 |
| ipmi_password | 字符串 IP | I 密码。 |
| ipmi_privilege | 整数 I | MI 权限等级。 可能的值： 1 - 回调； 2 - (默认) 用户； 3 - 操作员； 4 - 管理员； 5 - OEM原厂。 |
| ipmi_username | 整数 I | MI 用户名。 |
| jmx_available | 整数 * | 只读)* JMX agent的可用性。 可能的值： 0 - (默认) 未知； 1 - 可用； 2 - 不可用。 |
| jmx_disable_until | 时间戳 *( | 读)* JMX agent不可用状态的下一次轮询时间。 |
| jmx_error | 字符串 *( | 读)* JMX agent不可用时的错误信息。 |
| jmx_errors_from | 时间戳 *( | 读)* JMX agent不可用时的时间。 |
| maintenance_from | 时间戳 *( | 读)* 有效维护的开始时间。 |
| maintenance_status | 整数 * | 只读)* 有效维护的状态。 可能的值：\ 0 - (默认) 没有维护； 1 - 有效维护。 |
| maintenance_type | 整数 * | 只读)* 有效维护类型。 可能的值： 0 - (默认) 维护期间搜集数据； 1 - 维护期间不搜集数据。 |
| maintenanceid | 字符串 *( | 读)* 目前对主机生效的维护模式ID。 |
| name | 字符串 主机 | 见名。 默认: host 属性值。 |
| proxy_hostid | 字符串 用于 | 控主机的Proxy服务器的hostid。 |
| snmp_available | 整数 * | 只读)* SNMP agent的可用性。 可能的值： 0 - (默认) 未知； 1 - 可用； 2 - 不可用。 |
| snmp_disable_until | 时间戳 *( | 读)* SNMP agent不可用状态的下一次轮询时间。 |
| snmp_error | 字符串 *( | 读)* SNMP agent不可用时的错误信息。 |
| snmp_errors_from | 时间戳 *( | 读)* SNMP agent不可用时的时间。 |
| status | 整数 主 | 的状态。 可能的值： 0 - (默认) 已监控的主机； 1 - 未监控的主机。 |
| tls_connect | 整数 到 | 机的连接。 可能的值： 1 - (默认) 没有加密； 2 - PSK； 4 - 证书。 |
| tls_accept | 整数 来 | 主机的连接。 可能的值： 1 - (默认) 没有加密； 2 - PSK； 4 - 证书。 |
| tls_issuer | 字符串 证书 | 行机构。 |
| tls_subject | 字符串 证书 | 主题。 |
| tls_psk_identity | 字符串 PS | 认证。 如果tls_connect 或 tls_accept启用了PSK，那么该选项是必选。不要将敏感信息放在PSK身份中，它会通过网络以未加密的方式传输，以通知接收者要使用哪个PSK。 |
| tls_psk | 字符串 PS | 至少需要32位16进制数字构成。如果tls_connect 或 tls_accept启用了PSK，那么该选项是必选。 |
主机资产清单
主机资产对象具有以下属性:
<note tip>每一个属性拥有自己唯一的ID编号，用于将主机资产清单字段和事项关联在一起. :::
| ID | 属性 [ | 型](/zh/manual/api/reference_commentary#data_types) 描述 | |
|---|---|---|---|
| 4 | alias | 字符串 别名 | |
| 11 | asset_tag | 字符串 资产 | 签。 |
| 28 | chassis | 字符串 机架 | |
| 23 | contact | 字符串 联系 | 。 |
| 32 | contract_number | 字符串 联系 | 码。 |
| 47 | date_hw_decomm | 字符串 硬件 | 汰时间。 |
| 46 | date_hw_expiry | 字符串 硬件 | 保过期时间。 |
| 45 | date_hw_install | 字符串 硬件 | 装时间。 |
| 44 | date_hw_purchase | 字符串 硬件 | 买时间。 |
| 34 | deployment_status | 字符串 部署 | 态。 |
| 14 | hardware | 字符串 硬件 | 备。 |
| 15 | hardware_full | 字符串 硬件 | 备详情。 |
| 39 | host_netmask | 字符串 主机 | 网掩码。 |
| 38 | host_networks | 字符串 主机 | 络。 |
| 40 | host_router | 字符串 主机 | 由。 |
| 30 | hw_arch | 字符串 硬件 | 构。 |
| 33 | installer_name | 字符串 安装 | 员姓名。 |
| 24 | location | 字符串 地点 | |
| 25 | location_lat | 字符串 纬度 | 置。 |
| 26 | location_lon | 字符串 经度 | 置。 |
| 12 | macaddress_a | 字符串 MA | 地址A。 |
| 13 | macaddress_b | 字符串 MA | 地址B。 |
| 29 | model | 字符串 型号 | |
| 3 | name | 字符串 名称 | |
| 27 | notes | 字符串 注释 | |
| 41 | oob_ip | 字符串 带外 | P地址。 |
| 42 | oob_netmask | 字符串 带外 | 机子网掩码。 |
| 43 | oob_router | 字符串 带外 | 由。 |
| 5 | os | 字符串 操作 | 统名称。 |
| 6 | os_full | 字符串 详细 | 作系统名称。 |
| 7 | os_short | 字符串 简短 | 作系统名称。 |
| 61 | poc_1_cell | 字符串 主P | C移动号码。 |
| 58 | poc_1_email | 字符串 主P | C邮箱。 |
| 57 | poc_1_name | 字符串 主P | C名称。 |
| 63 | poc_1_notes | 字符串 主P | C注释。 |
| 59 | poc_1_phone_a | 字符串 主P | C电话A。 |
| 60 | poc_1_phone_b | 字符串 主P | C电话B。 |
| 62 | poc_1_screen | 字符串 主P | C显示名。 |
| 68 | poc_2_cell | 字符串 次P | C移动号码。 |
| 65 | poc_2_email | 字符串 次P | C邮箱。 |
| 64 | poc_2_name | 字符串 次P | C名称。 |
| 70 | poc_2_notes | 字符串 次P | C注释。 |
| 66 | poc_2_phone_a | 字符串 次P | C电话A。 |
| 67 | poc_2_phone_b | 字符串 次P | C电话B。 |
| 69 | poc_2_screen | 字符串 次P | C显示名。 |
| 8 | serialno_a | 字符串 序列 | A。 |
| 9 | serialno_b | 字符串 序列 | B。 |
| 48 | site_address_a | 字符串 所在 | 址A。 |
| 49 | site_address_b | 字符串 所在 | 址B。 |
| 50 | site_address_c | 字符串 所在 | 址C。 |
| 51 | site_city | 字符串 所在 | 市。 |
| 53 | site_country | 字符串 所在 | 家。 |
| 56 | site_notes | 字符串 所在 | 注解。 |
| 55 | site_rack | 字符串 所在 | 机柜位置。 |
| 52 | site_state | 字符串 所在 | 说明。 |
| 54 | site_zip | 字符串 所在 | 邮政编码。 |
| 16 | software | 字符串 软件 | |
| 18 | software_app_a | 字符串 应用 | 件A。 |
| 19 | software_app_b | 字符串 应用 | 件B。 |
| 20 | software_app_c | 字符串 应用 | 件C。 |
| 21 | software_app_d | 字符串 应用 | 件D。 |
| 22 | software_app_e | 字符串 应用 | 件E。 |
| 17 | software_full | 字符串 软件 | 情。 |
| 10 | tag | 字符串 标签 | |
| 1 | type | 字符串 类型 | |
| 2 | type_full | 字符串 类型 | 情。 |
| 35 | url_a | 字符串 网址 | 。 |
| 36 | url_b | 字符串 网址 | 。 |
| 37 | url_c | 字符串 网址 | 。 |
| 31 | vendor | 字符串 供应 | 。 |
主机标签
主机标签对象具有以下属性。
| 属性 类 | 描述 | |
|---|---|---|
| tag (必选) |
字符串 主机 | 签名称。 |
| value | 字符串 主机 | 签值。 |