这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.

更新

描述

object templatedashboard.update(object/array templateDashboards)

这个方法可以更新已经存在的模版仪表盘。

此方法仅适用于 管理员超级管理员 用户类型。可以在用户角色设置中撤销调用该方法的权限。查看 用户角色获取更多信息。

参数

(object/array) 要更新的模板仪表盘属性。

必须为每个仪表盘指定dashboardid属性,其他所有属性都是可选的。只会更新指定的属性。

除了 标准模版仪表盘属性, 这个方法还接受下列参数。

参数 类型 描述
pages array 模版仪表盘页面 以替换现有的仪表盘页面。

仪表盘页面按 dashboard_pageid 属性更新。对于没有 dashboard_pageid 属性的对象,将创建新的仪表盘页面,并且如果没有被重用,现有的仪表盘页面将被删除。仪表盘页面将按指定的顺序排序。仅更新仪表盘页面的指定属性。pages 属性至少需要一个仪表盘页面对象。

返回值

(object) 返回一个对象,该对象包含dashboardids属性下更新的模板仪表盘的ID。

示例

重命名模版仪表盘

将一个模板仪表盘重命名为 "Performance graphs"。

请求:

{
           "jsonrpc": "2.0",
           "method": "templatedashboard.update",
           "params": {
               "dashboardid": "23",
               "name": "Performance graphs"
           },
           "id": 1
       }
Copy
✔ Copied

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "dashboardids": [
                   "23"
               ]
           },
           "id": 1
       }
Copy
✔ Copied

更新模版仪表盘页面

重命名第一个仪表盘页面,替换第二个仪表盘页面上的组件,并添加一个新页面作为第三个页面。 删除所有其他仪表盘页面。

请求:

{
           "jsonrpc": "2.0",
           "method": "templatedashboard.update",
           "params": {
               "dashboardid": "2",
               "pages": [
                   {
                       "dashboard_pageid": 1,
                       "name": "Renamed Page"
                   },
                   {
                       "dashboard_pageid": 2,
                       "widgets": [
                           {
                               "type": "clock",
                               "x": 0,
                               "y": 0,
                               "width": 12,
                               "height": 3
                           }
                       ]
                   },
                   {
                       "display_period": 60
                   }
               ]
           },
           "id": 1
       }
Copy
✔ Copied

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "dashboardids": [
                   "2"
               ]
           },
           "id": 1
       }
Copy
✔ Copied

参阅

来源

CTemplateDashboard::update() 在 ui/include/classes/api/services/CTemplateDashboard.php.

To toggle search highlight, press Ctrl+Alt+H
Have an improvement suggestion for this page? Select the text that could be improved and press Ctrl+Enter to send it to the editors.