13 主机 可用性

描述

这些参数以及相应仪表板 widget 字段 objects 的可能属性值，允许在 dashboard.create 和 dashboard.update 方法中配置 Host availability widget。

参数

以下参数受主机可用性小部件支持。

参数 仪表板小部件字段 名称 值
Refresh interval 0 rf_rate 0 - 无刷新；
10 - 10 秒；
30 - 30 秒；
60 - 1 分钟；
120 - 2 分钟；
600 - 10 分钟；
900 - （默认） 15 分钟。
Host groups 2 groupids.0 Host group ID。

注意：要配置多个 主机 组，需为每个 主机组 使用递增的属性名称 create 仪表板 widget 字段 object。

如果在 template dashboard 上配置 widget，则不支持此参数。
主机 组（小部件） 1 groupids._reference 无需使用 Host group ID：
ABCDE._hostgroupids - 设置一个 部件兼容性（将其 Reference 参数设置为 "ABCDE"）作为 主机 组的数据源。

如果在 template dashboard 上配置小get，则不支持此参数。
Interface type 0 interface_type.0 0 - 无；
1 - Zabbix agent（被动检查）；
2 - SNMP；
3 - IPMI；
4 - JMX；
5 - Zabbix agent（主动检查）。

默认值：1、2、3、4、5（全部启用）。

注意：要配置多个值，请create为每个值在仪表板widget字段object中使用递增的编号作为属性名。
Layout 0 layout 0 - (默认) 水平；
1 - 垂直。
Show hosts in maintenance 0 maintenance 0 - (默认) 已禁用；
1 - 已启用。
Show only totals 0 only_totals 0 - (默认) 已禁用；
1 - 已启用。

示例

以下示例仅用于描述如何配置仪表板 widget 字段 objects 以用于 主机 可用性 小组件。 有关配置仪表板的更多信息，请参见 dashboard.create。

配置 主机可用性 部件

配置一个主机可用性部件，该部件以垂直布局显示主机组中主机的可用性信息，其中配置了"4"和"Zabbix agent"以及"SNMP"接口。

执行请求:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "hostavail",
                        "name": "Host availability",
                        "x": 0,
                        "y": 0,
                        "width": 18,
                        "height": 3,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 2,
                                "name": "groupids.0",
                                "value": 4
                            },
                            {
                                "type": 0,
                                "name": "interface_type",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "interface_type",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "layout",
                                "value": 1
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

响应:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "dashboardids": [
            "3"
        ]
    },
    "id": 1
}


[comment]: # ({/5499ab7c-055ba5b7})

[comment]: # ({e9d30322-3cce45df})
### 另请参阅

-   [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field)
-   [`dashboard.create`](/manual/api/reference/dashboard/create)
-   [`dashboard.update`](/manual/api/reference/dashboard/update)

[comment]: # ({/e9d30322-3cce45df})