29 URL

描述

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

widget fields 属性在仪表板创建或 update 期间不会进行验证。
这允许用户修改 built-in widgets 和 create custom widgets,但也存在创建或更新控件不正确的风险。
为确保成功创建或 update URL 控件,请参考下表中列出的参数行为。

参数

URL 小组件支持以下参数。

参数 仪表板小部件字段 名称
Refresh interval 0 rf_rate 0 - (默认) 不刷新;
10 - 10 秒;
30 - 30 秒;
60 - 1 分钟;
120 - 2 分钟;
600 - 10 分钟;
900 - 15 分钟。
URL 1 url 有效的 URL string。

参数行为
- 必填
Override host 1 override_hostid._reference ABCDE._hostid - 将一个 部件兼容性(其 Reference 参数设置为 "ABCDE")设置为 主机 的数据源;
DASHBOARD._hostid - 将仪表板 覆盖主机 设置为 主机 的数据源。

如果在 template dashboard 上配置小get,则不支持此参数。

示例

以下示例仅用于描述仪表板中URL小部件的配置步骤,其中涉及配置仪表板 widget 字段 objects。 有关配置仪表板的更多信息,请参见 dashboard.create

配置URL部件

配置一个显示Zabbix手册首页的URL部件。

执行请求:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "url",
                        "name": "URL",
                        "x": 0,
                        "y": 0,
                        "width": 36,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 1,
                                "name": "url",
                                "value": "https://www.zabbix.com/documentation/7.0/en"
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

响应:

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

另请参阅