Documentation
更新
描述
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 }响应:
更新模版仪表盘页面
重命名第一个仪表盘页面，替换第二个仪表盘页面上的组件，并添加一个新页面作为第三个页面。 删除所有其他仪表盘页面。
请求:
{ "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 }响应:
参阅
来源
CTemplateDashboard::update() 在 ui/include/classes/api/services/CTemplateDashboard.php.