创建
描述
object dashboard.create(object/array dashboards)
此方法允许创建新的仪表盘。
此方法对于任何用户可用。可以在用户角色设置中撤销调用该方法的权限。更多信息请查看 用户角色。
参数
(object/array) 要创建的仪表盘。
除了标准仪表盘属性，此方法还接受以下参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| pages （必需） |
array | 仪表盘上创建的仪表盘页面 。仪表盘页面的顺序将与指定的顺序相同。pages属性至少需要一个仪表盘页面对象。 |
| users | array | 仪表盘上创建的仪表盘用户 。 |
| userGroups | array | 仪表盘上创建的仪表盘用户组 。 |
返回值
(object) 返回一个对象，该对象包含 dashboardids 属性下创建的仪表盘的 ID。返回的 ID 的顺序与所传递的仪表盘的顺序相匹配。
示例
创建仪表盘
创建一个名为 “My dashboard” 的仪表盘，其中有一个带有标签的问题部件，并使用了两种类型的共享（用户组和用户）。
请求：
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "problems",
"x": 0,
"y": 0,
"width": 12,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 1,
"name": "tags.tag.0",
"value": "service"
},
{
"type": 0,
"name": "tags.operator.0",
"value": 1
},
{
"type": 1,
"name": "tags.value.0",
"value": "zabbix_server"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": "7",
"permission": 2
}
],
"users": [
{
"userid": "4",
"permission": 3
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}响应：
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"2"
]
},
"id": 1
}参阅
来源
ui/include/classes/api/services/CDashboard.php 中的 CDashboard::create()。